---
title: "Etherscan Read Contract: Saldo e Permissões | Ethereum IA"
url: "https://ethereum.ia.br/blog/etherscan-read-contract-balanceof-allowance/"
markdown_url: "https://ethereum.ia.br/blog/etherscan-read-contract-balanceof-allowance.MD"
description: "Consulte balanceOf e allowance no Etherscan sem conectar a carteira. Entenda unidades, contratos proxy e os limites da consulta de saldo e permissões ERC-20."
date: "2026-10-13"
author: "Equipe Ethereum IA"
---

# Etherscan Read Contract: Saldo e Permissões | Ethereum IA

Consulte balanceOf e allowance no Etherscan sem conectar a carteira. Entenda unidades, contratos proxy e os limites da consulta de saldo e permissões ERC-20.


**Para consultar saldo e permissões de um token no Etherscan sem conectar a carteira, abra o contrato correto e use as funções de leitura `balanceOf` e `allowance`.** A primeira consulta a quantidade de tokens de um endereço; a segunda consulta quanto um gastador específico está autorizado a movimentar. São informações diferentes. Nenhuma dessas consultas, por si só, transfere ativos ou revoga permissões.

Este guia explica a leitura de **tokens ERC-20 na Ethereum mainnet**, inclusive a conversão de unidades e o cuidado com contratos proxy. Não ensina a executar funções de escrita nem certifica a segurança de um token.

*Conteúdo educativo, sem aconselhamento financeiro, jurídico ou tributário. Não forneça frase de recuperação, chave privada ou assinatura para consultar dados públicos.*

## Saldo não é permissão de gasto

