Saldos

Conceitos rápidos

• balance Saldo conhecido da vault em uma rede e ativo.

Os saldos servem como base para consultas operacionais, conciliação e decisão antes de movimentar fundos.

Consultar saldos da vault

Endpoint: GET /vaults/:vaultId/balances

Serve para

Consultar os saldos conhecidos da vault.

Autenticação

Exige bearer token com permissão vault:read.

Retorno

{
  "vaultId": "12",
  "balances": [
    {
      "id": "uuid",
      "asset": "native",
      "tokenAddress": "",
      "network": "polygon",
      "available": "1000000000000000000",
      "pending": "0",
      "assetSymbol": "POL",
      "assetDecimals": 18,
      "createdAt": "2026-03-26T12:00:00.000Z",
      "updatedAt": "2026-03-26T12:00:00.000Z"
    }
  ]
}

Observações

• Se não houver saldo local ainda, a API tenta hidratar saldos on-chain para redes EVM.
• available e pending são string.
• assetSymbol e assetDecimals ajudam a exibir o saldo de forma amigável no cliente.