Skip to main content
GET
/
v2
/
{chain_name}
/
blocks
Get Blocks
curl --request GET \
  --url https://api.data.ormilabs.com/v2/{chain_name}/blocks \
  --header 'Authorization: Bearer <token>'
{
  "next_cursor": "ICJkYXNkYXMifQ==",
  "blocks": [
    {
      "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..."
    }
  ]
}

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

​
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

​
numbers
integer[]

Comma-separated list of block numbers to fetch blocks for.

Maximum length: 1000
​
window
string

Specifies time or block range for the query. The format can be a relative duration like 30d or 12h. Or interval of time 2025-08-20T00:00:00Z..2025-08-26T12:00:00Z. Or range of blocks 18000000..18000100.

​
sort_by
enum<string>
default:latest

Sort order for results.

Available options:
latest,
earliest
​
limit
integer
default:100

Maximum number of items to return.

Required range: 1 <= x <= 1000
​
cursor
string

Cursor for pagination to retrieve the next set of results.

Response

Successfully retrieved blocks.

​
blocks
object[]
required
​
next_cursor
string
Example:

"ICJkYXNkYXMifQ=="