Skip to main content
GET
/
v2
/
blocks
/
{block_number_param}
/
countdown
Get countdown information for a target block number
curl --request GET \
  --url http://localhost/api/v2/blocks/{block_number_param}/countdown
{
  "countdown_block": 22600000,
  "current_block": 22566361,
  "estimated_time_in_sec": 404868,
  "remaining_blocks": 33639
}

Documentation Index

Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
block_number_param
integer
required

Block number in the path

Required range: x >= 0

Query Parameters

​
apikey
string

API key for rate limiting or for sensitive endpoints

​
key
string

Secret key for getting access to restricted resources

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