O [padrão ERC-20](/glossario/erc-20/) define funções que interfaces e contratos usam para consultar e movimentar tokens. Segundo o [EIP-20](https://eips.ethereum.org/EIPS/eip-20), `balanceOf` recebe o endereço do titular e retorna seu saldo. Já `allowance` recebe dois endereços: o titular, também chamado `owner`, e o gastador, chamado `spender`.

| Consulta | Dados necessários | O que o resultado informa | O que não prova |
|---|---|---|---|
| `balanceOf` | Endereço público do titular | Saldo registrado naquele contrato | Valor em reais, liquidez ou possibilidade de resgate |
| `allowance` | Titular e gastador | Limite de gasto autorizado para esse par | Segurança geral da carteira ou ausência de outras permissões |
| `decimals` | Normalmente nenhum argumento | Casas decimais usadas na exibição | Qualidade ou legitimidade do token |
| `totalSupply` | Normalmente nenhum argumento | Quantidade total informada pelo contrato | Distribuição equilibrada, reservas ou solvência |

**Saldo responde quanto o endereço tem; allowance responde quanto um gastador pode usar.** Um usuário pode ter saldo zero e uma aprovação elevada que se torne relevante quando receber novos tokens. Também pode ter saldo positivo e nenhuma permissão para o gastador que está sendo consultado.

O limite não é um depósito separado. Se há saldo de 100 unidades e uma permissão de 1.000 unidades, isso não cria outras 900 unidades. Em um token padrão, o gasto depende também do saldo disponível e das regras de execução.

## 1. Confirme a rede e o contrato do token

Comece pelo endereço do contrato publicado na documentação oficial do emissor ou protocolo. Compare o endereço completo e a rede. Não escolha um contrato apenas porque o nome, símbolo ou logotipo parece conhecido.

- `etherscan.io` corresponde à Ethereum mainnet.
- Base, Arbitrum e outras redes possuem registros próprios; use o explorador indicado pela documentação da rede.
- O endereço do token não é o endereço da sua conta.
- O mesmo símbolo pode ser usado por contratos diferentes, legítimos ou maliciosos.

O guia de [verificação de tokens falsos](/blog/token-falso-ethereum-como-verificar-contrato/) detalha essa identificação. A verificação de código no explorador facilita a inspeção, mas **não é auditoria nem aprovação de segurança**.

Se o objetivo é investigar um token que não aparece na MetaMask, confirme primeiro a rede e a conta. O artigo sobre [token ausente e importação na MetaMask](/blog/token-nao-aparece-metamask-como-importar/) explica quando o problema é apenas de visualização.

## 2. Abra a área de leitura, não a de escrita

Na página do contrato, procure a aba **Contract** e a opção **Read Contract**. Os nomes e a organização da interface podem mudar. Se o explorador identificar um proxy, pode haver uma opção **Read as Proxy** para expor as funções da implementação usando o endereço do proxy.

A distinção importante é:

- **Read:** consulta o estado; não grava uma alteração na blockchain.
- **Write:** permite preparar ações que podem alterar o estado e exigir assinatura ou transação.

Para as consultas deste guia, **não use Connect to Web3 nem conecte a carteira**. Informe somente endereços públicos nos campos das funções. Se uma página exigir seed phrase, pagamento ou assinatura para mostrar um saldo público, interrompa e confira o domínio.

A documentação do Ethereum descreve `eth_call` como uma execução de consulta que não cria uma transação na blockchain. É a base técnica de muitas leituras de contratos. Isso não significa que todo botão de um explorador seja uma consulta: confirme a área e a função escolhidas.

## 3. Consulte balanceOf com o endereço do titular

Localize `balanceOf` e preencha o argumento, que pode aparecer como `_owner`, `account` ou outro nome equivalente, com o **endereço público completo da conta**. Acione o botão de consulta da função.

Não informe o hash de uma transação nem o endereço do token nesse campo. O contrato já foi selecionado quando você abriu a página; o argumento identifica a conta cujo saldo deseja conhecer.

O retorno costuma ser um inteiro `uint256` em unidades mínimas. Para interpretá-lo, consulte `decimals`, quando disponível, e aplique:

**Quantidade exibida = inteiro retornado ÷ 10 elevado ao número de casas decimais.**

Exemplo hipotético, sem referência a um ativo específico:

| Retorno de `balanceOf` | `decimals` | Quantidade interpretada |
|---|---|---|
| `2500000` | `6` | 2,5 tokens |
| `2500000` | `18` | 0,0000000000025 token |

Não presuma que todo ERC-20 tenha 18 casas. O EIP-20 trata `decimals`, `name` e `symbol` como campos opcionais. Se a função não aparecer, não invente um valor: procure a documentação oficial e considere a limitação da interface.

Use ferramentas que preservem inteiros grandes. Planilhas e calculadoras podem arredondar números extensos, prejudicando a conversão. Um saldo calculado incorretamente não altera o registro on-chain, mas pode levar a conclusões erradas.

### O que fazer se o resultado for zero

Confira novamente contrato, rede e titular. Depois, verifique o hash do recebimento e possíveis saídas posteriores. Um evento de transferência no histórico não basta para demonstrar o saldo atual.

O resultado também precisa ser interpretado à luz da legitimidade do contrato: um token malicioso pode exibir informações enganosas. `balanceOf` de um contrato escolhido ao acaso não prova que você possui o ativo autêntico.

## 4. Consulte allowance com titular e gastador

Localize `allowance` e informe:

1. **`owner`:** a conta que concedeu ou pode ter concedido a autorização;
2. **`spender`:** o endereço autorizado a gastar aquele token.

O gastador pode ser um roteador, contrato de protocolo ou outro endereço. Não assuma que ele seja a carteira que recebeu uma transferência anterior, nem que o domínio do site identifique o contrato autorizado. Compare o endereço completo com a documentação oficial e com a aprovação que você está investigando.

A consulta exige conhecer o par. Ela **não lista automaticamente todos os gastadores aprovados**. Para localizar e revisar permissões, veja o [guia de aprovações e revogação de ERC-20](/blog/aprovacoes-token-erc20-revogar-permissoes/).

Interprete o retorno com as mesmas casas decimais do token:

- **Zero:** nenhuma permissão de gasto foi retornada para aquele par naquele estado.
- **Valor positivo:** há um limite registrado, conforme as regras do contrato.
- **Inteiro muito elevado:** pode representar a aprovação que interfaces chamam de ilimitada; não significa saldo disponível nesse montante.

**Consultar allowance não altera a aprovação.** Para reduzi-la ou revogá-la é necessária uma ação separada, normalmente uma transação com gas. Não execute `approve` na área de escrita apenas para testar a leitura.

### Por que allowance zero não é um atestado de segurança

A consulta cobre somente **um token, um titular e um gastador**. Não inclui permissões de outros tokens, autorizações de NFTs ou todos os mecanismos de assinatura utilizados por aplicativos.

Uma assinatura de [Permit](/blog/permit-assinaturas-ethereum-phishing-brasil/) ainda utilizável pode ter consequências que não aparecem como uma autorização já executada. Sistemas com contratos intermediários de permissões também podem exigir análise adicional. Este procedimento não substitui uma revisão completa de exposição.

## 5. Cuidado com contratos proxy

Em um token atualizável, o endereço usado pelo público pode ser um **proxy**, enquanto outro contrato contém a lógica. O saldo e as permissões normalmente devem ser consultados no contexto do proxy usado pelo token, não no endereço isolado da implementação.

Abrir a implementação e executar `balanceOf` ali pode consultar outro armazenamento, retornar zero ou falhar. Isso não demonstra que o saldo no proxy desapareceu. Quando houver **Read as Proxy**, confirme que a consulta continua direcionada ao endereço oficial do token.

Nem todo proxy é reconhecido automaticamente. Se a arquitetura estiver incerta, não deduza que o contrato é imutável ou que um resultado isolado é conclusivo. Consulte o [guia de contratos proxy e upgrades](/blog/contrato-proxy-ethereum-como-verificar-upgrades/).

## Limites: leitura não é prova de liquidez, histórico ou identidade

Uma consulta representa o estado usado pelo serviço naquele momento. A documentação de [JSON-RPC](https://ethereum.org/en/developers/docs/apis/json-rpc/) explica que consultas de estado dependem do bloco escolhido. Não trate um valor visto hoje como prova automática do saldo de uma data passada.

Além disso:

- saldo de token não garante que a transferência seja permitida; podem existir pausas ou bloqueios;
- quantidade não garante preço, compradores ou resgate;
- `balanceOf` não consulta saldo de ETH nativo; ele consulta o token selecionado;
- uma chamada com erro não equivale a saldo zero;
- o endereço público não identifica, sozinho, nome ou CPF do controlador;
- compartilhar o endereço pode permitir que terceiros associem seu histórico público à sua identidade.

Se houver discrepância entre carteira e explorador, registre a rede, os endereços e o horário antes de tentar qualquer correção. **Não restaure a carteira nem forneça sua seed para resolver uma diferença de exibição.**

## Checklist de registro para usuários no Brasil

Para documentar a consulta, guarde:

- rede e URL do explorador;
- endereço completo do contrato, incluindo a distinção entre proxy e implementação;
- titular e, no caso de `allowance`, gastador;
- nome da função e argumentos informados;
- retorno bruto, casas decimais e conversão feita;
- data, horário, fuso e bloco, quando informado pela ferramenta;
- hash da operação relacionada, se houver.

Esses registros ajudam a explicar uma investigação técnica. Uma captura de `balanceOf` **não substitui** documentação da compra, custo de aquisição em reais, comprovantes da corretora ou análise tributária. Consultar saldo ou permissão não é, por si só, comprar, vender ou transferir criptoativos.

Para organização documental, consulte o [guia de comprovantes on-chain para contabilidade](/blog/comprovante-on-chain-contabilidade-cripto-brasil/). Este artigo não determina obrigações perante a Receita Federal, não interpreta regras tributárias vigentes e não atribui certificação regulatória a contratos. Questões fiscais e jurídicas exigem fontes oficiais atualizadas e análise profissional do caso concreto.

## Perguntas frequentes

### Preciso ter ETH para consultar balanceOf?

Não para uma consulta pública de leitura. Você não envia uma transação nem paga gas da sua carteira. Movimentar tokens depois é outra ação e pode exigir o ativo nativo da rede.

### Posso usar o endereço de qualquer pessoa?

Sim, os saldos e permissões consultáveis de contratos públicos podem ser lidos com endereços públicos. Isso não dá controle sobre os ativos nem comprova quem é o proprietário real da conta.

### Allowance mostra quanto já foi gasto?

Não. Mostra o limite retornado no estado consultado. Para reconstruir gastos e mudanças, é preciso examinar operações e eventos, considerando o comportamento específico do contrato.

### Read Contract é sempre suficiente para descobrir todos os riscos?

Não. É uma ferramenta de consulta. Não analisa automaticamente código malicioso, upgrades futuros, assinaturas fora da blockchain, risco de liquidez ou comprometimento da chave privada.

### E se a função não estiver disponível?

Pode faltar a interface de funções, haver um proxy não reconhecido ou o contrato não implementar a função esperada. Confirme a documentação e a arquitetura. Não conecte a carteira nem use funções de escrita para compensar a ausência da leitura.

## Fontes e escopo

As referências técnicas foram consultadas em **13 de outubro de 2026**. Os rótulos de interface podem mudar; o procedimento depende da rede, da interface publicada do contrato e da arquitetura do token.

- [Ethereum.org — Padrão ERC-20](https://ethereum.org/en/developers/docs/standards/tokens/erc-20/)
- [EIP-20 — Funções e campos opcionais do padrão](https://eips.ethereum.org/EIPS/eip-20)
- [Ethereum.org — JSON-RPC e consultas de estado](https://ethereum.org/en/developers/docs/apis/json-rpc/)
- [Ethereum.org — Segurança e prevenção de golpes](https://ethereum.org/pt-br/security/)
- [Etherscan — Documentação oficial](https://docs.etherscan.io/)

Para a leitura dos demais campos do explorador, veja o [tutorial de Etherscan](/blog/tutorial-ler-etherscan/).

---

**Aviso:** conteúdo exclusivamente informativo e educacional, sem recomendação de investimento, token, protocolo ou carteira. Não constitui aconselhamento financeiro, jurídico, tributário ou de segurança individual. Consultas públicas não garantem legitimidade, recuperabilidade ou valor dos ativos. Confirme as informações em fontes oficiais e nunca compartilhe frase de recuperação ou chave privada.