Blocks

Get Block And Uncle Rewards by BlockNo

Returns the block reward and 'Uncle' block rewards.
https://api-rinkeby.etherscan.io/api
?module=block
&action=getblockreward
&blockno=9548666
&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":"9548666",
"timeStamp":"1635490259",
"blockMiner":"0x7ffc57839b00206d1ad20c69a1981b489f772031",
"blockReward":"17546299999521548",
"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 mined.
https://api-rinkeby.etherscan.io/api
?module=block
&action=getblockcountdown
&blockno=9588666
&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 mined eg. 12697906
Sample Response
{
"status":"1",
"message":"OK",
"result":{
"CurrentBlock":"9548810",
"CountdownBlock":"9588666",
"RemainingBlock":"39856",
"EstimateTimeInSec":"577927.0"
}
}

Get Block Number by Timestamp

Returns the block number that was mined at a certain timestamp.
https://api-rinkeby.etherscan.io/api
?module=block
&action=getblocknobytime
&timestamp=1635492527
&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":"9548817"
}