Get blocks

Get blocks

GET /insights/v1/blocks

Get blocks

cURL

curl --request GET \
  --url https://data-api.b3.fun/insights/v1/blocks

200

{
  "meta": {
    "chain_ids": [
      123
    ],
    "page": 123,
    "limit_per_chain": 123,
    "total_items": 123,
    "total_pages": 123,
    "address": "<string>",
    "signature": "<string>"
  },
  "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": null
}

Query Parameters

chain · number[]

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 · enum<string> string

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

meta · object · required

Show child attributes

data · object[]

Show child attributes

aggregations · unknown