v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB

get block info

Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.

get/blocks/{block_number_or_hash}

Path parameters

block_number_or_hashstring required

Block number or hash

Response

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.