El objeto Balance
Representa el saldo contable interno del comerciante para un único activo. Aeses no provee billetera custodial — en su lugar, cada depósito acredita el saldo del activo correspondiente, cada retiro lo debita, y las operaciones de swap mueven valor entre saldos sin ninguna transacción on-chain.
Los saldos son snapshots desnormalizados actualizados por el ledger. Son eventualmente consistentes con el journal — para contabilidad transacción por transacción, consulta directamente las entries del ledger.
Atributos
Monto disponible para retiro o swap, como string decimal. Excluye fondos bloqueados por retiros pendientes.
Fondos recibidos pero aún no confirmados on-chain. Pasan a available cuando se alcanza el umbral de confirmación.
Fondos reservados por un retiro en curso. Se resta de available hasta que el retiro se complete o falle.
available + pending + locked. Provisto por conveniencia; siempre igual a la suma de los otros tres campos.
Endpoints
GET /v1/balances— listar todos los saldos de la cuenta.GET /v1/balances/:asset— recuperar un saldo único por código de activo.
{
"object": "balance",
"asset": "USDC",
"available": "1250.75",
"pending": "99.50",
"locked": "150.00",
"total": "1500.25",
"updated_at": 1731600125
}