Documentation / API reference / EVM
Get EVM Block
Reference
Last reviewed 2026-09-18
Returns indexed EVM blocks with hashes, timestamps, gas usage, gas limits and block roots.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
block_number | query | integer (int32) | ||
block_start | query | integer (int32) | Start of block range (inclusive) | |
block_end | query | integer (int32) | End of block range (inclusive) | |
timestamp_start | query | integer (int64) | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
timestamp_end | query | integer (int64) | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
page | query | integer (int32) | ||
limit | query | integer (int32) | 0-200 | |
order | query | string | One of block_number_asc, block_number_desc, timestamp_asc, timestamp_desc. |
Responses
200 — Blocks retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].base_fee_per_gas | string | Yes |
data[].difficulty | string | Yes |
data[].extra_data | string | Yes |
data[].gas_limit | string | Yes |
data[].gas_used | string | Yes |
data[].hash | string | Yes |
data[].miner | string | Yes |
data[].nonce | string, nullable | |
data[].number | integer (int32) | Yes |
data[].parent_hash | string | Yes |
data[].sha_3_uncles | string | Yes |
data[].size | integer (int32) | Yes |
data[].state_root | string | Yes |
data[].timestamp | string (date-time) | Yes |
data[].total_difficulty | string | Yes |
data[].transaction_root | string, nullable | |
data[].uncles | string, nullable | |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Example response
json
{}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Blocks not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.