Links

Blocks

Get Block Rewards by BlockNo

Returns the block reward awarded for validating a certain block.
https://api-testnet.polygonscan.com/api
?module=block
&action=getblockreward
&blockno=20175729
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
blockno
the integer block number to check block rewards for eg. 12697906
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"blockNumber":"20175729",
"timeStamp":"1634228751",
"blockMiner":"0xe4b8e9222704401ad16d4d826732953daf07c7e2",
"blockReward":"8922747000000000",
"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-testnet.polygonscan.com/api
?module=block
&action=getblockcountdown
&blockno=23926850
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
Query Parameters
Parameter
Description
blockno
the integer block number to estimate time remaining to be validated eg. 12697906
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"CurrentBlock":"20175836",
"CountdownBlock":"23926850",
"RemainingBlock":"3751014",
"EstimateTimeInSec":"7877144.4"
}
}

Get Block Number by Timestamp

Returns the block number that was validated at a certain timestamp.
https://api-testnet.polygonscan.com/api
?module=block
&action=getblocknobytime
&timestamp=1601510400
&closest=before
&apikey=YourApiKeyToken
Try this endpoint in your browser
🔗
Request
Response
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.
Sample Response
{
"status":"1",
"message":"OK",
"result":"4940058"
}