Blocks

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

Get Block Rewards by BlockNo

Returns the block reward awarded for validating a certain block.

https://api.polygonscan.com/api
   ?module=block
   &action=getblockreward
   &blockno=2170000
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
blockno	the integer block number to check block rewards for eg. 12697906

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "blockNumber":"2170000",
      "timeStamp":"1605182836",
      "blockMiner":"0x68bf0b8b6fb4e317a0f9d6f03eaf8ce6675bc60d",
      "blockReward":"13657915000000000",
      "uncles":[

      ],
      "uncleInclusionReward":"0"
   }
}

​​ ⏳ Tip : The timestamp field is denoted in Unix timestamp.

Get Estimated Block Countdown Time by BlockNo

Returns the estimated time remaining, in seconds, until a certain block is validated.

https://api.polygonscan.com/api
   ?module=block
   &action=getblockcountdown
   &blockno=24926850
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
blockno	the integer block number to estimate time remaining to be validated eg. 12697906

Response

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":{
      "CurrentBlock":"10526852",
      "CountdownBlock":"10926850",
      "RemainingBlock":"399998",
      "EstimateTimeInSec":"1240008.8"
   }
}

Get Block Number by Timestamp

Returns the block number that was validated at a certain timestamp.

https://api.polygonscan.com/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1601510400
   &closest=before
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
timestamp	the integer representing the Unix timestamp in seconds.
closest	the closest available block to the provided timestamp, either before or after

⏳ Tip : Convert a regular date-time to a Unix timestamp.

Response

Sample Response

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

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