🟪 Polygon
eth_getBlockByHash

Polygon API Documentation


eth_getBlockByHash RPC Method

eth_getBlockByHash returns information about a block by hash.

Parameters

1. BlockHash [required]

String The hash (32 bytes) of the block to retrieve.

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: [
    '0xc529628a946ecf86acfaff0251aeae15ca2563c5aaf7b4872609b84f6f396c99', 
    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.

Need RPC API keys?

Get 12.5M archival requests for free today.

GET STARTED FOR FREE

Request

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

Example

  • 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 polygon-mainnet
curl https://polygon-mainnet.chainnodes.org/YOUR-API-KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params": ["0xc529628a946ecf86acfaff0251aeae15ca2563c5aaf7b4872609b84f6f396c99",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":[]}}
 
}

Some use cases:

  1. Block Exploration: Blockchain explorers use eth_getBlockByHash to provide detailed information about specific blocks when users search by block hash.
  2. Transaction Verification: If a user knows the hash of a block that their transaction was included in, they can use eth_getBlockByHash to retrieve the block and verify the inclusion of their transaction.
  3. Network Monitoring: Services that monitor the Polygon network for various purposes (like security, auditing, or analytics) use eth_getBlockByHash to retrieve specific blocks of interest.
  4. Historical Analysis: Researchers and data analysts can use eth_getBlockByHash to retrieve specific blocks for historical analysis of the Polygon or other networks.

💡 Confusing?

Ask our experienced blockchain developers in Telegram

ASK FOR FREE

JSON-RPC API Documentation by CHAINNODES is based on Erigon node client. Contact us if you are interested in specific methods that are only available on geth, besu, Nethermind or reth

Last updated on
eth_getBlockTransactionCountByHasheth_getBlockByNumber