Blocks API
Read confirmed block records by number or hash, with timestamps, transaction counts, and gas metrics.
Endpoints
| Method | Path | Description | CU / Call | USD / 1M Calls | Calls per free cycle (approx.) |
|---|---|---|---|---|---|
| GET | /{chain}/blocks/{number} | Get a block by number | 5 | $0.50 | 6,000,000 |
| GET | /{chain}/blocks/hash/{hash} | Get a block by hash | 5 | $0.50 | 6,000,000 |
Free plan: all keys in your account share an average of 25 calls per second.
Response fields
GET/{chain}/blocks/{number}
| Field | Type |
|---|---|
| number | integer |
| hash | string |
| parent_hash | string |
| timestamp | string |
| miner | string |
| gas_limit | integer |
| gas_used | integer |
| base_fee_per_gas | string | null |
| state_root | string |
| transactions_root | string |
| receipts_root | string |
| tx_count | integer |
| size | integer |
| l1_block_number | integer | null |
| extra | object |
GET/{chain}/blocks/hash/{hash}
| Field | Type |
|---|---|
| number | integer |
| hash | string |
| parent_hash | string |
| timestamp | string |
| miner | string |
| gas_limit | integer |
| gas_used | integer |
| base_fee_per_gas | string | null |
| state_root | string |
| transactions_root | string |
| receipts_root | string |
| tx_count | integer |
| size | integer |
| l1_block_number | integer | null |
| extra | object |
Available on Chains
Quick example
curl -s "https://api.blockvectra.com/v1/data/arb_mainnet/blocks/1" -H "x-api-key: {api_key}"Documentation
Try this dataset for free
Get 30M CU on sign-up, refilled every 30 days.
Data API bills only successful responses.