get_balances
Obtém os saldos de tokens nas smart accounts do utilizador. Devolve um array JSON, uma entrada por combinação (account × chain) com saldo diferente de zero. Devolve [] quando o utilizador não tem saldos ou quando os filtros não correspondem a nenhuma conta.
Âmbito necessário: read:balances
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
chain_id | number | não | Filtra por chain ID — por exemplo, 1 (Ethereum), 8453 (Base), 100 (Gnosis). |
account_type | "picnic" | "gnosisPay" | não | Filtra por tipo de smart account. |
Campos devolvidos (por entrada):
| Campo | Tipo | Descrição |
|---|---|---|
account.address | string | Endereço da smart account. |
account.chainId | number | Cadeia onde a smart account vive. |
account.type | "picnic" | "gnosisPay" | Tipo de conta. |
balances[].assetId | string | Identificador estável do ativo no formato CAIP (opens in a new tab) — eip155:{chainId}/erc20:{address} para ERC-20s (bep20 na chain 56) ou eip155:{chainId}/slip44:60 para o ativo nativo da rede. Usa-se para identificar um ativo de forma única entre cadeias. |
balances[].address | string | null | Endereço do contrato do ativo (null para o ativo nativo, identificável pelo account.chainId). |
balances[].symbol | string | Símbolo do token (ex.: "USDC", "BNB"). |
balances[].formattedAmount | string | Saldo em formato decimal. Atenção: é uma string, não um número — preserva a precisão para valores muito pequenos / muito grandes. |
balances[].value.usd | number | null | Saldo convertido para USD. null se o feed de preço não está disponível. |
balances[].value.eur | number | null | Saldo convertido para EUR. null se o feed de preço não está disponível. |
balances[].value.brl | number | null | Saldo convertido para BRL. null se o feed de preço não está disponível. |
Exemplo de pergunta:
"Quanto USDC tenho na Base neste momento?"