eth_getUncleCountByBlockHash
The eth_getUncleCountByBlockHash method returns the number of uncles in a block from a block matching the given block hash. This lightweight method allows you to quickly check how many uncle blocks are referenced in a specific block without fetching the complete block data.
This method is useful for blockchain statistics, mining analysis, network health monitoring, and historical research. A high uncle count indicates network propagation issues or high mining competition. Note that uncle blocks only exist in Proof of Work Ethereum (pre-Merge, before September 2022), so recent blocks will always return 0x0. Each block can reference up to 2 uncle blocks maximum.
Parameters
parameter | type | description |
|---|---|---|
blockHash | string (required) | Hash of the block (32 bytes) |
Return Object
field | type | description |
|---|---|---|
result | string | The number of uncles in the specified block encoded as a hexadecimal string |
Request Example
Request
Response Example
Response