Web3API
HomeAPI EndpointsContactTwitter
  • ​🚀 Welcome to Web3API
  • Introduction
    • ✨Getting Started
    • 📡 Choosing A Network
  • Developers
    • 🔌API Endpoints
      • eth_hashrate
      • eth_gasPrice
      • eth_blockNumber
      • eth_getBalance
      • eth_getStorageAt
      • eth_getTransactionCount
      • eth_getBlockTransactionCountByHash
      • eth_getBlockTransactionCountByNumber
      • eth_getCode
      • eth_sendRawTransaction
      • eth_call
      • eth_getBlockByHash
      • eth_getBlockByNumber
      • eth_getTransactionByHash
      • eth_getTransactionByBlockHashAndIndex
      • eth_getTransactionByBlockNumberAndIndex
      • eth_getTransactionReceipt
      • eth_getUncleByBlockHashAndIndex
      • eth_getUncleByBlockNumberAndIndex
      • eth_getUncleCountByBlockHash
      • eth_getUncleCountByBlockNumber
      • eth_estimateGas
      • eth_syncing
    • 😟API Errors and Troubleshooting
  • Tutorials
    • ⚡Adding a Custom RPC to Metamask
  • Dashboard
    • 🔑Forgot Password
  • Resources
    • ❓ FAQ
    • 🤝 Support
Powered by GitBook
On this page

Was this helpful?

  1. Developers
  2. API Endpoints

eth_getBlockByHash

Returns information about a block by hash.

Example

curl https://bsc-<network>.web3api.com/v1/YOUR-API-KEY
-X POST 
-H "Content-Type: application/json" 
-d "{\"jsonrpc\":\"2.0\",\"method\":\"eth_getBlockByHash\",\"params\": [\"0x1fb2230a6b5bf856bb4df3c80cbf95b84454169a5a133fffaf8505a05f960aeb\", false],\"id\":1}" 
curl -X POST 'https://bsc-<network>.web3api.com/v1/YOUR-API-KEY' \
-H 'Content-Type: application/json' \
--data-raw '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params": ["0x1fb2230a6b5bf856bb4df3c80cbf95b84454169a5a133fffaf8505a05f960aeb", false],"id":1}' 
  1. BLOCK HASH - A string representing the hash (32 bytes) of a block.

  2. SHOW TRANSACTION DETAILS FLAG - A boolean parameter. When true, returns the full transaction information of each transaction hash included within the block. When false, only returns transaction hashes within the block.

Result Fields

BLOCK - A block object, or null when no block was found with the hash specified.

Within the block object, the following block information are available.

  1. difficulty: integer of the difficulty for this block.

  2. extraData: the "extra data" field of this block.

  3. gasLimit: the maximum gas allowed in this block.

  4. gasUsed: the total used gas by all transactions in this block.

  5. hash: 32 Bytes - hash of the block. Null when the returned block is the pending block.

  6. logsBloom: 256 Bytes - the bloom filter for the logs of the block. Null when the returned block is the pending block.

  7. miner: 20 Bytes - the address of the beneficiary to whom the mining rewards were given.

  8. mixHash -

  9. nonce: 8 Bytes - hash of the generated proof-of-work. Null when the returned block is the pending block.

  10. number: the block number. Null when the returned block is the pending block.

  11. parentHash: 32 Bytes - hash of the parent block.

  12. receiptsRoot: 32 Bytes - the root of the receipts trie of the block.

  13. sha3Uncles: 32 Bytes - SHA3 of the uncles data in the block.

  14. size: integer the size of this block in bytes.

  15. stateRoot: 32 Bytes - the root of the final state trie of the block.

  16. timestamp: the unix timestamp for when the block was collated.

  17. totalDifficulty: integer of the total difficulty of the chain until this block.

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

  19. transactionsRoot: 32 Bytes - the root of the transaction trie of the block.

  20. uncles: an Array of uncle hashes.

Body

{
   "jsonrpc":"2.0",
   "id":1,
   "result":{
      "difficulty":"0x2",
      "extraData":"0xd883010007846765746888676f312e31352e35856c696e7578000000fc3ca6b7c2bfa0f0018488d389673b8267cc1eb7d25c0a16e92889dafa8fbd5446d55a004602c9f8c3ac3444610d8a3091376fe87d29e44bb88d5dec0b885b718ca1f36700",
      "gasLimit":"0x2dc9ffa",
      "gasUsed":"0x1e60464",
      "hash":"0x1fb2230a6b5bf856bb4df3c80cbf95b84454169a5a133fffaf8505a05f960aeb",
      "logsBloom":"0x8deb8ebc5ffd151c0764c558d00009996a5a967dce4cfa333378b128eecf03243b19d66ebc1e1d677d69fcea9e8b0722ede6bc11ba22289b0710bdf5663f72e9b27f7b57d3859c83e5bbee9a1efb98f6fe1f49a8dc6ed96bdf04ba79d077fe75ebaff72dbf5ac9eb9faaf2c33d254bf2cb3597dda5be3ff19e7f7c9794d6c5bfc2649af11955981169af274e3db41cb34c66dc85fa39cbdc7f81295cea20edd25b5a25d2e9c14d4d064ecf48b2ceee7972658213df605b661fff23aa00b013e634df65ee9200791f7595358b2fc7f17def555e1194a196b27a32f8fbe9eee19f76b94e3284d0450b493ab4ab3f640fb066bdff7dcbcbf37be82636991ff8e4ee", 
      "miner":"0x7ae2f5b9e386cd1b50a4550696d957cb4900f03a",
      "mixHash":"0x0000000000000000000000000000000000000000000000000000000000000000",
      "nonce":"0x0000000000000000",
      "number":"0x6e05b6",
      "parentHash":"0x67551efb54174d16002405e2847756e4e7555cfca44ff5823c695a8c07992c5a",
      "receiptsRoot":"0x01e794163bb70020ad2286149bd4794827aa560ca41be6f0f606e7ac50ad1734",
      "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
      "size":"0x17faa",
      "stateRoot":"0xc1414eee14dc067b8044f398f5a9b123edc56130f91a2114515d901d387a4852",
      "timestamp":"0x60950792",
      "totalDifficulty":"0xdb7f02",
      "transactions":[
         "0x2fa91f0bd9dc0ac4c3809efa40778d518968497bc585d3b478559e4cd55f4a23",
         "0x6232bd82064c316cd7ece24e8e2025670a53d31574f20f9da2b857d64f972d30",
         "0xef1ad0aa81163162ca013c375ce222a09eae4ebe8f7b567b72905e11f1258ba1",
      ],
      "transactionsRoot":"0x0f2b87218f5f85740725b04f911f6027c34ebeba808f84d02d6afb17f06399af",
      "uncles":[
      ]
   }
}

Previouseth_callNexteth_getBlockByNumber

Last updated 4 years ago

Was this helpful?

🔌