Hotwallets

Saldos

Esta secao explica como a Hotwallets acompanha os saldos conhecidos de cada vault. Ela e responsavel por mostrar o que esta disponivel em cada rede e ativo, servindo como base para consultas operacionais, conciliacao e tomada de decisao antes de movimentar fundos.

Conceitos rápidos

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

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"
    }
  ]
}

Observacoes

  • Se não houver saldo local ainda, a API tenta hidratar saldos on-chain para redes EVM.
  • available e pending são string.