eth_getBlockByNumber

Returns information about a block given the block's number.

Parameters

  • QUANTITY|TAG - Integer block number or one of "earliest", "latest" or "pending"
  • Boolean - If true it returns the full transaction objects, if false only the hashes of the transactions

Returns

  • Object - An object of type Block defined as:
  • number: QUANTITY - The block number or null when pending
  • hash: DATA, 32 Bytes - Hash of the block or null when pending
  • parentHash: DATA, 32 Bytes - Hash of the parent block
  • nonce: DATA, 8 bytes - Hash of the proof of work or null when pending
  • sha3Uncles: DATA, 32 Bytes - SHA3 of the uncles data in the block
  • logsBloom: DATA, 256 Bytes - The bloom filter for the block's logs or null when pending
  • transactionsRoot: DATA, 32 Bytes - The root of the transaction trie of the block
  • stateRoot: DATA, 32 Bytes - The root of the final state trie of the block
  • receiptsRoot: DATA, 32 Bytes - The root of the receipts trie of the block
  • miner: DATA, 20 Bytes - The address of the beneficiary to whom the mining rewards were given
  • difficulty: QUANTITY - Integer of the difficulty for this block
  • totalDifficulty: QUANTITY - Integer of the total difficulty of the chain until this block
  • extraData: DATA - The extra data field of this block
  • size: QUANTITY - Integer the size of this block in bytes
  • gasLimit: QUANTITY - The maximum gas allowed in this block
  • gasUsed: QUANTITY - The total used gas by all transactions in this block
  • timestamp: QUANTITY - The unix timestamp for when the block was collated
  • transactions: ARRAY - Array of transaction objects, or 32 Bytes transaction hashes depending on the
    last given parameter
  • uncles: ARRAY - Array of uncle hashes
Language
URL
Click Try It! to start a request and see the response here!