Get the balance of an address

POST

https://vinu.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves the balance (in wei) of a given address. You can specify the block parameter to get the balance at a specific block.

State access is limited to recent blocks - these are full nodes, not archive nodes. In practice only the last dozen or so blocks resolve; deeper block parameters return -32000 missing trie node <hash> (path ). earliest also works, since genesis state is kept. Use latest or pending for anything that must not fail: the pruning boundary moves continuously, so a height taken from eth_blockNumber can already be out of range by the time you query it.

Block, transaction and receipt history is complete back to block 1 - only state is pruned.

Block tags accepted by this node: earliest, latest, pending, or a hex block number. safe and finalized are NOT supported and fail with -32602 invalid argument N: hex string without 0x prefix - Lachesis aBFT finalises immediately, so there is no separate safe/finalized head.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string | string>required

Array with 2 parameters:

Address (20-byte hex string with '0x' prefix)
Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)

Show child attributes

One of

address

string

Block tag

string

idintegerrequired

Request ID

Response

200OK

Balance (in wei) as hex string

405Method Not Allowed

Method not served by this endpoint. The body is the plain-text string Method Not Allowed, not JSON.

422Unprocessable Entity

Missing API key - the api-key header was absent. The body is the plain-text string Missing API_key, not JSON.

Get the balance of an address

curl -X POST 'https://vinu.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY' \
  -d '{"jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x1b409ffc459802fbaa4a3797e86beb9a001b318e", "latest"], "id": 1}'

import { FetchRequest, JsonRpcProvider } from "ethers";

const request = new FetchRequest("https://vinu.nownodes.io/");
request.setHeader("api-key", "YOUR_API_KEY");

const provider = new JsonRpcProvider(request);
const result = await provider.send("eth_getBalance", ["0x1b409ffc459802fbaa4a3797e86beb9a001b318e", "latest"]);
console.log(result);

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

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x1b409ffc459802fbaa4a3797e86beb9a001b318e", "latest"], "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://vinu.nownodes.io/",
    request_kwargs={"headers": {"api-key": "YOUR_API_KEY"}},
))

response = w3.provider.make_request("eth_getBalance", [
    "0x1b409ffc459802fbaa4a3797e86beb9a001b318e",
    "latest",
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://vinu.nownodes.io/", {
    fetchOptions: { headers: { "api-key": "YOUR_API_KEY" } },
  }),
});

const result = await client.request({
  method: "eth_getBalance",
  params: ["0x1b409ffc459802fbaa4a3797e86beb9a001b318e", "latest"],
});

console.log(result);

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

const response = await fetch('https://vinu.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [
      "0x1b409ffc459802fbaa4a3797e86beb9a001b318e",
      "latest"
    ],
    "id": 1
  }),
});

const data = await response.json();

import requests

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [
        "0x1b409ffc459802fbaa4a3797e86beb9a001b318e",
        "latest",
    ],
    "id": 1,
}

response = requests.post(
    "https://vinu.nownodes.io/",
    json=payload,
    headers={"api-key": "YOUR_API_KEY"},
)

print(response.json())

require 'net/http'
require 'json'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x1b409ffc459802fbaa4a3797e86beb9a001b318e", "latest"], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x1b409ffc459802fbaa4a3797e86beb9a001b318e",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0234c8a3397aab58"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Method Not Allowed

Missing API_key