> ## Documentation Index
> Fetch the complete documentation index at: https://oblodai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/balance

Доступные (расходуемые) балансы мерчанта — по одной записи на валюту.

**URL:** `https://api.oblodai.com/v1/balance` · **Аутентификация:** обязательна · **Тело:** пустой объект `{}` — параметров нет.

<Note>
  Примеры используют хелпер `call()` и переменные `$SECRET`/`$PUBLIC_ID` — их определение см. в
  [Как подписать запрос](/guides/signing-requests). Проще не писать подпись руками, а взять
  [SDK](/sdk/overview).
</Note>

***

## Пример запроса

<CodeGroup>
  ```bash cURL theme={null}
  TS=$(date +%s)
  SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/balance' '{}' \
    | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
  curl -s https://api.oblodai.com/v1/balance \
    -X POST -H 'Content-Type: application/json' \
    -H "X-Public-Id: $PUBLIC_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
    -d '{}'
  ```

  ```python Python theme={null}
  call("/v1/balance", {})
  ```

  ```js Node.js theme={null}
  await call("/v1/balance", {});
  ```
</CodeGroup>

***

## Пример ответа

```json theme={null}
{
  "state": 0,
  "result": {
    "balance": {
      "merchant": [
        { "currency": "USDT", "balance": "1240.75" },
        { "currency": "BTC", "balance": "0.01843000" }
      ]
    }
  }
}
```

<ResponseField name="balance.merchant" type="array">
  По записи на валюту: `currency` + доступный `balance` (строкой).
</ResponseField>

***

## Нюансы

* Показываются только счета **`available`** — «замороженные» части (например, `payout_held`) не
  включаются.
* **Незрелые (maturing) средства.** Депозит зачисляется на баланс сразу, но до набора нужных
  подтверждений остаётся под maturity‑холдом (reorg‑безопасность). Такие средства **видны в
  `balance`**, но ещё не выводимы: выплата на сумму, включающую незрелые средства, вернёт
  `409 payout.funds_maturing`. Поэтому выводимый остаток может быть временно **меньше** показанного.
  Разбивку available/maturing метод **не возвращает**; рабочая стратегия — повтор с backoff по `409`,
  см. [Устойчивый клиент](/guides/resilient-client#не-все-409-финальны) и
  [модель баланса](/guides/balance-and-funds).

***

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Модель баланса и движение средств" href="/guides/balance-and-funds" icon="arrow-right" horizontal>
    общая картина available/maturing/held.
  </Card>

  <Card title="POST /v1/payout" href="/reference/payout-create" icon="arrow-right" horizontal>
    списывает доступный баланс.
  </Card>

  <Card title="Форматы сумм и денег" href="/reference/basics-money" icon="arrow-right" horizontal />

  <Card title="Формат ответа и коды ошибок" href="/reference/basics-errors" icon="arrow-right" horizontal />
</CardGroup>