Skip to main content
GET
/
v2
/
{chain_name}
/
blocks
/
by-timestamp
/
{timestamp}
Lookup Block By Timestamp
curl --request GET \
  --url https://api.data.ormilabs.com/v2/{chain_name}/blocks/by-timestamp/{timestamp} \
  --header 'Authorization: Bearer <token>'
{
  "block": {
    "base_fee_per_gas": "10000000000",
    "difficulty": "0",
    "extra_data": "0x...",
    "gas_limit": "30000000",
    "gas_used": "15000000",
    "hash": "0x2c9759ce3126199512631f50cb01e40717c880cb094a8974f62f100978fe7071",
    "logs_bloom": "0x000...",
    "miner": "0x312e67b47a2a29ae200184949093d92369f80b53",
    "nonce": "0x0000000000000000",
    "number": 18000000,
    "parent_hash": "0x2c9759ce3126199512631f50cb01e40717c880cb094a8974f62f100978fe7071",
    "receipt_root": "0x...",
    "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": 100000,
    "state_root": "0x...",
    "timestamp": "2023-11-07T05:31:56Z",
    "total_difficulty": "58750003716598352816469",
    "transaction_count": 150,
    "transactions_root": "0x...",
    "withdrawals_root": "0x..."
  }
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

Enter your API key in the format: Bearer <api_key>. Providing an API key may grant higher rate limits or access to additional features. The API will function without an API key for basic access.

Path Parameters

​
timestamp
string<date-time>
required

The Unix timestamp or ISO 8601 date string for block lookup.

Example:

"2023-11-07T05:31:56Z"

​
chain_name
enum<string>
required

The name or ID of the blockchain.

Available options:
ethereum,
apechain,
arbitrum,
avalanche,
base,
bsc,
polygon
Example:

"ethereum"

Query Parameters

​
lookup_direction
enum<string>
default:before

Direction to look for the block relative to the timestamp.

Available options:
before,
after

Response

Successfully retrieved block details by timestamp.

​
block
object
required