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

Введение

Маржинальная торговля позволяет брать займы под залог активов аккаунта, гасить долг, а также получать лимиты и показатели риска.
Маржинальная торговля связана с риском ликвидации. Перед займом проверяйте Health Factor и результат симуляции операции.

Перед началом#

Убедитесь, что:
1.
для аккаунта включён маржинальный режим;
2.
создан API-ключ с правом MARGIN;
3.
для ключа настроен список разрешённых IP-адресов;
4.
через POST /generate_jwt получен JWT.
Передавайте токен в заголовке Authorization: Bearer <token>. Базовый URL API: https://api.rapira.net/open.

Как это устроено#

Маржинальная торговля идёт на спотовом счёте в режиме кросс-маржи.
Обеспечение — все балансы аккаунта, включая средства в открытых ордерах. Активы, которые платформа не принимает в обеспечение, в расчёт не входят.
Долг ведётся по каждой валюте отдельно. Займ зачисляется на спотовый баланс в валюте займа, погашение списывается с баланса той же валюты. Новый займ в валюте увеличивает долг в ней.
Ордер с займом, выставленный в интерфейсе биржи, держит заёмные средства в своём резерве. Эту часть долга нельзя погасить вручную: когда ордер завершается, неизрасходованные заёмные средства из резерва гасят долг автоматически.

Health Factor#

ПоказательПолеРасчёт
ОбеспечениеcollateralValueUsdtΣ баланс × цена × коэффициент обеспечения актива (не больше 1)
Долг с учётом рискаdebtValueUsdtΣ долг × цена × коэффициент риска валюты долга (не меньше 1)
Запас маржиequityUsdtобеспечение − долг с учётом риска
Поддерживающая маржаmaintenanceMarginUsdtдолг с учётом риска × коэффициент поддерживающей маржи
Health Factorhealthзапас маржи ÷ поддерживающая маржа; без долга — 999999
Пороги Health Factor возвращает GET /borrow/snapshot:
ПорогЧто происходит
borrowHealthзайм выдаётся, только если после него Health Factor не ниже порога
withdrawHealthвывод разрешён, только если после него Health Factor не ниже порога
marginCallHealthпри Health Factor не выше порога наступает маржин-колл: аккаунт получает уведомление
liquidationHealthпри Health Factor не выше порога начинается ликвидация: платформа продаёт активы аккаунта и гасит долг

Проценты#

Проценты начисляются раз в час на текущий долг и прибавляются к нему — в истории это записи INTEREST. Ставка указывается в процентах за час и может меняться. Если на платформе включён беспроцентный период, проценты не начисляются 24 часа с момента, когда долг в валюте стал больше нуля.

Рекомендуемый порядок работы#

1.
Запросите состояние через GET /borrow/snapshot.
2.
Получите лимит через GET /borrow/borrow-limit.
3.
Смоделируйте операцию через GET /borrow/simulate.
4.
Выполните займ через POST /borrow.
5.
Проверьте фактический долг через GET /borrow/snapshot.
6.
Для погашения узнайте repayableBorrowing и вызовите POST /borrow/repay.
Подробный сценарий с примерами запросов приведён на странице «Быстрый старт». Расчёт рисков и порогов разобран на странице «Health Factor и риски».

Доступ#

Требуемый уровень доступа: MARGIN. Токен передаётся в заголовке Authorization: Bearer <token>, его выдаёт POST /generate_jwt. Для аккаунта должен быть включён маржинальный режим, иначе методы отвечают 400.

Форматы#

Суммы — в единицах валюты, до 8 знаков после запятой. Поля с суффиксом Usdt — в USDT; стоимость активов и долга пересчитывается по текущим ценам. Часть сумм передаётся строкой, это указано у поля.
Время — ISO 8601 в UTC, например 2026-10-22T09:15:30.123Z.
Код валюты — в верхнем регистре, например USDT.
Страницы нумеруются с 0.
Путь /borrow/interest-comission и поля interestComissionEnabled, isInterestComissionEnabled пишутся с исторической опечаткой comission. Используйте их ровно так: это часть контракта API.

Ограничение частоты запросов#

На каждый метод — не больше 30 запросов за 10 секунд и 300 запросов за 10 минут на аккаунт; лимиты методов независимы. Успешный ответ несёт заголовок X-Rate-Limit-Remaining, ответ 429 — X-Rate-Limit-Retry-After-Seconds.

Ошибки#

КодКогдаТело
400Операция отклонена или расчёт не выполнен; причины перечислены у методовпустое
400Параметр в неверном формате: сумма не число, дата не в ISO 8601объект ошибки
401Токен не передан или недействителен, ключ отозванобъект ошибки
403У ключа нет права MARGIN или IP-адрес не разрешён для ключаобъект ошибки
429Превышено ограничение частоты запросовобъект ошибки
500Нет обязательного параметра, тело запроса не разобрано как JSON, или внутренняя ошибкаобъект ошибки
503API временно недоступнообъект ошибки
Ответ 400 после POST /borrow или POST /borrow/repay не гарантирует, что операция не состоялась. Не повторяйте запрос автоматически: сначала проверьте фактический долг через GET /borrow/snapshot и запись через GET /borrow/history.
Modified at 2026-10-23 11:33:55
Previous
Is valid
Next
Быстрый старт
Built with