Links

Blocks

Get Block Rewards by BlockNo

Returns the block reward awarded for validating a certain block.
https://api-zkevm.polygonscan.com/api
?module=block
&action=getblockreward
&blockno=400172
&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": "400172",
"timeStamp": "1684985408",
"blockMiner": "0x148ee7daf16574cd020afa34cc658f8f3fbd2800",
"blockReward": "199760990000000",
"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-zkevm.polygonscan.com/api
?module=block
&action=getblockcountdown
&blockno=1000172
&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": "400211",
"CountdownBlock": "1000172",
"RemainingBlock": "599961",
"EstimateTimeInSec": "2939823.9"
}
}1000172

Get Block Number by Timestamp

Returns the block number that was validated at a certain timestamp.
https://api-zkevm.polygonscan.com/api
?module=block
&action=getblocknobytime
&timestamp=1684985741
&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": "400237"
}