eth_getBlockByNumberHTTP

Returns block details for a height or tag. Set fullTransactions to true for full tx objects; false returns hashes only (lighter). Returns null when the serving upstream cannot find the block. Fields vary with the network and fork. Pending is a provisional client view; a stable hash and some header fields may be unavailable.

Chain EthereumTransport HTTPTry-it live

How to use

Pick an API key (or paste one) in the Try it panel.
Fill each parameter (order = params array index).
Send request — live against the gateway; counts toward daily quota.

Parameters

JSON-RPC positional arguments — order matches the array sent in params. Index badges below match array positions.

blockQUANTITY|TAGrequired

Block number (hex) or tag ("latest", "finalized").

params array (shape)

eth_getBlockByNumber · paramsjson

1[
2  "latest",
3  false
4]

Try it

Live request via the gateway — counts toward your account's daily quota. Chain: ethereum

JSON mode

API key

Try-it runs with one of your own keys — sign in or create a free account first.

Parameters

0blockQUANTITY|TAGrequired

Block number (hex) or tag ("latest", "finalized").

1fullTxBooleanrequired

true = full transaction objects, false = hashes only.

false

Example request

eth_getBlockByNumber · requestbash

1curl 'https://ethras.org/v1/ethereum/<YOUR_KEY>' \
2  -H 'Content-Type: application/json' \
3  -d '{
4    "id": 1,
5    "jsonrpc": "2.0",
6    "method": "eth_getBlockByNumber",
7    "params": [
8      "latest",
9      false
10    ]
11  }'

Example response

Illustrative example: long hex values and object fields may be shortened for readability. Available fields depend on the network, client, protocol upgrade and transaction type.

eth_getBlockByNumber · responsejson

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": {
5    "number": "0x186a9f7",
6    "hash": "0x4b2c...",
7    "parentHash": "0x1af0...",
8    "timestamp": "0x66a1e2f0",
9    "transactions": [
10      "0x9c81..."
11    ]
12  }
13}

Response fields

The result row describes the complete result; other rows describe its object fields or array elements. Indented rows describe nested members. For subscriptions,params.* rows describe later notifications rather than the initial reply.

Field	Type	Description
`result`	`OBJECT\|null`	Block object, or null when no block is available to the serving upstream.
`number`	`QUANTITY\|null`	Block number.
`hash`	`DATA(32B)\|null`	Block hash.
`parentHash`	`DATA(32B)`	Hash of the parent block.
`timestamp`	`QUANTITY`	Unix timestamp (seconds) when the block was proposed.
`miner`	`DATA(20B)`	Block producer or fee recipient, according to the selected network's consensus rules.
`gasLimit`	`QUANTITY`	Maximum gas allowed in this block.
`gasUsed`	`QUANTITY`	Total gas used by all transactions.
`baseFeePerGas`	`QUANTITY`	Execution base fee in native-currency smallest units per gas, on networks and forks exposing EIP-1559.
`size`	`QUANTITY`	Block size in bytes.
`transactions`	`ARRAY`	Transaction hashes (fullTx=false) or full transaction objects (fullTx=true).
`withdrawals`	`ARRAY`	Validator withdrawals where the network and fork support them; not every EVM network has Ethereum withdrawals.
└`index`	`QUANTITY`	Withdrawal index.
└`validatorIndex`	`QUANTITY`	Validator index on the relevant consensus chain.
└`address`	`DATA(20B)`	Withdrawal recipient.
└`amount`	`QUANTITY`	Withdrawal amount in Gwei (10^9 wei), not wei.
`withdrawalsRoot`	`DATA(32B)`	Withdrawal-list commitment where the network and fork expose it.
`blobGasUsed`	`QUANTITY`	Blob gas used in this block where the network and fork support EIP-4844.
`excessBlobGas`	`QUANTITY`	Excess blob gas used to calculate blob base fees, where supported.
`parentBeaconBlockRoot`	`DATA(32B)`	Parent beacon-chain block root where the network and fork expose EIP-4788.
`stateRoot`	`DATA(32B)`	Root of the post-execution state trie.
`transactionsRoot`	`DATA(32B)`	Root of the transactions trie.
`receiptsRoot`	`DATA(32B)`	Root of the receipts trie.
`logsBloom`	`DATA(256B)`	Bloom filter of all logs in the block.
`extraData`	`DATA`	Arbitrary extra data supplied by the proposer.
`mixHash`	`DATA(32B)`	Consensus-dependent field. On post-Merge Ethereum it carries prevRandao; other networks may use different values.
`nonce`	`DATA(8B)`	Legacy or consensus-specific 8-byte header field; zero on post-Merge Ethereum, not a cross-chain invariant.
`difficulty`	`QUANTITY`	Consensus-dependent difficulty value; zero on post-Merge Ethereum, but other EVM networks can return nonzero compatibility values.
`sha3Uncles`	`DATA(32B)`	Ommer-list hash; the empty-list commitment on post-Merge Ethereum. Interpret other networks under their own consensus rules.
`uncles`	`DATA(32B)[]`	Ommer hashes. Empty for post-Merge Ethereum blocks; historical Ethereum PoW blocks can contain ommers.
`requestsHash`	`DATA(32B)`	Commitment to execution-layer requests on networks and forks exposing EIP-7685.