Маржинальная торговля позволяет брать займы под залог активов аккаунта, гасить долг, а также получать лимиты и показатели риска.Маржинальная торговля связана с риском ликвидации. Перед займом проверяйте Health Factor и результат симуляции операции.
Перед началом#
1.
для аккаунта включён маржинальный режим;
2.
создан API-ключ с правом MARGIN;
3.
для ключа настроен список разрешённых IP-адресов;
Передавайте токен в заголовке Authorization: Bearer <token>. Базовый URL API: https://api.rapira.net/open.Как это устроено#
Маржинальная торговля идёт на спотовом счёте в режиме кросс-маржи.Обеспечение — все балансы аккаунта, включая средства в открытых ордерах. Активы, которые платформа не принимает в обеспечение, в расчёт не входят.
Долг ведётся по каждой валюте отдельно. Займ зачисляется на спотовый баланс в валюте займа, погашение списывается с баланса той же валюты. Новый займ в валюте увеличивает долг в ней.
Ордер с займом, выставленный в интерфейсе биржи, держит заёмные средства в своём резерве. Эту часть долга нельзя погасить вручную: когда ордер завершается, неизрасходованные заёмные средства из резерва гасят долг автоматически.
Health Factor#
| Показатель | Поле | Расчёт |
|---|
| Обеспечение | collateralValueUsdt | Σ баланс × цена × коэффициент обеспечения актива (не больше 1) |
| Долг с учётом риска | debtValueUsdt | Σ долг × цена × коэффициент риска валюты долга (не меньше 1) |
| Запас маржи | equityUsdt | обеспечение − долг с учётом риска |
| Поддерживающая маржа | maintenanceMarginUsdt | долг с учётом риска × коэффициент поддерживающей маржи |
| Health Factor | health | запас маржи ÷ поддерживающая маржа; без долга — 999999 |
| Порог | Что происходит |
|---|
borrowHealth | займ выдаётся, только если после него Health Factor не ниже порога |
withdrawHealth | вывод разрешён, только если после него Health Factor не ниже порога |
marginCallHealth | при Health Factor не выше порога наступает маржин-колл: аккаунт получает уведомление |
liquidationHealth | при Health Factor не выше порога начинается ликвидация: платформа продаёт активы аккаунта и гасит долг |
Проценты#
Проценты начисляются раз в час на текущий долг и прибавляются к нему — в истории это записи INTEREST. Ставка указывается в процентах за час и может меняться. Если на платформе включён беспроцентный период, проценты не начисляются 24 часа с момента, когда долг в валюте стал больше нуля.Рекомендуемый порядок работы#
Подробный сценарий с примерами запросов приведён на странице «Быстрый старт». Расчёт рисков и порогов разобран на странице «Health Factor и риски».Доступ#
Требуемый уровень доступа: MARGIN. Токен передаётся в заголовке Authorization: Bearer <token>, его выдаёт POST /generate_jwt. Для аккаунта должен быть включён маржинальный режим, иначе методы отвечают 400.Форматы#
Суммы — в единицах валюты, до 8 знаков после запятой. Поля с суффиксом Usdt — в USDT; стоимость активов и долга пересчитывается по текущим ценам. Часть сумм передаётся строкой, это указано у поля.
Время — ISO 8601 в UTC, например 2026-10-22T09:15:30.123Z.
Код валюты — в верхнем регистре, например USDT.
Путь /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, или внутренняя ошибка | объект ошибки |
503 | API временно недоступно | объект ошибки |
Modified at 2026-10-23 11:33:55