API PRO Endpoints

The following is a complete list of additional API endpoints available under the API PRO subscription.

To upgrade your API plan, kindly visit PolygonScan APIs.

Get Historical MATIC Balance for a Single Address by BlockNo

Returns the historical MATIC balance 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=balancehistory
   &address=0x23eA5Ec7Ea2d4282012313c9899Cdc07bd45243d
   &blockno=18798641
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the strings representing the addresses to check for balance, separated by , commas
blockno	the integer block number to check balance for eg. 2000000

Response

Sample Response

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

📖 Tip: The result is returned in wei.

Convert MATIC units using our Unit Converter.

Get Daily Average Block Size

Returns the daily average block size within a date range.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-08-01",
         "unixTimeStamp":"1627776000",
         "blockSize_bytes":65856
      },
      {
         "UTCDate":"2021-08-02",
         "unixTimeStamp":"1627862400",
         "blockSize_bytes":62925
      },
      {
         "UTCDate":"2021-08-03",
         "unixTimeStamp":"1627948800",
         "blockSize_bytes":63967
      },
      {
         "UTCDate":"2021-08-04",
         "unixTimeStamp":"1628035200",
         "blockSize_bytes":59825
      }
   ]
}

Get Daily Block Count and Rewards

Returns the number of blocks validated daily and the amount of block rewards.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "blockCount":38385,
          "blockRewards_Eth":"13512.99629741489684839"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "blockCount":36898,
          "blockRewards_Eth":"10415.4627450065115572"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "blockCount":39485,
          "blockRewards_Eth":"21340.315061898381392963"
       },
       {
          "UTCDate":"2021-08-04",
          "unixTimeStamp":"1628035200",
          "blockCount":37536,
          "blockRewards_Eth":"12519.334060666034768668"
       }
    ]
 }

Get Daily Block Rewards

Returns the amount of block rewards distributed to validators daily.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "blockRewards_Eth":"0"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "blockRewards_Eth":"0"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "blockRewards_Eth":"0"
       }
    ]
 }

Get Daily Average Time for A Block to be Included in the Polygon POS Chain

Returns the daily average of time needed for a block to be successfully validated.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "blockTime_sec":"2.26"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "blockTime_sec":"2.36"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "blockTime_sec":"2.19"
       }
    ]
 }

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"
      }
   ]
}

Get Daily Average Gas Limit

Returns the historical daily average gas limit of the Polygon network.

 https://api.polygonscan.com/api
    ?module=stats
    &action=dailyavggaslimit
    &startdate=2021-02-01
    &enddate=2021-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2019-01-31
enddate	the ending date in yyyy-MM-dd format, eg. 2019-02-28
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-02-01",
         "unixTimeStamp":"1612137600",
         "gasLimit":"19995225"
      },
      {
         "UTCDate":"2021-02-02",
         "unixTimeStamp":"1612224000",
         "gasLimit":"19992137"
      },
      {
         "UTCDate":"2021-02-03",
         "unixTimeStamp":"1612310400",
         "gasLimit":"19994117"
      }
   ]
}

Get Polygon Daily Total Gas Used

Returns the total amount of gas used daily for transactions on the Polygon network.

 https://api.polygonscan.com/api
    ?module=stats
    &action=dailygasused
    &startdate=2021-02-01
    &enddate=2021-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2019-01-31
enddate	the ending date in yyyy-MM-dd format, eg. 2019-02-28
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-02-01",
         "unixTimeStamp":"1612137600",
         "gasUsed":"15209687825"
      },
      {
         "UTCDate":"2021-02-02",
         "unixTimeStamp":"1612224000",
         "gasUsed":"15486974769"
      },
      {
         "UTCDate":"2021-02-03",
         "unixTimeStamp":"1612310400",
         "gasUsed":"14214840593"
      }
   ]
}

Get Daily Average Gas Price

Returns the daily average gas price used on the Polygon network.

 https://api.polygonscan.com/api
    ?module=stats
    &action=dailyavggasprice
    &startdate=2021-02-01
    &enddate=2021-02-28
    &sort=asc
    &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2019-01-31
