💎 Ethereum
eth_getBlockByNumber

eth_getBlockByNumber RPC Method

Returns the data about the block

Parameters

1. blockNumber or Tag [required]

String Hexadecimal block number or "latest", "earliest", "pending", "safe" or "finalized"

"Safe" and "finalized" are only availible on Ethereum and Arbitrum One chains. Read block parameter description (opens in a new tab).

2. Transaction details flag [required] - Boolean

     If set to true, it returns the detail of each transaction.

     If set to false, only the hashes of the transactions.

     Default: false

params: [
    '0x1029C88', 
    true
    ]

Returns

  • Block object or null when no block was found. Properties

    • number - The block number. Null when the returned block is the pending block.

    • hash 32 Bytes - Hash of the block. In case of a pending block, it returns null.

    • parentHash 32 Bytes - Hash of the parent block.

    • nonce 8 Bytes - Hash of the generated proof-of-work. Null if pending.

    • difficulty - The integer of the difficulty for this block encoded as a hexadecimal string.

    • totalDifficulty - Hexadecimal of the total difficulty of the chain until this block.

    • logsBloom - The bloom filter for the logs of the block. null if pending.

    • sha3uncles - SHA3 of the uncles data in the block.

    • extraData - The “extra data” field of this block.

    • timestamp - The Unix timestamp for when the block was collated.

    • size - The unix timestamp for when the block was collated.

    • miner 20 Bytes - The address of the miner receiving the reward.

    • transactionsRoot - The root of the transaction trie of the block.

    • stateRoot - The root of the final state trie of the block.

    • receiptsRoot 32 Bytes - The root of the receipts trie of the block.

    • uncles - An Array of uncle hashes.

    • transactions - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.

    • gasUsed - The total used gas by all transactions in this block as a hexadecimal string.

    • gasLimit - The maximum gas allowed in this block encoded as a hexadecimal.

    • mixHash - A string of a 256-bit hash encoded as a hexadecimal.

    • baseFeePerGas [optional] - A string of the base fee encoded in hexadecimal format.

Request

POST https://<network>.chainnodes.org/YOUR-API-KEY

Example

💡

Confusing? Ask blockchain developers in Chainnodes Telegram Chat (opens in a new tab)

  • HTTPS POST Request with a JSON RPC call in the body
  • Replace YOUR-API-KEY with the API key from your Chainnodes.org Dashboard
  • You can use a different supported network by replacing mainnet
