Get block hash by block number

POST

https://dot.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Get the hash of a specific block by its block number.

The chain_getBlockHash method returns the hash of the block header for the specified block number. If no block number is provided, it returns the hash of the latest finalized block.

This method is essential for:

Navigating the blockchain by block height
Verifying block existence and integrity
Building block explorers
Cross-referencing blocks across different queries

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<integer | string>required

Array containing optional block number

Show child attributes

One of

Block number (height) to query

integer

Block number as hex string

string

Response

200OK

Block hash retrieved successfully

400Bad Request

Invalid block number or request

500Internal Server Error

Internal server error

Get block hash by block number

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://dot.nownodes.io/");
const result = await provider.send("chain_getBlockHash", [
  "0xbc614e"
]);
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_getBlockHash",
  "params": [
    "0xbc614e"
  ],
  "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_getBlockHash", [
  "0xbc614e"
])
print(response)

import { createPublicClient, http } from "viem";

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

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

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_getBlockHash", params: [
  "0xbc614e"
], 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_getBlockHash",
      "id": 1,
      "params": [
        "0xbc614e"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getBlockHash",
  "id": 1,
  "params": [
    "0xbc614e"
  ]
}

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_getBlockHash",
    "id": 1,
    "params": [
      "0xbc614e"
    ]
  }'

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_getBlockHash",
  "id": 1,
  "params": [
    "0xbc614e"
  ]
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Block number out of range"
  }
}

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

Documentation

How to migrate to NOWNodes

Get block hash by block number

Authorizations

Body

Response