Курс USDT/RUB

Live-курс, по которому рассчитываются котировки QR-ордеров.

Endpoint

GET /rates/current

Пример

curl 'https://b2b.lumowallet.io/rates/current' \
  -H 'X-API-Key: YOUR_API_KEY'

Ответ

{
  "rate": 91.575,
  "effectiveRate": 91.575,
  "baseRate": 92.5,
  "offsetBps": -100,
  "minAmountRub": 0,
  "maxAmountRub": 1000000,
  "pair": "USDT/RUB",
  "timestamp": "2026-05-01T12:34:56Z"
}

Поля

Поле	Описание
`rate`	Итоговый курс RUB/USDT с учётом комиссии вашей компании. Именно этот курс будет применён в `/orders/prepare`
`effectiveRate`	Дубликат `rate` для явности
`baseRate`	Сырой курс Rapira (USDT/RUB ask) без комиссии
`offsetBps`	Ваша комиссия в basis points. `-100` = `-1%`, `0` = курс без комиссии
`minAmountRub`	Минимальная сумма QR-ордера (в рублях), допускаемая `/orders/prepare`
`maxAmountRub`	Максимальная сумма QR-ордера
`pair`	Всегда `USDT/RUB`
`timestamp`	Время ответа сервера (ISO 8601)

Как считается комиссия

effectiveRate = baseRate × (1 + offsetBps / 10000)

Пример: при baseRate = 92.5 и offsetBps = -100 (-1%): 92.5 × 0.99 = 91.575. Это значит, что за 1 USDT компания «получит» 91.575 ₽ — разница в 0.925 ₽ — наша комиссия.

Частота обновления

Курс на бэкенде синхронизируется с Rapira раз в 15 секунд. Внутри этого окна baseRate будет одинаковым для всех вызовов.

Зачем это нужно

Показать актуальный курс пользователю до сканирования QR.
Предсчитать сумму USDT для произвольной RUB-суммы (amountUsdt = amountRub / rate).
Проверить лимиты min/max до отправки QR.

Сама котировка с фиксированным курсом создаётся в POST /orders/prepare — TTL 30 секунд.