GET
/
insights
/
v1
/
blocks
Get blocks
curl --request GET \
  --url https://data-api.b3.fun/insights/v1/blocks
{
  "data": [
    {
      "chain_id": 123,
      "block_number": 123,
      "block_hash": "<string>",
      "parent_hash": "<string>",
      "block_timestamp": 123,
      "nonce": "<string>",
      "sha3_uncles": "<string>",
      "mix_hash": "<string>",
      "miner": "<string>",
      "state_root": "<string>",
      "transactions_root": "<string>",
      "receipts_root": "<string>",
      "logs_bloom": "<string>",
      "size": 123,
      "extra_data": "<string>",
      "difficulty": "<string>",
      "total_difficulty": "<string>",
      "transaction_count": 123,
      "gas_limit": 123,
      "gas_used": 123,
      "withdrawals_root": "<string>",
      "base_fee_per_gas": 123
    }
  ],
  "aggregations": "<any>",
  "meta": {
    "chain_ids": [
      123
    ],
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit_per_chain": 123,
    "total_items": 123,
    "total_pages": 123
  }
}

Query Parameters

chain
number[]
deprecated

Use chain_id instead

Example:
[20, 56, 1]
chain_id
number[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

Example:
[20, 56, 1]
filter_block_number
number | null

Filter by block number

Example:

1000000

filter_block_number_gte
number | null

Filter by block number greater than or equal to

Example:

1000000

filter_block_number_gt
number | null

Filter by block number greater than

Example:

1000000

filter_block_number_lte
number | null

Filter by block number less than or equal to

Example:

1000000

filter_block_number_lt
number | null

Filter by block number less than

Example:

1000000

filter_block_timestamp
number | null

Filter by block timestamp

Example:

1715222400

filter_block_timestamp_gte
number | null

Filter by block timestamp greater than or equal to

Example:

1715222400

filter_block_timestamp_gt
number | null

Filter by block timestamp greater than

Example:

1715222400

filter_block_timestamp_lte
number | null

Filter by block timestamp less than or equal to

Example:

1715222400

filter_block_timestamp_lt
number | null

Filter by block timestamp less than

Example:

1715222400

sort_by

Field to sort results by

Available options:
block_number
Example:

"block_number"

sort_order
enum<string>

Sort order (asc or desc)

Available options:
asc,
desc
Example:

"desc"

group_by
string | null

Field(s) to group by. You can specify multiple with repeated query parameters, e.g., ?group_by=chain_id&group_by=block_number

aggregate
string | null

Aggregation(s). You can specify multiple with repeated query parameters, e.g., ?aggregate=count()&aggregate=sum(gas_used)

Example:

"count() as count"

filter_hash
string

Filter by transaction hash

Example:

"0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e"

limit
integer
default:20

The number of items to return

Required range: 0 < x <= 1000
Example:

20

page
integer | null
default:0

Page number (0-indexed). Maximum value depends on query parameters: 20 for regular queries, 500 when using aggregate or group_by parameters.

Required range: x >= 0
Example:

0

Response

200
application/json

Successful response

The response is of type object.