На странице
Получение
Получайте доступные балансы по токенам без разделения по сети входящего платежа и проверяйте сумму перед созданием вывода.
GET/v1/balances
API-ключ: Payout
Возвращает доступный баланс мерчанта одной суммой по каждому стейблкоину — суммарно по всем сетям, по одной записи на актив. Баланс не привязан к сети: сеть выбирается при создании вывода. Нулевые балансы в ответ не попадают. Среду определяет ключ API: тестовый ключ возвращает тестовые балансы, рабочий — реальные.
Ответ (200 OK)
[
{ "currency": "USDT", "available": "1750.50" },
{ "currency": "USDC", "available": "500.00" }
]
Поля ответа
Ответ — массив: одна запись на монету, суммарно по всем сетям.
| Поле | Тип | Описание |
|---|---|---|
currency |
string | Символ токена — напр. USDT, USDC, DAI |
available |
string | Доступный баланс в единицах самого токена, суммарно по всем сетям; десятичная строка, разделитель — точка |
Ошибки
Для чтения балансов нужен Payout-ключ (rk_) — Payment-ключ отклоняется с 403 payout_key_required. См. Коды ошибок — полный каталог. URI в поле type каждой ошибки ведёт сразу на нужную строку.