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!
Last modified 7d ago