Tokens

Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the PolygonScan APIs page.

Get ERC-20 Token TotalSupply by ContractAddress

Returns the total supply of a ERC-20 token.

https://api.polygonscan.com/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0x7ceb23fd6bc0add59e62ac25578270cff1b9f619
   &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":"476738052697606400198601"
}

📈 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.polygonscan.com/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0x8a953cfe442c5e8855cc6c61b1293fa648bae472
   &address=0xe04c9c8b5939fb0bb2ce58573fa4fa0411093506
   &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":"46845461145279332930893089378"
}

📈 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.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

Get Historical ERC-20 Token Account Balance by ContractAddress & BlockNo

Returns the balance of a 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.polygonscan.com/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x831753dd7087cac61ab5644b308642cc1c33dc13
   &address=0x019ba0325f1988213d448b3472fa1cf8d07618d7
   &blockno=20169066
   &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 balance
blockno	the integer block number to check total supply for eg. 400000

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":"21475814538620954598134"
}

📈 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.

https://api.polygonscan.com/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contractaddress	the contract address of the ERC-20/ERC-721 token to retrieve token info

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "contractAddress":"0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",
         "tokenName":"ChainLink Token",
         "symbol":"LINK",
         "divisor":"18",
         "tokenType":"ERC20",
         "totalSupply":"1573879.616930000000000000",
         "blueCheckmark":"true",
         "description":"A blockchain-based middleware, acting as a bridge between cryptocurrency smart contracts, data feeds, APIs and traditional bank account payments.",
         "website":"https://chain.link/",
         "email":"[e-mail]",
         "blog":"",
         "reddit":"",
         "slack":"",
         "facebook":"",
         "twitter":"https://twitter.com/chainlink",
         "bitcointalk":"",
         "github":"",
         "telegram":"",
         "wechat":"",
         "linkedin":"",
         "discord":"",
         "whitepaper":"https://link.smartcontract.com/whitepaper",
         "tokenPriceUSD":"24.5400000000"
      }
   ]
}