eth_getBlockByHash

Retrieve complete block information by its hash on the Polygon network. This method returns detailed block data including transactions, block metadata, and all associated properties.

Parameters

Parameter	Type	Required	Description
blockHash	string	Yes	The hash of the block to retrieve (32-byte hex string with 0x prefix)
fullTransactionObjects	boolean	Yes	If true, returns full transaction objects; if false, returns only transaction hashes

Returns

Returns a block object with the following fields:

Field	Type	Description
number	string	Block number (hex-encoded)
hash	string	Block hash (32 bytes)
parentHash	string	Hash of the parent block (32 bytes)
nonce	string	Proof-of-work nonce (8 bytes)
sha3Uncles	string	SHA3 hash of the uncles data in the block
logsBloom	string	Bloom filter for block logs (256 bytes)
transactionsRoot	string	Root of the transaction trie (32 bytes)
stateRoot	string	Root of the final state trie (32 bytes)
receiptsRoot	string	Root of the receipts trie (32 bytes)
miner	string	Address of the block miner
difficulty	string	Difficulty level for this block
totalDifficulty	string	Total difficulty of the chain until this block
extraData	string	Extra data field of this block
size	string	Size of this block in bytes
gasLimit	string	Maximum gas allowed in this block
gasUsed	string	Total gas used by all transactions in this block
timestamp	string	Unix timestamp for when the block was collated
transactions	array	Array of transaction objects or hashes (depending on fullTransactionObjects parameter)
uncles	array	Array of uncle hashes
baseFeePerGas	string	Base fee per gas (EIP-1559, if applicable)
mixHash	string	256-bit hash for proof-of-work verification

Implementation Example

cURL

curl -X POST https://api-polygon-mainnet-full.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x4b3c1d7e6bf4b78c8c9e2f1a3d5e7f9b2c4a6d8e0f2a4c6e8d0b2f4a6c8e0d2f",
      true
    ],
    "id": 1
  }'

JavaScript

const response = await fetch('https://api-polygon-mainnet-full.n.dwellir.com/YOUR_API_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'eth_getBlockByHash',
    params: [
      '0x4b3c1d7e6bf4b78c8c9e2f1a3d5e7f9b2c4a6d8e0f2a4c6e8d0b2f4a6c8e0d2f',
      true
    ],
    id: 1
  })
});

const data = await response.json();
console.log('Polygon block data:', data.result);

Python

import requests
import json

url = 'https://api-polygon-mainnet-full.n.dwellir.com/YOUR_API_KEY'
headers = {'Content-Type': 'application/json'}

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
        "0x4b3c1d7e6bf4b78c8c9e2f1a3d5e7f9b2c4a6d8e0f2a4c6e8d0b2f4a6c8e0d2f",
        True
    ],
    "id": 1
}

response = requests.post(url, headers=headers, data=json.dumps(payload))
block_data = response.json()
print("Polygon block data:", json.dumps(block_data['result'], indent=2))

Response Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1b4",
    "hash": "0x4b3c1d7e6bf4b78c8c9e2f1a3d5e7f9b2c4a6d8e0f2a4c6e8d0b2f4a6c8e0d2f",
    "parentHash": "0xa1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
    "nonce": "0x0000000000000042",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd7f8974fb5ac78d9ac099b9ad5018bedc2ce0a72dad1827a1709da30580f0544",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x0000000000000000000000000000000000000000",
    "difficulty": "0x400000000",
    "totalDifficulty": "0x400000000",
    "extraData": "0x",
    "size": "0x220",
    "gasLimit": "0x1c9c380",
    "gasUsed": "0x0",
    "timestamp": "0x54e34e8e",
    "transactions": [],
    "uncles": [],
    "baseFeePerGas": "0x7",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
  }
}

Use Cases

• Block Verification: Verify specific block details and integrity on Polygon
• Transaction Analysis: Analyze all transactions within a specific block
• Blockchain Analytics: Track block-level metrics and network activity
• DApp Development: Integrate block data into Polygon-based applications
• Network Monitoring: Monitor Polygon network performance and block propagation

---

Need help? Contact our support team or check the Polygon documentation.