Tokens
Endpoints with
are under the API Pro subscription. To upgrade your API plan, browse through the Etherscan APIs page.
Returns the current amount of an ERC-20 token in circulation.
https://api.etherscan.io/api
?module=stats
&action=tokensupply
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
contractaddress | the contract address of the ERC-20 token |
Sample Response
{
"status":"1",
"message":"OK",
"result":"21265524714464"
}
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
Returns the current balance of an ERC-20 token of an address.
https://api.etherscan.io/api
?module=account
&action=tokenbalance
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
&tag=latest&apikey=YourApiKeyToken
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
{
"status":"1",
"message":"OK",
"result":"135499"
}
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
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.
📝
https://api.etherscan.io/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&blockno=8000000
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
---|---|
contractaddress | the contract address of the ERC-20 token |
blockno |
Sample Response
{
"status":"1",
"message":"OK",
"result":"21265524714464"
}
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
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.
📝
https://api.etherscan.io/api
?module=account
&action=tokenbalancehistory
&contractaddress=0x57d90b64a1a57749b0f932f1a3395792e12e7055
&address=0xe04f27eb70e025b78871a2ad7eabe85e61212761
&blockno=8000000
&apikey=YourApiKeyToken
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 |
Sample Response
{
"status":"1",
"message":"OK",
"result":"135499"
}
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
Return the current ERC20 token holders and number of tokens held.
https://api.etherscan.io/api
?module=token
&action=tokenholderlist
&contractaddress=0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d
&page=1
&offset=10
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
contractaddress | the contract address of the ERC-20 token |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"TokenHolderAddress":"0x0000000000000000000000000000000000000000",
"TokenHolderQuantity":"34956"
},
{
"TokenHolderAddress":"0x000000000000084e91743124a982076c59f10084",
"TokenHolderQuantity":"1"
},
{
"TokenHolderAddress":"0x0000000000000d9054f605ca65a2647c2b521422",
"TokenHolderQuantity":"10000000"
},
{
"TokenHolderAddress":"0x0000000000002d534ff79e9c69e7fcc742f0be83",
"TokenHolderQuantity":"5"
},
{
"TokenHolderAddress":"0x0000000000003f5e74c1ba8a66b48e6f3d71ae82",
"TokenHolderQuantity":"1"
}
]
}
Returns project information and social media links of an ERC20/ERC721/ERC1155 token.