Skip to main content
EVM

eth_getUncleCountByBlockNumber

Summary: Get number of uncles by block number

This request returns the number of uncles in a block matching the given block number.

Parameters

block oneOf
required

Block number or string tag.

Block number string

Block number in hexadecimal.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Block tag enum

See the default block parameter.

  • earliest: The lowest numbered block the client has available.
  • finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination.
  • latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
  • pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool.

Enum:
"earliest"
"finalized"
"latest"
"pending"

Returns

The number of uncles in the block in hexadecimal, or null if not found.
eth_getUncleCountByBlockNumberResponse oneOf

null

Not Found (null).

string

Hex-encoded unsigned integer.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

Customize request
Parameter
Value
0x4fde9d
oneOf
  • Block number
  • Block tag
Request
curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockNumber",
    "params": ["0x4fde9d"],
    "id": 1
  }'
Example response
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x0"
}