Blocks

Get Block Rewards by BlockNo

Returns the block reward.

https://api.taikoscan.io/api
   ?module=block
   &action=getblockreward
   &blockno=756
   &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-Missing/Invalid API Key, rate limit of 1/5sec applied",
  "result": {
    "blockNumber": "756",
    "timeStamp": "1716826187",
    "blockMiner": "0x000000633b68f5d8d3a86593ebb815b4663bcbe0",
    "blockReward": "6669096857188364",
    "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.taikoscan.io/api
   ?module=block
   &action=getblockcountdown
   &blockno=1000
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

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

Response

Sample Response

{
  "status": "1",
  "message": "OK-Missing/Invalid API Key, rate limit of 1/5sec applied",
  "result": {
    "CurrentBlock": "760",
    "CountdownBlock": "1000",
    "RemainingBlock": "240",
    "EstimateTimeInSec": "82407687.0"
  }
}

Get Block Number by Timestamp

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

https://api.taikoscan.io/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1716826187
   &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-Missing/Invalid API Key, rate limit of 1/5sec applied",
  "result": "756"
}