eth_getBlockByHashHTTP

Returns block details for a 32-byte block hash. fullTransactions controls whether txs are objects or hashes. Returns null when the serving upstream cannot find the block. Fields vary with the network and fork.

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.

hashDATA(32B)required

Block hash.

fullTxBooleanrequired

true = full transaction objects, false = hashes only.

params array (shape)

eth_getBlockByHash · paramsjson

1[
2  "$LATEST_BLOCK_HASH",
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

0hashDATA(32B)required

Block hash.

1fullTxBooleanrequired

true = full transaction objects, false = hashes only.

false

Example request

eth_getBlockByHash · 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_getBlockByHash",
7    "params": [
8      "0xa76a6d74748ba4c3b2756b51d77ca3a5f6990ef197fe8886c819d02cd4c12156",
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_getBlockByHash · responsejson

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": {
5    "number": "0x186d92b",
6    "hash": "0xa76a...",
7    "transactions": ["0x13de35b1...", "..."]
8  }
9}

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`	Block number.
`hash`	`DATA(32B)`	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.