GET/v1/balances

Listar saldos

Devuelve todos los saldos que la cuenta posee. Los activos con total cero se omiten salvo que include_zero=true.

Parámetros

booleanOptionalDefault: false

Cuando es true, incluye activos con los que la cuenta ha interactuado aunque todos los componentes estén actualmente en cero.

Devuelve

Una lista de objetos Balance, uno por activo.

Errores

StatusCodeDescription
401authentication_error

API key ausente o inválida.

Listar saldos
curl https://api.aeses.io/v1/balances \
-H "x-api-key: sk_live_..."
Response
{
"object": "list",
"data": [
  {
    "object": "balance",
    "asset": "USDC",
    "available": "1250.75",
    "pending": "99.50",
    "locked": "150.00",
    "total": "1500.25",
    "updated_at": 1731600125
  },
  {
    "object": "balance",
    "asset": "BTC",
    "available": "0.02145000",
    "pending": "0.00000000",
    "locked": "0.00000000",
    "total": "0.02145000",
    "updated_at": 1731598000
  }
],
"has_more": false,
"next_cursor": null
}