Get Block Header

POST

https://dot-assethub.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the header of the most recent (best) block in the Polkadot blockchain.

This method is part of the Polkadot JSON-RPC 2.0 specification for chain-related operations. The header contains critical information about the block including hashes, roots, and consensus data.

Body

application/json

jsonrpcstring2.0required

The JSON-RPC protocol version. Must be exactly "2.0".

methodstringchain_getHeaderrequired

The JSON-RPC method to call. For this endpoint, must be "chain_getHeader".

paramsArray<any>required

Parameters for the method. For chain_getHeader, this should be an empty array as it retrieves the latest block header without additional parameters.

idinteger<int32>required

Request identifier that will be returned in the response. Used to match requests with responses when making multiple concurrent calls.

Response

200OK

Successful response containing the block header information.

The header represents the most recent block in the best chain and contains cryptographic commitments to the block's contents and state.

400Bad Request

Bad Request - Invalid JSON-RPC request Possible reasons:

Invalid JSON syntax
Missing required fields
Invalid method name
Invalid parameters

500Internal Server Error

Internal Server Error The node encountered an internal error while processing the request.

503Service Unavailable

Service Unavailable The node is currently unavailable, possibly due to maintenance or synchronization.

Get Block Header

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

import { JsonRpcProvider } from "ethers";

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

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

uri = URI('https://dot-assethub.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "chain_getHeader",
  "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-assethub.nownodes.io/"))
response = w3.provider.make_request("chain_getHeader", [])
print(response)

import { createPublicClient, http } from "viem";

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

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

console.log(result);

const endpoint = "https://dot-assethub.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_getHeader", params: [], id: 1 });
console.log(result);

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

const data = await response.json();

import requests

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

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

require 'net/http'
require 'json'

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "parentHash": "0x8f9c2b45286b9d241e43299a980aec6674aacc000fb3682d178f0116a0e09c0a",
    "number": "0x1b67a92",
    "stateRoot": "0x5df4b77648285c0b4ee27fdf52e4566c48990b5357058b5fcc492bff2e8aa87e",
    "extrinsicsRoot": "0xbee43c93d0459704b769eac77fd999099aa9a443501df7057df0f8761fef1472",
    "digest": {
      "logs": [
        "0x0642414245b501036700000068608511000000005e76194dbd931c0eec4b706d3e362725dda289c581a61189cf3fe246596a87717ce5ec5146bf1ff0952733eeaf992548990b7e4bbdc3a4a73eae788f5cf862083bf9f2f1ce9119558aa04ba7c98acd9e6b4713252868a661912bf5b098ae9003",
        "0x044245454684036a4f28650461c9c3bfadc940a61e35a243c8a016acd160bb21e3b573392c6e83",
        "0x05424142450101bab5e08f59e82f4f25d55dcf31dda08b2f54264404f386ddc4b273b5a48ac64294e0d59fc5dacdab63a8ef295844da8e82dfc9de35c9f0f9bbf2efe21e9eaf81"
      ]
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Server unavailable"
  }
}

Documentation

How to migrate to NOWNodes

Get Block Header

Authorizations

Body

Response