Links

Tokens

Get ERC-20 Token TotalSupply by ContractAddress

Returns the total supply of a ERC-20 token.
https://api-zkevm.polygonscan.com/api
?module=stats
&action=tokensupply
&contractaddress=0x90cc6C10C7211844c66640b4d01486cb45E0F3E8
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the ERC-20 token
Sample Response
{
"status": "1",
"message": "OK",
"result": "21000000000000000000000000"
}
📈
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 ERC-20 Token Account Balance by ContractAddress

Returns the current balance of a ERC-20 token of an address.
https://api-zkevm.polygonscan.com/api
?module=account
&action=tokenbalance
&contractaddress=0x90cc6C10C7211844c66640b4d01486cb45E0F3E8
&address=0x808081269906e0e01285ed9c3525c67e09811860
&tag=latest
&apikey=YourApiKeyToken
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
{
"status": "1",
"message": "OK",
"result": "21000000000000000000000000"
}
📈
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 ERC-20 Token TotalSupply by ContractAddress & BlockNo

Returns the historical amount of a 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-zkevm.polygonscan.com/api
?module=stats
&action=tokensupplyhistory
&contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
&blockno=20071631
&apikey=YourApiKeyToken
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. 4000000
Sample Response
{
"status":"1",
"message":"OK",
"result":"951911913447326414573422"
}
📈
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