Get Block by Hash or Height

POST

https://ont.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves information about a specific block from the ONT blockchain. The block can be identified by either its hash or its height (block number). The response can be returned in different verbosity levels (0, 1, or 2).

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version. Must be "2.0" for JSON-RPC 2.0 specification compliance.

methodstringrequired

The RPC method name. For this operation, it must be "getblock".

paramsArray<string | integer | integer>required

An array containing two parameters:

Block hash or height (string or integer)
Verbosity level (0, 1, or 2) - determines the detail level of the response

Show child attributes

One of

Block hash in hexadecimal format

string

Block height (block number)

integer

Verbosity level

integer012

idintegerrequired

A unique identifier for the request, used to correlate the response with the request.

Response

200OK

Successful response containing detailed block information.

Get Block by Hash or Height

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://ont.nownodes.io/");
const result = await provider.send("getblock", [
  "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
  1
]);
console.log(result);

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

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

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

const data = await response.json();

import requests

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

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

require 'net/http'
require 'json'

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x5e8e8ff715441dd816ed727e1d240ad23310d884427dbbf4282f740671778e1c",
    "size": 1234,
    "header": {
      "version": 0,
      "prevblockhash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "merkleroot": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "timestamp": 1577836800,
      "height": 12345,
      "consensusdata": "0x0000000000000000",
      "nextconsensus": "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK"
    },
    "tx": [
      {
        "txid": "0xf4250dab094c38d8265acc15c366dc508d2e14bf5699e12d9df26577ed0d212a",
        "size": 234,
        "type": "InvocationTransaction",
        "nonce": 0,
        "gasPrice": "500",
        "gasLimit": "20000",
        "payer": "AFmseVrdL9f9oyCzZefL9tG6UbviEH9ugK"
      }
    ]
  }
}

Documentation

How to migrate to NOWNodes

Get Block by Hash or Height

Authorizations

Body

Response