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

Быстрый старт

Ниже приведён безопасный сценарий: проверить состояние аккаунта, узнать лимит, смоделировать займ и только после этого выполнить операцию.

1. Подготовьте JWT#

Получите токен через POST /generate_jwt согласно разделу Generate JWT.
Для примеров сохраните токен в переменную окружения:

2. Проверьте состояние маржи#

Ключевые поля ответа:
{
  "collateralValueUsdt": 5260,
  "debtValueUsdt": 2500,
  "health": 11.04,
  "borrowHealth": 1.5,
  "liquidationHealth": 1
}
Перед продолжением убедитесь, что состояние рассчитано и Health Factor находится выше порогов операций.

3. Получите лимит займа#

Для отображения пользователю запросите лимит со страховым запасом:
{
  "currency": "USDT",
  "borrowEnabled": true,
  "borrowLimit": "15900.00000000",
  "minBorrow": 10,
  "repayableBorrowing": 2200,
  "interestRate": 0.00125
}
Перед отправкой операции можно запросить точный лимит с withHaircut=false — именно по нему проверяется POST /borrow.

4. Смоделируйте результат#

Метод не изменяет состояние аккаунта. Проверьте:
будущий health;
liquidationPrices и marginCallPrices;
topUpForRequestedBorrow, если запрошенная сумма превышает лимит.

5. Возьмите займ#

При успехе API отвечает 200 с пустым телом. Затем снова запросите GET /borrow/snapshot и проверьте фактический долг.
Не повторяйте POST /borrow автоматически после ответа 400: операция могла завершиться. Сначала проверьте snapshot и историю операций.

6. Погасите долг#

Получите repayableBorrowing через GET /borrow/borrow-limit. Погашаемая сумма не должна превышать ни это значение, ни свободный баланс валюты.
После ответа снова запросите GET /borrow/snapshot. Для проверки операции также используйте GET /borrow/history с фильтром type=REPAY.
Не повторяйте POST /borrow/repay автоматически после ответа 400: сначала проверьте фактический долг.
Modified at 2026-10-23 11:33:55
Previous
Введение
Next
Health Factor и риски
Built with