Перейти к основному содержимому

Балансы

Есть два уровня детализации:

  • все активы на выбранном счёте — GET /balances;
  • один актив — GET /balance/{asset}.

Все активы на счёте (пользователь, x-uid)​

Если параметр account не указан, используется счёт по умолчанию в аккаунте (на момент запроса).

GET https://api.cobrex.com/balances?account=a-9bb4cd8e-8879-477e-933a-1e5e8b218bd7

Заголовки​

ЗаголовокЗначение
x-uidUser ID
x-timestampСекунды
x-signatureHMAC для полный_URL\ntimestamp (без тела)

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

{
"USDT": "1083530.173677641529258117",
"TRX": "992021.628360113000000000",
"USD": "0.000000000000000000",
"RUB": "0.000000000000000000",
"BTC": "0.435603704990000000",
"LTC": "319.820302446910000000",
"ETH": "23.542343766434554606",
"DOGE": "50390.235547610480000000",
"USDC": "4871.024994072630000000",
"BNB": "4.454887432542300579",
"TON": "48620.208383471331000000",
"SOL": "133.832716930910000000",
"XMR": "4.391850438178135000"
}

Ключ — тикер актива, значение — строка с числом (фиксированная точность на стороне API).


Все активы по мерчанту (x-mid)​

Баланс счёта, привязанного к мерчанту.

GET https://api.cobrex.com/balances

Заголовки​

ЗаголовокЗначение
x-midMerchant ID
x-timestampСекунды
x-signatureHMAC для URL\ntimestamp

Формат ответа — тот же объект «тикер → строка баланса».


Баланс одного актива (пользователь)​

GET https://api.cobrex.com/balance/USDT?account=a-9bb4cd8e-8879-477e-933a-1e5e8b218bd7

Без account — снова используется счёт по умолчанию.

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

{
"balance": "1082922.502057541529258117"
}

Баланс одного актива (мерчант)​

GET https://api.cobrex.com/balance/USDT

С заголовком x-mid — баланс актива на счёте мерчанта.

Заголовки​

Те же три заголовка (x-mid, x-timestamp, x-signature), подпись без тела.