eth_getUncleCountByBlockNumber

Get Uncle Count By Block Number

POSThttps://site1.moralis-nodes.com/:chain/:apiKey

Returns the number of uncle blocks included in a block, identified by the block number. This method sheds light on the blockchain's branching behavior and the role of uncle blocks in enhancing network security.

Note

Please refer to RPC schema page for more details on the RPC params and RPC response definitions of the RPC method.

PATH PARAMS

chainstringrequired

The blockchain to interact with.

ethholeskypolygonamoybscbsc testnetarbitrumarbitrum sepoliaoptimismoptimism testnetbasebase sepolia

apiKeystringrequired

Your API key for authentication.

BODY PARAM

jsonrpcstringrequired

JSON-RPC version (typically 2.0).

idnumberrequired

The request identifier.

methodstringrequired

The JSON-RPC method being invoked.

paramsrpcArrayrequired

Parameters for the method, including the block number. The block number can be specified as a hexadecimal value or using the tags 'latest', 'earliest', or 'pending'.

[ "latest" ]

Responses

Node.js

// Dependencies to install:
// $ npm install node-fetch --save
// add "type": "module" to package.json

import fetch from 'node-fetch';

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getUncleCountByBlockNumber"
  })
};

fetch('https://site1.moralis-nodes.com/eth/YOUR_API_KEY', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

# Dependencies to install:

# $ python -m pip install requests

import requests

url = "https://site1.moralis-nodes.com/eth/YOUR_API_KEY"

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getUncleCountByBlockNumber"
}
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

cURL

curl --request POST \
     --url 'https://site1.moralis-nodes.com/eth/YOUR_API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getUncleCountByBlockNumber"
}
'

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://site1.moralis-nodes.com/eth/YOUR_API_KEY"

  payload := strings.NewReader("{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getUncleCountByBlockNumber\"}")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://site1.moralis-nodes.com/eth/YOUR_API_KEY', [
  'body' => '{"jsonrpc":"2.0","id":1,"method":"eth_getUncleCountByBlockNumber"}',
  'headers' => [
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the number of uncle blocks included in the specified block.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x2"
}