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

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token

Response

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

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20 token
address	the string representing the address to check for token balance

Response

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

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

Response

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