enddate	the ending date in yyyy-MM-dd format, eg. 2019-02-28
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2021-02-01",
         "unixTimeStamp":"1612137600",
         "maxGasPrice_Wei":"243000000000",
         "minGasPrice_Wei":"1000000000",
         "avgGasPrice_Wei":"2565412962"
      },
      {
         "UTCDate":"2021-02-02",
         "unixTimeStamp":"1612224000",
         "maxGasPrice_Wei":"338000000000",
         "minGasPrice_Wei":"1000000000",
         "avgGasPrice_Wei":"2815449842"
      },
      {
         "UTCDate":"2021-02-03",
         "unixTimeStamp":"1612310400",
         "maxGasPrice_Wei":"328000000000",
         "minGasPrice_Wei":"1000000000",
         "avgGasPrice_Wei":"3135220373"
      }
   ]
}

Get MATIC Historical Price

Returns the historical price of 1 MATIC.

https://api.polygonscan.com/api
   ?module=stats
   &action=ethdailyprice
   &startdate=2021-08-01
   &enddate=2021-08-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-08-28
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-08-01",
          "unixTimeStamp":"1627776000",
          "value":"1.05"
       },
       {
          "UTCDate":"2021-08-02",
          "unixTimeStamp":"1627862400",
          "value":"1.05"
       },
       {
          "UTCDate":"2021-08-03",
          "unixTimeStamp":"1627948800",
          "value":"1.02"
       }
    ]
 }

💰 Tip : The value is represented in US Dollars ( USD ).

Get Daily Network Transaction Fee

Returns the historical amount of transaction fees paid to validators per day.

https://api.polygonscan.com/api?
   module=stats
   &action=dailytxnfee
   &startdate=2020-10-01
   &enddate=2020-10-31
   &sort=asc
   &apikey=YourApiKeyToken 

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2020-10-01
enddate	the ending date in yyyy-MM-dd format, eg. 2020-10-31
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2020-10-01",
          "unixTimeStamp":"1601510400",
          "transactionFee_Eth":"14.25013925284"
       },
       {
          "UTCDate":"2020-10-02",
          "unixTimeStamp":"1601596800",
          "transactionFee_Eth":"12.01774328819"
       },
       {
          "UTCDate":"2020-10-03",
          "unixTimeStamp":"1601683200",
          "transactionFee_Eth":"12.13871641757844851"
       }
    ]
 }

Get Daily New Address Count

Returns the historical number of new Polygon POS Chain addresses created per day.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailynewaddress
   &startdate=2020-10-01
   &enddate=2020-10-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2020-10-01
enddate	the ending date in yyyy-MM-dd format, eg. 2020-10-31
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2020-10-01",
          "unixTimeStamp":"1601510400",
          "newAddressCount":2131
       },
       {
          "UTCDate":"2020-10-02",
          "unixTimeStamp":"1601596800",
          "newAddressCount":1405
       },
       {
          "UTCDate":"2020-10-03",
          "unixTimeStamp":"1601683200",
          "newAddressCount":124
       }
    ]
 }

Get Daily Network Utilization

Returns the daily average gas used over gas limit percentage.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailynetutilization
   &startdate=2021-07-01
   &enddate=2021-07-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-07-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-07-28
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-07-01",
          "unixTimeStamp":"1625097600",
          "networkUtilization":"0.8838"
       },
       {
          "UTCDate":"2021-07-02",
          "unixTimeStamp":"1625184000",
          "networkUtilization":"0.7714"
       },
       {
          "UTCDate":"2021-07-03",
          "unixTimeStamp":"1625270400",
          "networkUtilization":"0.7928"
       }
    ]
 }

Get Daily Transaction Count

Returns the number of transactions performed on the Polygon POS Chain per day.

https://api.polygonscan.com/api
   ?module=stats
   &action=dailytx
   &startdate=2021-07-01
   &enddate=2021-07-31
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
startdate	the starting date in yyyy-MM-dd format, eg. 2021-07-01
enddate	the ending date in yyyy-MM-dd format, eg. 2021-07-28
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

Sample Response

{
    "status":"1",
    "message":"OK",
    "result":[
       {
          "UTCDate":"2021-07-01",
          "unixTimeStamp":"1625097600",
          "transactionCount":8228730
       },
       {
          "UTCDate":"2021-07-02",
          "unixTimeStamp":"1625184000",
          "transactionCount":5954493
       },
       {
          "UTCDate":"2021-07-03",
          "unixTimeStamp":"1625270400",
          "transactionCount":6247611
       }
    ]
 }