Skip to main content
GET
/
{chain_id}
/
api
/
v2
/
blocks
/
{block_number_param}
/
countdown
Get countdown information for a target block number
curl --request GET \
  --url https://api.blockscout.com/{chain_id}/api/v2/blocks/{block_number_param}/countdown \
  --header 'Authorization: Bearer <token>'
{
  "countdown_block": 22600000,
  "current_block": 22566361,
  "estimated_time_in_sec": 404868,
  "remaining_blocks": 33639
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Path Parameters

​
block_number_param
integer
required

Block number in the path

Required range: x >= 0
​
chain_id
string
required

The ID of the blockchain

Response

Block countdown information.

Block countdown information showing estimated time until a target block is reached

​
countdown_block
integer
required

The target block number for the countdown

Required range: x >= 0
Example:

22600000

​
current_block
integer
required

The current highest block number in the blockchain

Required range: x >= 0
Example:

22566361

​
estimated_time_in_sec
number<float>
required

Estimated time in seconds until the target block is reached

Required range: x >= 0
Example:

404868

​
remaining_blocks
integer
required

Number of blocks remaining until the target block is reached

Required range: x >= 0
Example:

33639