eth_getBlockByNumber

Retrieves detailed information about a specific block on the Ethereum blockchain by its number

Request

Examples

curl --request POST \
    --url https://rpc.xone.org \
    --header 'accept: application/json' \
    --header 'content-type: application/json' \
    --data '
{
 "id": 1,
 "jsonrpc": "2.0",
 "method": "eth_getBlockByNumber",
 "params": [
   "finalized",
   false
 ]
}
'

Response

200 OK

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "number": "0x1b4",
    "difficulty": "0x4ea3f27bc",
    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
    "gasLimit": "0x1388",
    "gasUsed": "0x0",
    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
    "nonce": "0x689056015818adbe",
    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x220",
    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
    "timestamp": "0x55ba467c",
    "totalDifficulty": "0x78ed983323d",
    "transactions": [],
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "uncles": []
  }
}

Request params

Name	Type	Description
id	integer	Request identifier
jsonrpc	string	JSON-RPC version
method	string	API method name
Parameters	array
blockNumber	string	The block number or tag ("latest", "earliest", "pending") at which to get the balance.
transaction_detail_flag	boolean	If set to true, returns the full transaction objects for all transactions in the block; if false, returns only the transaction hashes.

Response

200

The block object if the block is found, containing detailed information such as block hash, parent hash, miner, transactions, gas used, and more. If the block is not found, it returns null.

Name	Type	Description
Parameters	object
baseFeePerGas	string	Hexadecimal string of the base fee per gas. Not included for blocks before the EIP-1559 upgrade.
difficulty	integer	The block's difficulty level, encoded as a hexadecimal.
extraData	string	Additional data field of the block.
gasLimit	string	Maximum gas allowed in the block, in hexadecimal.
gasUsed	string	Total gas used by all transactions in the block, in hexadecimal.
hash	string	Hash of the block, null if pending.
logsBloom	string	Bloom filter for the block's logs, null if pending.
miner	string	Address of the block's mining reward beneficiary.
mixHash	string	256-bit hash as a hexadecimal string.
nonce	string	Proof-of-work hash, null if pending.
number	string	Block number as a hexadecimal, null if pending.
parentHash	string	Hash of the parent block.
receiptsRoot	string	Root of the block's receipts trie.
sha3Uncles	string	SHA3 hash of the block's uncles data.
size	string	Size of the block in bytes, as a hexadecimal integer.
stateRoot	string	Root of the block's final state trie.
timestamp	string	UNIX timestamp of the block's collation.
totalDifficulty	string	Total difficulty of the blockchain up to this block, in hexadecimal.
transactions	array	List of transaction objects; refer to eth_getTransactionByHash for details.
transactionsRoot	string	Root of the block's transaction trie.
uncles	array	List of uncle block hashes.

Blocks info eth_getBlockTransactionCountByHash