# Курс USDT/RUB

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

## Endpoint

```
GET /rates/current
```

## Пример

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

## Ответ

```json
{
  "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`](/guides/orders/prepare-order) — TTL 30 секунд.