1. MARGIN
Rapira
  • Introduction
  • JWT
    • Инструкция по созданию JWT
    • Generate JWT
      POST
  • CRYPTO MERCHANT
    • Адреса
      • Get address by currency
      • Create address by currency
      • Get address details by id
      • Get address list by currency
      • Start use address
      • Stop use address
    • Пополнения
      • Get deposits
  • MARKET
    • Get spot fees
      GET
    • Pairs
      GET
    • Token
      GET
    • Get rates JSON
      GET
    • Get rates XML
      GET
    • Get market depth
      POST
  • BALANCE
    • Get frozen balances
      GET
    • Get balance operations coins and types
      GET
    • Get balance operations
      POST
    • Get frozen balances detailed
      GET
    • Get Balances
      GET
  • SERVER TIME
    • Get server time
  • ORDER
    • Order current
    • Order history
    • Order details
    • Add exchange order
    • Cancel order
  • CRYPTO PAYOUT
    • Withdraw
      • Withdraw create
      • Withdraw crypto history Record
      • Withdraw crypto history
  • FIAT PAYOUT
    • Fiat
      • Withdraw fiat history
      • Withdraw fiat history Record
    • FIAT TRANSACTION
      • Fiat Transactions
      • Fiat Withdraw For Record
  • AML
    • AML balance
    • Recheck
    • Check address
    • Check transaction
  • rCode
    • Create rCode
    • rCode withdraw history
    • rCode deposit history
    • rCode details
    • Use rCode
  • OTC
    • Введение в OTC
    • Get payment types
    • Get my ads
    • Create ad
    • Update ad
    • Publish ad
    • Unpublish ad
    • Get offers
    • Fetch ads
    • Get order detail
    • Create order
    • Accept order
    • Decline order
    • Cancel order
    • Chat-history
    • Chat history page query
    • Pay order
    • Release order
    • Cancel appeal
    • Get order history
    • Create appeal
    • Send message
  • CRYPTO-PROCESSING
    • Введение
    • Создание проекта
    • Настройка проекта
    • Работа с инвойсами
    • Projects Settings
      • Get Invoices (Paginated)
      • Set deposit return address
      • Get Available Token Settings
      • Get Project Token Settings
      • Update Project Token Settings
      • Batch Update Project Token Settings
      • Get Projects
      • Edit Project
    • Invoice
      • Available Invoice Currencies
      • Create Invoice
      • Get Invoice
      • Get Available Payment Tokens for Invoice
      • Get Payment Address for Invoice
      • Manual Complete Undepaid Invoice
  • Steam
    • Order
      • Create
      • Fetch
    • Account
      • Is valid
  • MARGIN
    • Введение
    • Быстрый старт
    • Health Factor и риски
    • Margin account snapshot
      GET
    • Borrow limit
      GET
    • Withdrawal limit
      GET
    • Simulate a loan or repayment
      GET
    • Borrow
      POST
    • Repay debt
      POST
    • Loans
      GET
    • Loan transaction history
      GET
    • Interest rates
      GET
  • Schemas
    • CryptoProcessing
      • CryptoInvoice
      • CryptoPaymentQuote
      • CryptoDeposit
      • ProjectProcessingTokenSetting
      • ProjectProcessingTokenSettingEditRequest
      • ProjectResponse
    • Open api
      • REMOTE
        • Steam
          • OpenSteamOrder
    • Состояние маржи
    • Состояние маржи после операции
    • Ордер с займом
    • Цены ликвидации
    • Цены маржин-колла
    • Лимит займа
    • Остаток беспроцентного периода
    • Лимит вывода
    • Результат симуляции
    • Запрос займа
    • Запрос погашения
    • Займ
    • Страница займов
    • Операция по займу
    • Страница истории
    • Процентная ставка
    • Ошибка
  1. MARGIN

Simulate a loan or repayment

GET
/borrow/simulate
Требуемый уровень доступа: MARGIN
Показатели риска аккаунта, какими они станут после займа borrowAmount и (или) погашения repayAmount в валюте currency. Без сумм — текущие показатели.
Метод ничего не выполняет и не проверяет, выполнима ли операция: лимит займа и погашаемую часть долга (repayableBorrowing) возвращает GET /borrow/borrow-limit.
В memberSnapshot поля borrows и marginOrdersByCurrency — текущие, без учёта операции; остальные показатели и пороговые цены — после неё. Если borrowAmount больше лимита займа, topUpForRequestedBorrow показывает, сколько обеспечения добавить, чтобы займ стал возможен.
Суммы округляются до 8 знаков после запятой.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Query Params

Responses

🟢200
application/json
Результат симуляции.
Headers

Bodyapplication/json

🟠400
🟠401Unauthorized
🟠403Forbidden
🟠429TooManyRequests
🔴500InternalError
🔴503Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.rapira.net/borrow/simulate?currency=&borrowAmount=&repayAmount=' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "memberSnapshot": {
        "memberId": 12345,
        "borrows": {
            "USDT": 2500
        },
        "marginOrdersByCurrency": {
            "USDT": [
                {
                    "orderId": "C178921394512330017",
                    "amount": 300
                }
            ]
        },
        "collateralValueUsdt": 25260,
        "debtValueUsdt": 22500,
        "equityUsdt": 2760,
        "maintenanceMarginUsdt": 2250,
        "health": 1.22666667,
        "portfolioValueUsdt": 25800,
        "debtToRepayUsdt": 22500,
        "ownFundsUsdt": 3300,
        "withdrawHeadroomUsdt": 0,
        "borrowHeadroomUsdt": 0,
        "liquidationHealth": 1,
        "marginCallHealth": 1.2,
        "withdrawHealth": 1.5,
        "borrowHealth": 1.5,
        "liquidationPrices": {
            "BTC/USDT": 53703.7037037
        },
        "marginCallPrices": {
            "BTC/USDT": 59259.25925926
        }
    },
    "nextInterestAccrualAt": "2026-10-22T10:00:00Z",
    "topUpForRequestedBorrow": {
        "BTC": 0.01138889,
        "USDT": 615
    }
}
Modified at 2026-10-23 11:31:15
Previous
Withdrawal limit
Next
Borrow
Built with