Get Balance

POST

https://ont.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the ONT (Ontology) and ONG (Ontology Gas) balance for a specified account address. The ONG balance includes both available and unbound portions.

Body

application/json

jsonrpcstring

The JSON-RPC protocol version. Always "2.0".

methodstring

The RPC method name to be invoked.

paramsArray<string>

An array containing the Ontology account address to query.

idinteger

The request identifier used to match the response with the request.

Response

200OK

Successful response with account balance information.

Get Balance

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

import { JsonRpcProvider } from "ethers";

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

import { createPublicClient, http } from "viem";

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

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

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: "getbalance", params: [
  "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
], 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": "getbalance",
      "params": [
        "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getbalance",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "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": "getbalance",
    "params": [
      "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
    ],
    "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": "getbalance",
  "params": [
    "ANH5eoE1mzyzFsH27FHqmPYSm414Z6W7LX"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "ont": "1000",
    "ong": "500.123456789"
  }
}

Documentation

How to migrate to NOWNodes

Get Balance

Authorizations

Body

Response