Blocks

Get Block And Uncle Rewards by BlockNo
Returns the block reward and 'Uncle' block rewards.
https://api-ropsten.etherscan.io/api
   ?module=block
   &action=getblockreward
   &blockno=11275005
   &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":"11275005",
      "timeStamp":"1634837942",
      "blockMiner":"0xe9e7034aed5ce7f5b0d281cfe347b8a5c2c53504",
      "blockReward":"2221181611857171000",
      "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-ropsten.etherscan.io/api
   ?module=block
   &action=getblockcountdown
   &blockno=11375005
   &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":"11275012",
      "CountdownBlock":"11375005",
      "RemainingBlock":"99993",
      "EstimateTimeInSec":"1119936.6"
   }
}
Get Block Number by Timestamp
Returns the block number that was mined at a certain timestamp.
https://api-ropsten.etherscan.io/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1634838142
   &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":"11275018"
}

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

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

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

Last modified 1yr ago