Tokens

Endpoints with 
 are under the API Pro subscription. To upgrade your API plan, browse through the Etherscan APIs page.
Get ERC20-Token TotalSupply by ContractAddress
Returns the current amount of an ERC-20 token in circulation.
1
https://api.etherscan.io/api
2
   ?module=stats
3
   &action=tokensupply
4
   &contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
5
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":"21265524714464"
5
}
Copied!
​📈
 Tip : The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Get ERC20-Token Account Balance for TokenContractAddress
Returns the current balance of an ERC-20 token of an address.
1
https://api.etherscan.io/api
2
   ?module=account
3
   &action=tokenbalance
4
   &contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
5
   &address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
6
   &tag=latest&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
address
the string representing the address to check for token balance
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":"135499"
5
}
Copied!
​📈
 Tip : The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo 
​
Returns the amount of an ERC-20 token in circulation at a certain block height.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.etherscan.io/api
2
   ?module=stats
3
   &action=tokensupplyhistory
4
   &contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
5
   &blockno=8000000
6
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
blockno
the integer block number to check total supply for eg. 12697906​
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":"21265524714464"
5
}
Copied!
​📈
 Tip : The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo 
​
Returns the balance of an ERC-20 token of an address at a certain block height.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.etherscan.io/api
2
   ?module=account
3
   &action=tokenbalancehistory
4
   &contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
5
   &address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
6
   &blockno=8000000
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
address
the string representing the address to check for balance
blockno
the integer block number to check total supply for eg. 12697906​
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":"135499"
5
}
Copied!
​📈
 Tip : The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Get Token Info by ContractAddress 
​
Returns project information and social media links of an ERC-20/ERC-721 token.
📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.etherscan.io/api
2
   ?module=token
3
   &action=tokeninfo
4
   &contractaddress=0x0e3a2a1f2146d86a604adc220b4967a898d7fe07
5
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20/ERC-721 token to retrieve token info
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "contractAddress":"0x0e3a2a1f2146d86a604adc220b4967a898d7fe07",
7
         "tokenName":"Gods Unchained Cards",
8
         "symbol":"CARD",
9
         "divisor":"0",
10
         "tokenType":"ERC721",
11
         "totalSupply":"6962498",
12
         "blueCheckmark":"true",
13
         "description":"A TCG on the Ethereum blockchain that uses NFT's to bring real ownership to in-game assets.",
14
         "website":"https://godsunchained.com/",
15
         "email":"",
16
         "blog":"https://medium.com/@fuelgames",
17
         "reddit":"https://www.reddit.com/r/GodsUnchained/",
18
         "slack":"",
19
         "facebook":"https://www.facebook.com/godsunchained/",
20
         "twitter":"https://twitter.com/godsunchained",
21
         "bitcointalk":"",
22
         "github":"",
23
         "telegram":"",
24
         "wechat":"",
25
         "linkedin":"",
26
         "discord":"https://discordapp.com/invite/DKGr2pW",
27
         "whitepaper":"",
28
         "tokenPriceUSD":"0.000000000000000000"
29
      }
30
   ]
31
}
Copied!