Retrieves detailed information for a specific block identified by its number or hash.

Retrieves detailed information for a specific block, including transactions, internal transactions, and metadata.

GET /v2/blocks/{block_hash_or_number_param}

Retrieves detailed information for a specific block identified by its number or hash.

cURL

curl --request GET \
  --url http://localhost/api/v2/blocks/{block_hash_or_number_param}

200

{
  "base_fee_per_gas": "<string>",
  "burnt_fees": "<string>",
  "burnt_fees_percentage": 123,
  "difficulty": "<string>",
  "gas_limit": "<string>",
  "gas_target_percentage": 123,
  "gas_used": "<string>",
  "gas_used_percentage": 123,
  "hash": "<string>",
  "height": 1,
  "internal_transactions_count": 123,
  "is_pending_update": true,
  "miner": {
    "ens_domain_name": "<string>",
    "hash": "<string>",
    "implementations": [
      {
        "address_hash": "<string>",
        "name": "<string>"
      }
    ],
    "is_contract": true,
    "is_scam": true,
    "is_verified": true,
    "metadata": {
      "tags": [
        {
          "meta": {},
          "name": "<string>",
          "ordinal": 123,
          "slug": "<string>",
          "tagType": "<string>"
        }
      ]
    },
    "name": "<string>",
    "private_tags": [
      {
        "address_hash": "<string>",
        "display_name": "<string>",
        "label": "<string>"
      }
    ],
    "public_tags": [
      {
        "address_hash": "<string>",
        "display_name": "<string>",
        "label": "<string>"
      }
    ],
    "watchlist_names": [
      {
        "display_name": "<string>",
        "label": "<string>"
      }
    ]
  },
  "nonce": "<string>",
  "parent_hash": "<string>",
  "priority_fee": "<string>",
  "rewards": [
    {
      "reward": "<string>",
      "type": "<string>",
      "address_hash": "<string>"
    }
  ],
  "size": 123,
  "timestamp": "2023-11-07T05:31:56Z",
  "total_difficulty": "<string>",
  "transaction_fees": "<string>",
  "transactions_count": 123,
  "uncles_hashes": [
    {
      "hash": "<string>"
    }
  ],
  "withdrawals_count": 1,
  "arbitrum": {
    "batch_number": 123,
    "commitment_transaction": {
      "hash": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    },
    "confirmation_transaction": {
      "hash": "<string>",
      "timestamp": "2023-11-07T05:31:56Z"
    },
    "delayed_messages": 123,
    "l1_block_number": 123,
    "send_count": 123,
    "send_root": "<string>"
  }
}

Path Parameters

block_hash_or_number_param · integer string · required

Block hash or number in the path

Required range: x >= 0

Query Parameters

apikey · string

API key for rate limiting or for sensitive endpoints

key · string

Secret key for getting access to restricted resources

Response

200

application/json

Detailed information about the specified block.

Block response

base_fee_per_gas · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

burnt_fees · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

burnt_fees_percentage · number<float> | null · required

difficulty · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

gas_limit · string · required

Pattern: ^-?([1-9][0-9]*|0)$

gas_target_percentage · number<float> · required

gas_used · string · required

Pattern: ^-?([1-9][0-9]*|0)$

gas_used_percentage · number<float> · required

hash · string · required

Pattern: ^0x([A-Fa-f0-9]{64})$

height · integer · required

Required range: x >= 0

internal_transactions_count · integer | null · required

is_pending_update · boolean · required

miner · Address · object · required

Address

Show child attributes

nonce · string | null · required

Pattern: ^0x([A-Fa-f0-9]*)$

parent_hash · string · required

Pattern: ^0x([A-Fa-f0-9]{64})$

priority_fee · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

rewards · object[] · required

Show child attributes

size · integer · required

timestamp · string<date-time> · required

Block timestamp of the parent transaction.

total_difficulty · string | null · required

Pattern: ^-?([1-9][0-9]*|0)$

transaction_fees · string · required

Pattern: ^-?([1-9][0-9]*|0)$

transactions_count · integer · required

type · enum<string> · required

Available options: block, uncle, reorg

uncles_hashes · object[] · required

Show child attributes

withdrawals_count · integer | null · required

Required range: x >= 0

arbitrum · object

Show child attributes