Blocks

Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the Apescan APIs page.

Get Block And Uncle Rewards by BlockNo

Returns the block reward and 'Uncle' block rewards.

https://api.apescan.io/api
   ?module=block
   &action=getblockreward
   &blockno=100
   &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": "100",
    "timeStamp": "1724986802",
    "blockMiner": "0xa4b000000000000000000073657175656e636572",
    "blockReward": "0",
    "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.apescan.io/api
   ?module=block
   &action=getblockcountdown
   &blockno=300000
   &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": "22353",
    "CountdownBlock": "300000",
    "RemainingBlock": "277647",
    "EstimateTimeInSec": "17491776.0"
  }
}

Get Block Number by Timestamp

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

https://api.apescan.io/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1726040368
   &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": "22353"
}