Skip to main content
POST
/
evm
eth_getUncleCountByBlockNumber
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockNumber",
  "params": [
    "latest"
  ],
  "id": 1
}
'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}
This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.
Returns the number of uncle blocks for a given block number. Use this method to get the count of uncle (ommer) blocks associated with a block identified by its number.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • blockNumber (string, required) — Block number in hex format, or one of the special tags: “earliest”, “latest”, “pending”, or “finalized”

​
Returns

Returns the number of uncle blocks as a hex-encoded integer, or null if the block is not found.
On Hyperliquid, uncle blocks are not part of the consensus mechanism. This method is included for Ethereum compatibility but will typically return “0x0” as Hyperliquid doesn’t produce uncle blocks.

​
Use cases

  • Ethereum compatibility — Maintain compatibility with Ethereum RPC interfaces
  • Network monitoring — Track uncle block production across different block heights
  • Performance analysis — Analyze network efficiency and block production patterns
  • Compatibility testing — Verify application behavior when migrating from Ethereum
  • Protocol comparison — Compare consensus mechanisms between networks
  • API completeness — Implement full Ethereum RPC compatibility

Body

application/json
​
jsonrpc
enum<string>
default:2.0
required

JSON-RPC version

Available options:
2.0
​
method
enum<string>
default:eth_getUncleCountByBlockNumber
required

The RPC method name

Available options:
eth_getUncleCountByBlockNumber
​
params
array
required

Parameters: [blockNumber]

​
id
integer
default:1
required

Request identifier

Response

200 - application/json

Successful response with uncle count

​
jsonrpc
string

JSON-RPC version

​
id
integer

Request identifier

​
result
string

Number of uncle blocks as hex-encoded integer, or null if block not found

Last modified on May 18, 2026