# Получение балансов

> Получайте доступные балансы по токенам без разделения по сети входящего платежа и проверяйте сумму перед созданием вывода.

`GET /v1/balances`

:::endpoint
GET /v1/balances
:::

**API-ключ:** `Payout`

Возвращает доступный баланс мерчанта одной суммой по каждому активу — суммарно по всем сетям, по одной записи на актив. Баланс не привязан к сети: сеть выбирается при создании вывода. Нулевые балансы в ответ не попадают. Среду определяет ключ API: тестовый ключ возвращает тестовые балансы, рабочий — реальные.

## Ответ (200 OK)

```json
[
  { "currency": "USDT", "available": "1750.50" },
  { "currency": "USDC", "available": "500.00" }
]
```

## Поля ответа

Ответ — массив: одна запись на монету, суммарно по всем сетям.

| Поле | Тип | Описание |
|------|-----|----------|
| `currency` | string | Символ токена — напр. `USDT`, `USDC`, `DAI` |
| `available` | string | Доступный баланс в единицах самого токена, суммарно по всем сетям; десятичная строка, разделитель — точка |

## Ошибки

Для чтения балансов нужен Payout-ключ (`rk_`) — Payment-ключ отклоняется с `403 payout_key_required`. См. [Коды ошибок](/ru/docs/errors/codes.md) — полный каталог. URI в поле `type` каждой ошибки ведёт сразу на нужную строку.
