Finance OS / API

Balance Overview

GET /api/wallet/balance
Bearer Token

Балансы всех валют пользователя

Возвращает срез по всем валютам, по которым у пользователя есть ненулевой или активный кошелёк. Дополнительно — RUB-эквивалент и lock-info для средств в открытых заявках.

Query parameters

Name Type Required Description
currency string optional Отфильтровать по одной валюте: ?currency=USDT.
min_amount decimal optional Скрыть «пыль» — балансы меньше указанной суммы.
with_locked boolean optional Включать ли заблокированные суммы (в открытых ордерах, OTC, эскроу).
Default: true

Response

Responses

{
  "data": [
    {
      "currency": "USDT",
      "available": "1250.450000",
      "locked": "100.000000",
      "total": "1350.450000",
      "rub_equivalent": "131625.50",
      "networks": ["TRC20", "ERC20", "BEP20"],
      "default_network": "TRC20"
    },
    {
      "currency": "BTC",
      "available": "0.05432100",
      "locked": "0.00000000",
      "total": "0.05432100",
      "rub_equivalent": "248120.30",
      "networks": ["BTC"],
      "default_network": "BTC"
    },
    {
      "currency": "RUB",
      "available": "15000.00",
      "locked": "0.00",
      "total": "15000.00",
      "rub_equivalent": "15000.00",
      "networks": ["SBP"],
      "default_network": "SBP"
    }
  ],
  "meta": {
    "total_rub_equivalent": "394745.80",
    "as_of": "2026-05-27T14:23:00Z",
    "rates_source": "internal_oracle"
  }
}

Поля баланса

Name Type Required Description
available decimal (string) optional Доступно для расходов (вывод, торговля, переводы).
locked decimal (string) optional Заблокировано в открытых ордерах, OTC-сделках или эскроу.
total decimal (string) optional available + locked. Полный баланс.
rub_equivalent decimal (string) optional Эквивалент в рублях по внутреннему курсу (oracle).
networks array optional Поддерживаемые сети для депозита/вывода этой валюты.
default_network string optional Рекомендуемая сеть (наименьшая комиссия).
Курсы
RUB-эквивалент рассчитывается через внутренний oracle, агрегирующий курсы с 5+ бирж. Обновляется раз в 30 секунд. Для торговых решений используйте GET /api/market/ticker с актуальной ценой конкретной пары.