GET/v1/balances/:asset

Recuperar um saldo

Retorna o objeto Balance atual para um único ativo. O path param asset é o código do ativo (USDC, BTC, …).

Parâmetros

stringRequired

Código do ativo no path. Case-insensitive.

Retorna

O objeto Balance, ou 404 not_found se a conta nunca teve este ativo.

Erros

Status	Code	Description
404	`not_found`	A conta não tem registro deste ativo.
401	`authentication_error`	API key ausente ou inválida.

Recuperar um 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
}