Get blockchain metadata

POST

https://zil.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns high-level information about the blockchain's current state, such as DS and transaction block numbers, difficulties, and gas prices.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

idintegerrequired

Request identifier

paramsarrayrequired

Must be an empty array

Response

200OK

Blockchain metadata successfully returned

400Bad Request

Invalid request

500Internal Server Error

Server error

Get blockchain metadata

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

import { JsonRpcProvider } from "ethers";

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

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

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

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

const data = await response.json();

import requests

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

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

require 'net/http'
require 'json'

uri = URI('https://zil.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "GetBlockchainInfo",
    "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": "GetBlockchainInfo",
  "id": 1,
  "params": []
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "CurrentDSEpoch": "1250",
    "CurrentMiniEpoch": "3768",
    "NumPeers": "50",
    "NumTxBlocks": "3700",
    "NumDSBlocks": "1250",
    "NumTransactions": "180000",
    "TransactionRate": "3",
    "TxBlockRate": "1",
    "DSBlockRate": "1",
    "CurrentDifficulty": "1000000000",
    "CurrentDSDifficulty": "1500000000",
    "GasPrice": "2000000000"
  }
}

Documentation

How to migrate to NOWNodes

Get blockchain metadata

Authorizations

Body

Response