GET /apiv2/billing/rate
Ваш текущий курс: сколько стоит один TRX в валюте вашего договора. У каждого аккаунта своя валюта договора, поэтому пара и курс индивидуальны для вас. Используйте его для проверки сумм в ваших собственных записях. Часть постоплатного биллинга.
URL эндпоинта
GET https://netts.io/apiv2/billing/rateЗаголовки запроса
| Заголовок | Обязательный | Описание |
|---|---|---|
X-API-KEY | да | API-ключ с разрешением billing.read |
X-Real-IP | да | Адрес из белого списка ключа |
У запроса нет параметров. Валюта берется из вашего договора.
Пример
bash
curl -s 'https://netts.io/apiv2/billing/rate' \
-H 'X-API-KEY: your-api-key' \
-H 'X-Real-IP: 203.0.113.10'json
{
"success": true,
"data": {
"asset": "<currency of your contract>",
"pair": "TRX/<currency of your contract>",
"rate": "0.331515333133553092",
"at": "2026-10-20T05:52:15.915512+00:00"
},
"timestamp": "2026-10-20T05:52:20+00:00"
}Поля ответа
| Поле | Описание |
|---|---|
asset | валюта вашего договора, как в settlement.asset в аккаунте |
pair | TRX/ и валюта вашего договора |
rate | сколько стоит один TRX в валюте вашего договора, десятичная строка с 18 знаками после запятой |
at | момент фиксации курса, UTC; null, если валюта вашего договора — TRX |
Если валюта вашего договора — TRX, поле rate равно "1".
Курс меняется со временем. Это курс на момент времени at, а не гарантия курса для будущей заявки: для зафиксированного списания сохраняется курс на момент его совершения — см. зафиксированный обменный курс.
Ошибки
| HTTP | code | Значение |
|---|---|---|
| 401 | -1, -2 | ключ отсутствует или недействителен, либо IP-адрес не внесен в белый список — ответ API-шлюза, см. формат ответа |
| 403 | billing_read_required | у ключа нет разрешения billing.read |
| 403 | postpaid_required | для аккаунта не подключен постоплатный биллинг |
| 503 | rate_unavailable | курс временно недоступен — повторите попытку позже |
Все коды перечислены в разделе постоплатный биллинг.