Como Adicionar Tokens Personalizados ao MetaMask (2026)

Como o MetaMask Lida com Tokens

Quando você recebe tokens, eles chegam em sua carteira na blockchain imediatamente. Mas o MetaMask precisa conhecer o contrato do token para exibir o saldo. Pense nisso como uma lista de contatos: os tokens já estão “chamando” seu endereço, mas o MetaMask não sabe como lê-los até que você adicione os detalhes do token.

O MetaMask armazena uma lista de tokens conhecidos e pode detectar muitos automaticamente. Para qualquer coisa fora dessa lista, você adiciona o token manualmente usando seu endereço de contrato.


Método 1: Detectar Tokens Automaticamente

O MetaMask possui um recurso de detecção automática de tokens que verifica seu endereço e encontra os tokens ERC-20 que você possui. Este é o método mais fácil e funciona para a maioria dos tokens populares.

Como ativar e usar a detecção automática:

  • Abra o MetaMask
  • Clique no avatar da conta → Configurações
  • Vá para Segurança e Privacidade
  • Certifique-se de que Detectar tokens automaticamente está ativado
    • Retorne à tela principal da sua carteira
  • Role para baixo e clique em Atualizar lista ou aguarde o MetaMask verificar automaticamente
  • Quando os tokens são detectados, uma notificação aparece na parte inferior da tela perguntando se você deseja adicioná-los. Clique na notificação para revisar e confirmar.

    Limitação: A detecção automática funciona melhor na Ethereum Mainnet. Em outras redes (BSC, Polygon, Arbitrum), você ainda pode precisar adicionar tokens manualmente.


    Método 2: Adicionar Token Manualmente por Endereço de Contrato

    Para qualquer token não detectado automaticamente, você pode adicioná-lo manualmente usando o endereço do contrato. Cada token ERC-20 possui um endereço de contrato único — uma string de 42 caracteres começando com 0x.

    Passo a Passo: Adicionar Token Manualmente

    • Abra o MetaMask e certifique-se de estar na rede correta
  • Role para baixo na tela principal e clique em Importar tokens
  • Selecione a aba Token personalizado
  • Digite o Endereço de contrato do token no primeiro campo
    • O MetaMask preencherá automaticamente o símbolo do token e as casas decimais
    • Verifique se o símbolo corresponde ao que você espera
  • Clique em Adicionar token personalizado
  • Clique em Importar tokens na tela de confirmação
  • O token agora aparece no seu saldo do MetaMask. Se você possuir algum, o valor será exibido imediatamente.


    Como Encontrar o Endereço de Contrato de um Token

    Obter o endereço de contrato correto é essencial — existem tokens falsos com nomes e símbolos idênticos. Sempre verifique o endereço do contrato a partir de uma fonte confiável.

    Método A: CoinGecko

  • Acesse coingecko.com
    • Procure o token pelo nome
  • Na página do token, role para baixo até Contrato ou procure na seção Informações
    • Clique no ícone da corrente para selecionar a rede correta (Ethereum, BSC, etc.)
    • Copie o endereço do contrato exibido

    Método B: CoinMarketCap

  • Acesse coinmarketcap.com
    • Procure o token
  • Na página do token, role até Contratos
    • Selecione a rede e copie o endereço

    Método C: Etherscan (para tokens Ethereum)

  • Acesse etherscan.io
    • Procure o nome do token
    • Clique no contrato do token verificado
    • Copie o endereço do contrato no topo da página do contrato

    Método D: Site Oficial do Projeto

    Muitos projetos de criptografia listam o endereço do contrato do token de forma destacada em seu site ou documentação oficial. Sempre use o site oficial — não links de mídia social.


    Adicionando Tokens em Diferentes Redes

    O MetaMask oferece suporte a várias redes, e o mesmo token em diferentes redes possui um endereço de contrato diferente. Certifique-se de estar na rede correta antes de adicionar.

    Ethereum Mainnet

    A maioria dos tokens ERC-20 fica aqui. Exemplos comuns: USDC, USDT, LINK, UNI, AAVE.

    BNB Smart Chain (BSC)

    Os tokens BSC seguem o padrão BEP-20. Adicione a rede BSC primeiro e depois adicione os tokens. Tokens BSC populares: CAKE (PancakeSwap), BUSD.

    Configurações da rede BSC:

    • Nome da rede: BNB Smart Chain
    • URL RPC: https://bsc-dataseed.binance.org/
    • ID da cadeia: 56
    • Símbolo: BNB
    • Explorador: https://bscscan.com

    Polygon (MATIC)

    O Polygon possui suas próprias versões de muitos tokens, incluindo USDC, USDT e WETH com bridge. Adicione a rede Polygon primeiro.

    Configurações da rede Polygon:

    • Nome da rede: Polygon Mainnet
    • URL RPC: https://polygon-rpc.com/
    • ID da cadeia: 137
    • Símbolo: MATIC
    • Explorador: https://polygonscan.com

    Arbitrum One

    Tokens da camada 2 no Arbitrum. ID da cadeia: 42161.

    Optimism

    Camada 2 no Ethereum. ID da cadeia: 10.


    Tabela de Referência de Tokens por Rede

    Token Endereço Ethereum Nota
    USDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 Stablecoin da Circle
    USDT 0xdAC17F958D2ee523a2206206994597C13D831ec7 Tether
    LINK 0x514910771AF9Ca656af840dff83E8264EcF986CA Chainlink
    UNI 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 Uniswap
    WETH 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 Ether Encapsulado

    Sempre verifique esses endereços no Etherscan antes de usar — use-os como pontos de partida para sua própria verificação, não como fontes definitivas.


    Aviso sobre Tokens Falsos

    O maior risco ao adicionar tokens manualmente é adicionar um token falso. Golpistas criam tokens com o mesmo nome e símbolo que tokens populares. Se você adicionar o endereço de contrato errado, poderá ver um saldo falso que você realmente não pode vender ou usar.

    Como identificar tokens falsos:

    • O endereço do contrato não corresponde a nenhuma fonte confiável
    • O contrato do token foi criado recentemente sem histórico
    • O Etherscan mostra o contrato como não verificado ou exibe avisos
    • Você recebeu os tokens inesperadamente (golpe de airdrop)
    • Quando você tenta vendê-los, a transação falha ou pede aprovações excessivas

    O que fazer com tokens suspeitos:

    • Não tente vendê-los ou interagir com eles
    • Não clique em links associados a airdrops inesperados
    • Simplesmente ignore-os — ter um token falso em sua carteira é inofensivo desde que você não interaja com ele
  • Você pode ocultá-los no MetaMask clicando nos três pontos ao lado do token e selecionando Ocultar

  • Lista de Tokens do MetaMask (Tokenlist)

    O MetaMask usa listas de tokens mantidas pela comunidade para alimentar seus recursos de detecção automática e busca. Essas listas são curadas por projetos como Uniswap, Aave e outros. Quando você pesquisa um token na barra de busca Adicionar token do MetaMask, você está pesquisando essas listas.

    Se um token não estiver em nenhuma lista, ele não aparecerá nos resultados da busca — mas você ainda pode adicioná-lo manualmente com o endereço do contrato.


    Perguntas Frequentes

    Adicionei um token mas o saldo aparece como 0 — por quê?

    Você pode não possuir realmente nenhum desse token. Adicionar um token ao MetaMask apenas diz ao MetaMask para exibir o saldo — não cria tokens. Verifique seu endereço no Etherscan para confirmar se você possui algum.

    Posso adicionar tokens em testnets?

    Sim. Mude para a testnet (por exemplo, Sepolia) e adicione o endereço do contrato do token nessa testnet. Os tokens de testnet têm endereços de contrato separados da mainnet.

    Por que o MetaMask mostra o símbolo do token incorreto após eu inserir um endereço de contrato?

    Alguns contratos são configurados com símbolos incomuns ou enganosos. Verifique novamente o endereço do contrato no Etherscan para ter certeza de que ele corresponde ao token que você pretendia adicionar.

    Posso adicionar NFTs ao MetaMask?

    O MetaMask possui exibição básica de NFT. Vá para a aba NFTs e clique em Importar NFTs, depois digite o endereço do contrato e o ID do token. O gerenciamento mais avançado de NFT é melhor feito em aplicativos dedicados como OpenSea ou Rainbow.

    Como faço para remover um token que adicionei por engano?

    No desktop: Clique nos três pontos ao lado do token → Ocultar token. No celular: Pressione longamente o token → Ocultar. Isso o remove da visualização, mas não afeta a blockchain — seus tokens ainda estão lá.

    Preciso adicionar o ETH em si como um token?

    Não. ETH (e o token nativo de qualquer rede) é exibido automaticamente. Você só precisa adicionar tokens ERC-20.


    Guias relacionados:

  • Como Adicionar Avalanche (AVAX) ao MetaMask
  • Como Adicionar Arbitrum ao MetaMask
  • Como Adicionar Optimism ao MetaMask
  • Guia de Segurança do MetaMask: 10 Maneiras de Se Manter Seguro

  • Publicado

    em

    ,

    por