Get Block Number by Timestamp

Returns the block number that was mined at a certain timestamp

GET /?module=block&action=getblocknobytime

Get Block Number by Timestamp

cURL

curl --request GET \
  --url 'https://eth.blockscout.com/api/?module=block&action=getblocknobytime'

200

{
  "status": "1",
  "message": "OK",
  "result": {
    "blockNumber": "<string>"
  }
}

Query Parameters

module · enum<string> · required

Module name (must be 'block')

Available options: block

action · enum<string> · required

Available options: getblocknobytime

timestamp · integer · required

Unix timestamp

closest · enum<string> · required

Direction to search (before or after timestamp)

Available options: before, after

Response

200 - application/json

Block number retrieved successfully

Option 1

Option 2

status · enum<string>

Status code (1 = OK)

Available options: 1

message · string

Response message

Example:

"OK"

result · object

Show child attributes