Skip to main content
GET
Retrieves detailed information for a specific block identified by its number or hash.

Authorizations

Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Path Parameters

block_hash_or_number_param
required

Block hash or number in the path

Required range: x >= 0
chain_id
string
required

The ID of the blockchain

Response

Detailed information about the specified block.

Block response

base_fee_per_gas
string | null
required

EIP-1559 base fee per gas, in wei. Null on blocks produced before EIP-1559 activation or on chains that do not implement EIP-1559.

Pattern: ^-?([1-9][0-9]*|0)$
burnt_fees
string | null
required

Sum of EIP-1559 base fees burned by transactions in this block, in wei.

Pattern: ^-?([1-9][0-9]*|0)$
burnt_fees_percentage
number<float> | null
required

Burned base fees as a percentage of total transaction fees in this block.

difficulty
string | null
required

Proof-of-work difficulty of this block. Zero on proof-of-stake chains.

Pattern: ^-?([1-9][0-9]*|0)$
gas_limit
string
required
Pattern: ^-?([1-9][0-9]*|0)$
gas_target_percentage
number<float>
required

Percent above the EIP-1559 elasticity target (gas_used vs. gas_limit / elasticity_multiplier).

gas_used
string
required
Pattern: ^-?([1-9][0-9]*|0)$
gas_used_percentage
number<float>
required

Gas used in this block as a percentage of gas_limit.

hash
string
required
Pattern: ^0x([A-Fa-f0-9]{64})$
height
integer
required

Block number (zero-based index from genesis).

Required range: x >= 0
internal_transactions_count
integer | null
required

Number of internal transactions in this block; null when the count is unavailable.

Required range: x >= 0
is_pending_update
boolean | null
required

True when the block is scheduled for re-fetch; its fields may change once re-fetching completes.

miner
Address · object
required

Address credited with the block — the miner on PoW chains, the fee recipient / proposer on PoS chains, and the sequencer on rollups.

nonce
string
required

Proof-of-work nonce used to satisfy the difficulty target. Zero on proof-of-stake chains.

Pattern: ^0x([A-Fa-f0-9]*)$
parent_hash
string
required
Pattern: ^0x([A-Fa-f0-9]{64})$
priority_fee
string | null
required

Sum of validator tips (EIP-1559 priority fees) paid by transactions in this block, in wei.

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

Block rewards grouped by recipient category. Single-block variant: type is a human-readable label rather than a machine identifier.

size
integer | null
required

Block size in bytes (length of the RLP-encoded block).

Required range: x >= 0
timestamp
string<date-time>
required
total_difficulty
string | null
required

Cumulative chain difficulty through this block (sum of difficulty of this block and all ancestors).

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

Sum of transaction fees (gas price × gas used) paid by transactions in this block, in wei.

Pattern: ^-?([1-9][0-9]*|0)$
transactions_count
integer
required
Required range: x >= 0
type
enum<string>
required

Block classification: block = main-chain consensus block; uncle = ommer (valid but not in main chain); reorg = former main-chain block lost to reorganization.

Available options:
block,
uncle,
reorg
uncles_hashes
object[]
required

Hashes of ommer (uncle) blocks referenced by this block.

withdrawals_count
integer | null
required

Number of withdrawals included in this block; null when the count is unavailable.

Required range: x >= 0
arbitrum
object