eth_getBlockByNumber

Returns information about a block by block number.

Request

curl 'https://rpc.web3api.io?x-api-key=YOUR-API-KEY' \
    -X POST \
    -H 'x-amberdata-blockchain-id: ethereum-mainnet' \
    -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["0x1b4",false]}'
IndexDescription
0* - blockNumberThe integer of a block number, or the string "earliest", "latest" or "pending", as in the default block parameter.
1* - includeTransactionsIf true it returns the full transaction objects, if false only the hashes of the transactions.

*Required

Response

{
"id":1,
"jsonrpc":"2.0",
"result": {
    "number": "0x1b4", // 436
    "hash": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    "parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
    "nonce": "0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
    "receiptsRoot": "0x5eced534b3d84d3d732ddbc714f5fd51d98a941b28182b6efe6df3a0fe90004b",
    "miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
    "difficulty": "0x027f07", // 163591
    "totalDifficulty":  "0x027f07", // 163591
    "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "size":  "0x027f07", // 163591
    "gasLimit": "0x9f759", // 653145
    "gasUsed": "0x9f759", // 653145
    "timestamp": "0x54e34e8e" // 1424182926
    "transactions": [{...},{ ... }] 
    "uncles": ["0x1606e5...", "0xd5145a9..."]
  }
}
TypeDescription
numberThe block number. null when its pending block.
hashThe hash of the block. null when its a pending block.
parentHashThe hash of the parent block.
nonceThe hash of the generated proof-of-work. null when its pending block.
sha3UnclesThe SHA3 of the uncles data in the block.
logsBloomThe bloom filter for the logs of the block. null when its pending block.
transactionsRootThe root of the transaction trie of the block.
stateRootThe root of the final state trie of the block.
The root of the receipts trie of the block.
minerThe address of the beneficiary to whom the mining rewards were given.
difficultyThe integer of the difficulty for this block.
totalDifficultyThe integer of the total difficulty of the chain until this block.
extraDataThe "extra data" field of this block.
sizeThe integer the size of this block in bytes.
gasLimitThe maximum gas allowed in this block.
gasUsedThe total used gas by all transactions in this block.
timestampThe unix timestamp for when the block was collated.
transactionsThe array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.
unclesThe array of uncle hashes.