Returns the block hash for a height.

POST

wss://bsc-blockbook.nownodes.io/wss/{apiKey}

Returns the hash of the block at the given height on the main chain. Verified live: heights outside the range kept by this indexer (for example 1000000 or 0 on BSC) return an empty string in hash instead of an error.

Body

application/json

Blockbook WebSocket request for getBlockHash, sent as a text message over the WebSocket connection.

idstringrequired

Request identifier. Subscription notifications are delivered with the same id as the subscribe request.

methodstringrequired

paramsobjectrequired

Show child attributes

heightintegerrequired

Block height.

Parameters

apiKeystringrequiredpath

NOWNodes API key. Connect to wss://bsc.nownodes.io/wss/{apiKey}. The WebSocket handshake returns HTTP 403 when the key is missing or invalid.

Response

200OK

Response delivered over the WebSocket connection as {"id": ..., "data": ...}. Errors are returned inside data.error; see BlockbookError.

403Forbidden

Forbidden. The WebSocket handshake was rejected: the API key is missing or invalid (verified live: wrong and missing keys both return HTTP 403).

Returns the block hash for a height.

curl -X POST 'wss://bsc-blockbook.nownodes.io/wss/{apiKey}' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "4",
    "method": "getBlockHash",
    "params": {
      "height": 118649759
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("wss://bsc-blockbook.nownodes.io/wss/{apiKey}");
const result = await provider.send("getBlockHash", {
  "height": 118649759
});
console.log(result);

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

uri = URI('wss://bsc-blockbook.nownodes.io/wss/{apiKey}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "getBlockHash",
  "params": {
    "height": 118649759
  },
  "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("wss://bsc-blockbook.nownodes.io/wss/{apiKey}"))
response = w3.provider.make_request("getBlockHash", {
  "height": 118649759
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("wss://bsc-blockbook.nownodes.io/wss/{apiKey}"),
});

const result = await client.request({
  method: "getBlockHash",
  params: {
  "height": 118649759
},
});

console.log(result);

const endpoint = "wss://bsc-blockbook.nownodes.io/wss/{apiKey}";
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: "getBlockHash", params: {
  "height": 118649759
}, id: 1 });
console.log(result);

const response = await fetch('wss://bsc-blockbook.nownodes.io/wss/{apiKey}', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": "4",
      "method": "getBlockHash",
      "params": {
        "height": 118649759
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": "4",
  "method": "getBlockHash",
  "params": {
    "height": 118649759
  }
}

response = requests.post('wss://bsc-blockbook.nownodes.io/wss/{apiKey}', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('wss://bsc-blockbook.nownodes.io/wss/{apiKey}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "id": "4",
    "method": "getBlockHash",
    "params": {
      "height": 118649759
    }
  }'

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

Request Body

{
  "id": "4",
  "method": "getBlockHash",
  "params": {
    "height": 118649759
  }
}

{
  "id": "4",
  "data": {
    "hash": "0xcfa6b8cade5001838da97753d8159e086611d9dca232e7d04209c21909f1993d"
  }
}

string

Documentation

How to migrate to NOWNodes

Returns the block hash for a height.

Body

Parameters

Response