curl https://mainnet.chainnodes.org/YOUR-API-KEY\
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params": ["0x1029C88",false],"id":1}'

Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas":"0x6f664d776",
    "difficulty":"0x0",
    "extraData":"0x6265617665726275696c642e6f7267",
    "gasLimit":"0x1c9c380","gasUsed":"0xdf19ac","hash":"0xc529628a946ecf86acfaff0251aeae15ca2563c5aaf7b4872609b84f6f396c99",
    "logsBloom":"0x483116210982ad1b58020558a22beae30816924ced064d1701610970e7161937960493173253235b41003ba9607ef1bc0a99bfb69bc03c5c3a45c91905b8243014c88c05bd2a08383aa2c94a937b5221805020850a69286318c275d49a89a6bf1b524b9c4e060a31be0a08000c0169597a12203528586d391356aa3a8ca9a01cc70b4b763326c12d22e2710a928008b669004489d736149e40670cf8c1fa9921bbe985468f407bdc2402eff25880b50204559a6460800903837383ea1239618e0bcea6c2b028ee2402a2a6b64e09b512583142621a6d8414d60c3d965ac8ba1351383608ce922e224ed472828000d6f1c6bbb61b000800640081598a80285403",
    "miner":"0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5","mixHash":"0x33ca51f80eee8c8a39ab58b9b04291f1064df288a346921b567f3d6200a1c8df",
    "nonce":"0x0000000000000000","number":"0x1029c88",
    "parentHash":"0x38c03b0813aa479e8c0f1316828ed3729f1e100387a5372e1ecd4eee00d3c7e8",
    "receiptsRoot":"0xf29158cb7989375414c130a7e335808026fdc9f8b9b6670f9d67e29154e103d3",
    "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size":"0x28abc",
    "stateRoot":"0x30fcd7b38a90d1482006c66b9d630ece06a6d7405572e97ca4e1b0f2202744d7",
    "timestamp":"0x642709eb",
    "totalDifficulty":"0xc70d815d562d3cfa955",
    "transactions":["0xb19f38ce6f75b23a0d4b25f1ebb876dffb5041ece000628366a66420f5d80c36","0xdb933288ef260be1ca5782d3efec0a66dbc64a7fa0fd617ee573cbf5bd4ac47e","0xaf164cfba07ddc58cb4428fb91df05678d76483ea31ff19dde81c4313cdb2363","0x51e4a8526c0fd9b29ea3a5ef3e18a0c82a8ae1a6b4047d83b1b42e5688307055","0xde7f4f4307856b1618574eca694fa9d402ec0200b36f6cb7c883c0c8d5bcb202","0x285419f3cc21a2b23e7e2769e1e70f38d494c54a8e9c687becf6da6d59a39884","0x02b3f8273c8636481a3f6afa7642aaacc30160d9b527cf321d25b2ddc0781983","0x1dbfb9eec961333b9abb214362ee468f6999c3287d4075ccaebef19ab1f5d8b3","0xa05747160dd30e6d023c68a50d1a27f17ec265ca67c8ea31e730ae8f5ba95bda","0x2a4538d625c3230c4aff1057b0656599a599bfbfad039bb7c190fab3d1e523ff","0xe43fb021a540b167a5b945cd8910c039b326e04abf9d594f4151e8b6f2ca8878","0x3a76230bd02d51d0302b075544c9053b08a7d7dc5d347172ab53d14c78f304fb","0x838cfd2e2a35f14c861d150c5cd2c23c00a3980255e15349593e1b2e80e78697","0xd4d1f52d88ac0b0ee3d67d77ad053b647f93d0d6902e41c9eab697f9abc4d0b8","0x7708f214ba7414ca026e8018042ea22fbc821edb46facede9d6bbf65c846ea29","0xf5221565fd2652520ecb39482cb8b2bbbb487b84d7bd527638471367ae17c127","0xa477ef9788e0c544747261d3f7f0071ee8e8846da510bde4ff072b5bc77a5b4d","0x54694f2fa853c1bda09a9298afa8c6da7c70fb66fa979eeafd06a0db66db2b54","0x60730a2434ebfee5607cf050f1b6e5d1c2563e59b45d10996e3e3518f203b1c7","0xbdd5ae9dcbdf5d35f44d7b307abc6750de494fc1df23fe32c3f828a47cdd6b31","0xf9f2ed038931b2a8215c4eb1d5112e478e81e77db36c244b7462ad1eae8114ed","0x8a15dd799da7770a50f22b9c4768a777e49760d9cb88544bed47dda17bf606ee","0x4df8e712bd9e57cb03473c98f7bbb8a18e161724685e2e07f4365eec0686d38f","0x2ad0497e127e5b4fd996aed4e06320f4058d681622ab88dce055bd469e9e9078","0x78e23e267aebcab8532a3cda8c7c4e8ded2652d0f80cb5887bcb6703fc376aa5","0x8d5be4eedcbd3cf9becb2221bc303c6d0cb9608e53ae5c103c9d4a4c138a0a71","0x4e867569278e4ced2e628c3392b9f368b4cc892e9f55f2ffa3106ed9357dea09","0xbe72fb792de36b03b9d047995c2de877f59cf880e43669cbce22d0b98584a1f7","0x75f87f8acc5f561d8a554e1dc9c1d4b2cec4c71887d5ac57cff1fbc70f2eb984","0x44a50a7978b115f0961940f9207882e2518a5dacac410cfde1f084bab5ec2304","0x5337a5ae05de79d7cb90db463d8e2938c0aad347b2fcd752a77531078a9c872a","0x388c7aeaa58fe7e4802a7e59272e397d826776cb527104330f75be455e6895e6","0x8dc747ebfafe403df09ba6187a50bd74309a3af9d2df3599f09075bf6a3b7e40","0x1a52d8e7925360afaef323432a330b082319c27956454f83fed5959db6249600","0xf9e410aee12f1378de3ea7a3a11c24dc9936a51bedf95b69977d85983f04d631","0xf7a88f434946a176dc9d2a5a75579cd2a3434b5c0828c2d8083c6281b1469064","0x63bdca3ea3299b8a8709f4c6a5c86f825fae5891359305e114ba321fec32b17b","0x79c9c2c34532f77921283e0002aa44bd597c1bbfad4212410d93b1eafea6c729","0x6ac5af187500e0ddf564a82e9d64ab4c3a1ce9313955ee7d7b612ce57ed03fee","0xa1318cb166a80e21fe158ba6306cb3adb582be54ea6569d62aa761ae5921d9ff","0xf5b467e339ad2eb8b38630eec8a4b295df1c82ae384529cb8e3a2bc1dd4e30dd","0x4cdb4754165c3233a63878cd89be9f32a789c29f43543b332f4728f569683806","0x13efe4451d902366b3ff13747b5e891f77fb02f1d7e32bcb263774ce20c61c73","0x90a93f913f1c112144293938eb3989d60edcff0c01f299fee7eec3cba2b0c9b7","0x73da4a124b394eb414ec182550bfa3107714684defaf50874ebbb81add982157","0x8666b27559d10ec76a01108810945fa82c9d9662c2b87ed293c4d17174edb405","0x681e84716a0a852e5f3942d81200f335fa6bd15ab32f942471f1b66064deb370","0xea1928836d0193d304f39b554e6b9d3b471e76ee8cec4a7386e4031eb52d794c","0x02f1da6db1858e2012ab686062418ebdef99a295ec83ca754288c630e10694bf","0x1c3faf8024f2e9924aff8b39a12d7d0de859a981beecfabe2785596ab26e7b51","0x2c0e4e57dab40e0ae698b325743a72269c42b5b6412577f56c36da26debb31a9","0x16d4f2c22b458687f8b68645d3ae8217ccfb3c3b319119466b45ab2091ff96e2","0x4be8c2e7d86514af7ea8ee47967b842215edba0e77680929ed9ea5a564d4edad","0xc12e215f8254d8b62065cca2539bb1c7282e88f430c23f3128c3452b0fd3497f","0xfb5d47663917b609a6fb680ddb447a0c55e7a39e606a20013092064948c2b096","0x69e5ed3d8ef342fac630026e9992f27c32bfa6ff3a4efea0ffc7a4fe4f686c7d","0x47ad1c7741145a9e9c8f73aa5fe19fd6c07a5e8a897c0839a0be89e7465ba1fa","0xe8578131cde3cfa791a9b4ee47ff003ee7c191e18c203f14b0e70f4fa80f9dfc","0xe1228628a207941c1ab18c2e7fd32c2516bdab49ab66a1849dd5b850ef52d6dd","0xa6b337b32e055b8c3a27c7643af38b007227217a7a74d9971899c28cf69c34b4","0x4717ae38aa0b7c42ac7990c23323244268076b5b9faf4f86c3a414d8c63ebeda","0xacd8f958688a12620208d0ae8f39f0e70745904b33a8f634f5554b744a60bb3e","0x5c956d3a946db745f238546e63621f665681a230c6d01ab5be4204d9a6c31200","0x4ed27317a4c4333062b965aaf37e7315cde890aaba6554d69626eff05feb8309","0x2ce7f5ca7aae3dd05794bac105f49f6e3f4a355226a3bf05a7b7b61b937f50b7","0xcd3ae71a17d3f7fa547ecf535876598772e86ad5f9c36e9d32d91618dc5e01ad","0xf75364a8c9108c2adaa5b3d55133e4c17a9d435903f4a9cec2c609a6a9576f7c","0x88efe3c47f2b43acb32d108f1ca2e5dd84e943f67d37e4f53b539204a5d5fb07","0x05bb5ea8f6303e68673972dee1e901a9a942940873caa1a02448daebd73fc89d","0x8ae05d7afd4fbf1f4b69f04cc819af0eb53e9a6fd5193a0bb23ac4bef56ceb63","0x034b24ad60256039d8fe215c74665cf34faea82a7f34e6baf03334712f319918","0x257fda879481a990df8a83f775a8608b6b524757b72962c5967bb00f1fe89347","0xeb8f1774515136b5ad4db710141539d321e43f3bcb46ecab48c3aa453f07cc93","0x688ae1cc115346e34bb6244d5d0840da987170c0c2abe084b8c31832d71f90b1","0xb0374e204f455c11f30e263c6c944cef8e292401d9e93de33a2b1d9eea75093c","0xe9070e058ec62284b000ea1fbbc2c037eeeb74cb959aa155bf807698692e14dd","0x098568414818820802766ac50446ed6ad4744b9dcb6e10e5ff3d87fbab2ea788","0xef0c265aa423b74135b0335d2703b0bcd630f567e1f1d234e0af02202ec2b36b","0xe88b837d9e0bb9a692927b2bfe51742892aa897430567dc13f0b898c957d794d","0xbd00577b8ecc2b285f2d1af06154d3a0397e4288e93294b979d52cab9e020e6f","0x8b2e3c291304efa4a20e06a0807eb5302d2c04da0078b7ecd6314ad31e3dde67","0xdcc6692dd7ac2059aa9a3c9560b7cad7feebcebea0a575d83e54c6ad93179391","0xef2d01f8c8d1d13ba83ee03e7ff402eb4d544c88bf0a03b7abd6c536c0335c96","0x968fdc5c428408e35dbdf85cc731a8c19bfc7d9a8cb9d9646a0334c1db59efb6","0xcdb589358fbf44d9b747f74405870f90cd1e71f8672e553eaf5a6b94774b44ac","0xca9223146e939630a59d21b4118d50ae1563f2f4007d05f7493823b1af98af34","0xa2a1317b69beabc458e172987bfb91b2f41ad40e03c08ab643318954a76d8f58","0xd77345baa8bfc7778c825d604569b7c2df9501096e77b9a5a20429523cd6a3bc","0x1357747f44cfab49bcbca3fe7ebef18fe25e0debaed526a1421ca8db846460a3","0x51879c692a3dd8380f7fd48943b32fb1012616b999109b92894bf7a61ed67acc","0xfd0ced1f6a2fd27c6d5b115845f4aa94aad8e1c814deecdb7554597267e4d279","0x16d56cf9ee3ee5cd39090919386c116d453e779a7fe2ff43a96e4687baf7c2a1","0x9416568108876d48b8e6716956db5bd9dabd7314d21588e7a31cd89637d163a6","0x9420f2f78e517ddbb2f35dc0130843786d51b10bc00631fc89b23d6523c6df4b","0xb56cde9fa98aa9b0c50a89e396461f0b0e501c6c4dbdb63582c4da688e94f431","0x15a8cece6b0a496c324e2fd4af9746793ec768a54a2d24cfbe1765100 11294  100 11153  100   141   124k   1613 --:--:-- --:--:-- --:--:--  129k55c686f0483bb882c3aba285ba9","0x7b1173febbceb77734bb386974ed70d71533e65c29a91f2acc29330ab18acab4","0xecaaa60223795c18c665b222e305eae54680ccdd25cfb84699913f5e84dc5979","0xf410e0995896cf4a8490dbbd3db4ab87f714215244cd40bee7a1135b0a824c66","0x25d2c61bacf84461196d98e7f8ad780a065e77e1bb7a5bd74098d299e2909791","0xdc51a60a8cfe8874f1bf8085ad15571e6b2e088e86965b7d92788fce4aae23a3","0x8ff28d816e6840c01f0d246f6e84ee4fbe787dcf4d905f279d69d703bf2e499a","0x302ebfbcd16c6c3ddc2d8e150c09da97c02e8e0d241dd77f495e8a5719685dbf","0x859109c973aeb0826bfacb52385d9e3157cba580449f7c72ae78383af32f6518","0x16d0f57b38fd8847e573c670e324db1ff2e7b8e979676e9fdf52d1e16ad03045","0x2495b0000b21f05096d239efcc1ebfdce78ed242001bbbd117d29bd94fa3d763","0x07a4976c3d78694d0eb4acbcc1e489c2516672c32925809fc440464ec09147c4","0xdc7cad873ec141ea5e4c6932784557771660d59a414204d6ca2d437705aa96b5","0x9618557f66a112d0e6508c18a81b98be1a229e7b4a67fb309d997025d394b1b4","0x0957cc35494bd886f1b7a8ba36371a0ac73bfca00547ffd8af5d83c909fd811c","0xe0d38ab08dd5fc088ac712425a5202a818021ba1bd935722631279eea3764d97","0x956b905c7aab8b0c795bc3eeff0d2cfd0728ce34330f68fed5b65e5e098b7b8d","0xc9a51e9503432a55cdac738edbe7f2317f73574976ab86abeafcbd190b7064d3","0x7754e4367b7af0b9002e189f09020121b10cb1ed3b6ec664a5cfe26c5d635b8f","0x1b542d7377edb2f33505d401d4a9f59192d70d6d42eb58c43aa2a5fffb241d48","0x73a859ebc8e35d3799b4639c0d7a59164266060e53b33ca2ce92a73bfb0ffb68","0x07565847ae0fa298629d5a8c135439d92e34a0a2c629d7336c8ac0aadf40c115","0x93e9d3d0634660d981889494af9cb82085148976af59e9ceecfb9a1e2852c91a","0xf8632df0f4e726b444555521621870e62d3b593b669380144eab1133db372a19","0x6a96f4da30b8422b9b832046d18c1e5a1cf66e0207f933bfcf18d4c7756f0b58","0x16a42cba7bbc96a0c2a88ecfbd8c18266316dacf5451ba09620d2304fc45960a","0x47732c64c734c765c00c21cfb775a859172a89719d5a6015f73bd96b7210d2eb","0xa9b3495bcbb7af427dad8e93ac546a648ad1281d9588edd658569ba47755c077","0xb9953e2c218ba50a2419c44ce1687a327a167fff0c4830681334df927d3df7d0","0xdc086363c18acfb6e3f077ad76b033ed9e6fcb6b2a0ee2c99a5fda8139d17fbc","0x4b0078e13d6f1166c6c6ccf2aac924efe16e091de1043903449fa11829362c1a","0x5883d8a58afa97396ff1a8e79c3892d8e3ba822ba112ae655edcce9969003d2e","0xbb3d134b0f887884b94e8ce8eed6f48830e5eda180eac693b926918ce18815b6","0xf929b5027feaa754fa0c2e81a3d7fd349b91acd583d4428692c4645864f8fda0","0x644fdfde040aa98c2414ad7ac2bd2ec61e269b9cd383b1194d1b5c2412abdfe8","0x487ee30830ffaf37355578eb68a07c5a981e457b81e69486a08ec1d633ada0ce","0xd04d3d4d14f09e2ca7ec498297656c2052b019e224645a1928c309e83761488a","0xe283994a22efcabc01580f65f94b6c8af564d073fb43f3ec468c8347626203fc","0x29e3b769fda69c5d6533d45c8da4183ac2ee56eeccc61d6eea49041073387bb8","0x957d1c13ec6dd6acd800a95a96c3d875268782979847c5ffc8caed3a0a5f125b","0x5206ebc63d07883a5960161e526da62237c265f7e192ca7ee30fd4674a2493cb","0x36574a3770772b8a365753a3c5d6c96f8419099c3058c5ed26195e888984b2d7"],
    "transactionsRoot":"0x6f7b725bc43c2a3ad666751059041d722a17b9d69cf9f23e3a73af3a54c01eb7",
    "uncles":[]}}
 
}

Need RPC API keys?

Get 12.5M archival requests for free today.

GET STARTED FOR FREE
eth_getBlockByHasheth_getBlockReceipts