Get latest finalized block hash

POST

https://dot.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Get the hash of the most recent finalized block.

The chain_getFinalizedHead method returns the block hash of the latest block that has been finalized by the GRANDPA finality gadget. Finalized blocks are irreversible and cannot be reorganized, providing the highest level of security for applications.

This method is crucial for:

Determining safe block height for transactions
Building applications that require finality guarantees
Monitoring chain progression and stability
Ensuring data consistency across services

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getFinalizedHeadrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Finalized block hash retrieved successfully

500Internal Server Error

Internal server error

Get latest finalized block hash

curl -X POST 'https://dot.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getFinalizedHead",
    "id": 1,
    "params": []
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://dot.nownodes.io/");
const result = await provider.send("chain_getFinalizedHead", []);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://dot.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "params": [],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://dot.nownodes.io/"))
response = w3.provider.make_request("chain_getFinalizedHead", [])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://dot.nownodes.io/"),
});

const result = await client.request({
  method: "chain_getFinalizedHead",
  params: [],
});

console.log(result);

const endpoint = "https://dot.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "chain_getFinalizedHead", params: [], id: 1 });
console.log(result);

const response = await fetch('https://dot.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getFinalizedHead",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "id": 1,
  "params": []
}

response = requests.post('https://dot.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://dot.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "chain_getFinalizedHead",
    "id": 1,
    "params": []
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "id": 1,
  "params": []
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving finalized head"
  }
}

Documentation

How to migrate to NOWNodes

Get latest finalized block hash

Authorizations

Body

Response