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

Share on
Share on FacebookShare on XShare on LinkedIn
Did you find this page useful?