Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
blocks

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/{chain_id}/api/v2/blocks/{block_hash_or_number_param}

Path parameters

integer required
OR
string required

Block hash or number in the path

chain_idstring required

The ID of the blockchain

Response

Detailed information about the specified block.

base_fee_per_gasstring nullable 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.

burnt_feesstring nullable required

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

burnt_fees_percentagenumber float nullable required

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

difficultystring nullable required

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

gas_limitstring required
gas_target_percentagenumber float required

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

gas_usedstring required
gas_used_percentagenumber float required

Gas used in this block as a percentage of gas_limit.

hashstring required
heightinteger required

Block number (zero-based index from genesis).

internal_transactions_countinteger nullable required

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

is_pending_updateboolean nullable required

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

noncestring required

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

parent_hashstring required
priority_feestring nullable required

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

sizeinteger nullable required

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

timestampstring date-time required
total_difficultystring nullable required

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

transaction_feesstring required

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

transactions_countinteger required
type'block' | 'uncle' | 'reorg' required

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

withdrawals_countinteger nullable required

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