How to find a token contract address

Depending on the method you use, finding a token contract address is one step in the process of adding a custom token to MetaMask. To find out more about adding tokens, head to our article on the subject to see several different methods. 

What is a token address? 

As you may be aware, tokens on Ethereum mainnet generally conform to the ERC-20 standard. This is a set of requirements for any fungible token on Ethereum -- meaning one token has to have an identical value as other tokens of the same type, just like how one US dollar = one US dollar. The ERC-20 standard makes it considerably easier for wallets such as MetaMask, dapps, and other platforms to integrate existing and new tokens into their functions. For example, you can add any ERC-20 token to MetaMask. This wouldn't be possible if they didn't all adhere to the same standard.

Every ERC-20 token is essentially created by inputting some details into a template smart contract which then controls and manages the token. In addition to basic functions such as the symbol and name, token creators must also determine total supply and methods for managing the balances of all token holders -- one of its core responsibilites. 

When the originator first deploys the token's contract on the network, an address is generated that looks similar to the public addresses of Ethereum accounts. This is because the same cryptographic method is used in both situations (with slight nuances). 

Think of it this way: if you want to send or receive from your account, you'd use your public address. Similarly, if you want to send or receive a specific ERC-20 token, you have to do it via the token's address.

ERC-20 on other networks

Outside of Ethereum mainnet, ERC-20 tokens are handled differently depending on the network you're using, and it can quickly get confusing.

Some networks have their own, parallel token standards which essentially equate to ERC-20. BNB Chain/BSC and its BEP-20 standard is the most prominent example. The equivalence between the two standard means ERC-20 tokens on Ethereum and BEP-20 tokens on BNB Chain are interchangeable. If you transfer 10 ERC-20 tokens to a wallet on BNB Chain, you'll have 10 of the same token on BNB Chain, but in BEP-20 form and 'pegged' to the value of the ERC-20 original.

In other cases, such as Polygon, you can simply use the Polygon bridge (available here once you connect a wallet) to move tokens across, provided there are smart contracts deployed on both networks. 

If you want to move ERC-20 tokens across different networks, always do your research to make sure you don't lose funds, and consider using test transactions before sending large sums.

Where do I find a token's contract address?

There are two main ways to do this:

Block explorer Token listing site

Block explorers such as Etherscan, BscScan, or Polygonscan hold data on ERC-20 tokens and their equivalents on their respective networks.

To find a token contract address, simply head to the block explorer and search for your desired token. The contract address will be clearly indicated on its page. See below for an example from Etherscan:

Screen_Shot_2021-04-12_at_9.38.19_AM.png

On a desktop browser, you will see the copy to clipboard icon appear when you mouse over. On mobile, it should already be visible (though please note the exact presentation of the contract address will vary depending on the block explorer you're using). 

mceclip0.png

Most block explorers have a similar format, and all provide information in the same categories -- just specific to their network.

They will also display the same information on a mobile browser as they do on desktop -- so this method applies equally to both MetaMask Extension and Mobile users.

 

Once you have the token contract address, you're ready to add the token to MetaMask. Head to our article on this for more information. 

Was this article helpful?
199 out of 328 found this helpful

Articles in this section