GET/v1/balances/:asset

Recuperar un saldo

Devuelve el objeto Balance actual para un único activo. El path param asset es el código del activo (USDC, BTC, …).

Parámetros

stringRequired

Código del activo en el path. Case-insensitive.

Devuelve

El objeto Balance, o 404 not_found si la cuenta nunca tuvo este activo.

Errores

Status	Code	Description
404	`not_found`	La cuenta no tiene registro de este activo.
401	`authentication_error`	API key ausente o inválida.

Recuperar un saldo

curl https://api.aeses.io/v1/balances/USDC \
-H "x-api-key: sk_live_..."

Response

{
"object": "balance",
"asset": "USDC",
"available": "1250.75",
"pending": "99.50",
"locked": "150.00",
"total": "1500.25",
"updated_at": 1731600125
}