POST /v1/balance

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

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

Примеры используют хелпер call() и переменные $SECRET/$PUBLIC_ID — их определение см. в Как подписать запрос. Проще не писать подпись руками, а взять SDK.

---

​

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

cURL

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 '{}'

call("/v1/balance", {})

await call("/v1/balance", {});

---

​

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

{
  "state": 0,
  "result": {
    "balance": {
      "merchant": [
        { "currency": "USDT", "balance": "1240.75" },
        { "currency": "BTC", "balance": "0.01843000" }
      ]
    }
  }
}

balance.merchant · array

По записи на валюту: currency + доступный balance (строкой).

---

​

Нюансы

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

---

​

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

Модель баланса и движение средств

общая картина available/maturing/held.

POST /v1/payout

списывает доступный баланс.

Форматы сумм и денег

Формат ответа и коды ошибок