O objeto Balance
Representa o saldo contábil interno do comerciante para um único ativo. A Aeses não fornece carteira custodial — em vez disso, cada depósito credita o saldo do ativo correspondente, cada saque debita, e operações de swap movem valor entre saldos sem nenhuma transação on-chain.
Saldos são snapshots desnormalizados atualizados pelo ledger. São eventualmente consistentes com o journal — para contabilidade transação a transação, consulte as entries do ledger diretamente.
Atributos
Valor disponível para saque ou swap, como string decimal. Exclui fundos travados por saques pendentes.
Fundos recebidos mas ainda não confirmados on-chain. Migram para available quando atingem o threshold de confirmação.
Fundos reservados por um saque em andamento. Subtraído de available até o saque completar ou falhar.
available + pending + locked. Fornecido por conveniência; sempre igual à soma dos três outros campos.
Endpoints
GET /v1/balances— listar todos os saldos da conta.GET /v1/balances/:asset— recuperar um saldo único pelo código do ativo.
{
"object": "balance",
"asset": "USDC",
"available": "1250.75",
"pending": "99.50",
"locked": "150.00",
"total": "1500.25",
"updated_at": 1731600125
}