Saltar al contenido principal

Saldos

Dos niveles de detalle:

  • Todos los activos en la cuenta seleccionada — GET /balances;
  • Un solo activo — GET /balance/{asset}.

Todos los activos en una cuenta (usuario, x-uid)​

Si account se omite, se usa la cuenta predeterminada del perfil.

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

Cabeceras​

CabeceraValor
x-uidUser ID
x-timestampSegundos
x-signatureHMAC para URL_completa\ntimestamp (sin cuerpo)

Ejemplo de respuesta​

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

Las claves son tickers de activo; los valores son cadenas decimales (precisión fijada por la API).

Todos los activos para un comerciante (x-mid)​

Saldo de la cuenta vinculada al comerciante.

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

Cabeceras​

CabeceraValor
x-midMerchant ID
x-timestampSegundos
x-signatureHMAC para URL\ntimestamp

Misma forma de respuesta: ticker → cadena de saldo.

Saldo de un solo activo (usuario)​

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

Sin account, aplica la cuenta predeterminada.

Ejemplo de respuesta​

{
  "balance": "1082922.502057541529258117"
}

Saldo de un solo activo (comerciante)​

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

Con x-mid — saldo de ese activo en la cuenta vinculada al comerciante.

Cabeceras​

Las mismas tres: x-mid, x-timestamp, x-signature; firma sin cuerpo.