TriportRPC
DashboardDocs

eth_getUncleCountByBlockHash

Last updated:

eth_getUncleCountByBlockHash looks up a block by its 32-byte hash and returns how many uncle (ommer) blocks it references, encoded as a 0x-prefixed hexadecimal string.

Uncles were a feature of Ethereum's proof-of-work era: stale blocks that were mined at nearly the same height as a canonical block and rewarded for their work. Since The Merge (proof-of-stake), Ethereum no longer produces uncles, so for any post-Merge block this method returns 0x0. The method remains available for inspecting historical pre-Merge blocks, where the count can be non-zero.

If no block matches the supplied hash (e.g. it belongs to an orphaned block, or the node has not yet seen it), the method returns null instead of an error. Always check for null before parsing the result as a number.

Parameters

This method takes no parameters.

Returns

eth_getUncleCountByBlockHash return value
FieldType
resultobject

Examples

curl https://triport.io/eth \
  -X POST -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <api-key>' \
  -d '{"id":1,"method":"eth_getUncleCountByBlockHash","params":[],"jsonrpc":"2.0"}'
const res = await fetch("https://triport.io/eth", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer <api-key>" },
  body: JSON.stringify({
  "id": 1,
  "method": "eth_getUncleCountByBlockHash",
  "params": [],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post(
    "https://triport.io/eth",
    headers={"Authorization": "Bearer <api-key>"},
    json={"id":1,"method":"eth_getUncleCountByBlockHash","params":[],"jsonrpc":"2.0"},
)
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet.
  3. Credit cost: 1 per call.

FAQ

What does eth_getUncleCountByBlockHash do?
Returns the number of uncle (ommer) blocks referenced by the block identified by its block hash.
How many credits does eth_getUncleCountByBlockHash cost?
eth_getUncleCountByBlockHash costs 1 credit(s) per call on Triport by default.
Is eth_getUncleCountByBlockHash available over WebSocket?
eth_getUncleCountByBlockHash is an HTTP JSON-RPC method.