Returns address balances and counters.

POST

wss://bsc-blockbook.nownodes.io/wss/{apiKey}

Returns confirmed and unconfirmed balances, transaction counters and (on EVM chains) the account nonce for a single address. details, tokens, page, pageSize, from, to and contractFilter mirror the REST /api/v2/address parameters.

Body

application/json

Blockbook WebSocket request for getAccountInfo, sent as a text message over the WebSocket connection.

idstringrequired

Request identifier. Subscription notifications are delivered with the same id as the subscribe request.

methodstringrequired

paramsobjectrequired

Show child attributes

descriptorstringrequired

Address, XPUB or descriptor.

detailsstringbasictokenstokenBalancestxidstxslighttxs

Detail level.

tokensstringusednonzeroderived

Token inclusion mode.

pageinteger | null

1-based transaction page.

pageSizeinteger | null

Transactions per page.

frominteger | null

Start block height filter.

tointeger | null

End block height filter.

contractFilterstring

Token contract filter.

Parameters

apiKeystringrequiredpath

NOWNodes API key. Connect to wss://bsc.nownodes.io/wss/{apiKey}. The WebSocket handshake returns HTTP 403 when the key is missing or invalid.

Response

200OK

Response delivered over the WebSocket connection as {"id": ..., "data": ...}. Errors are returned inside data.error; see BlockbookError.

403Forbidden

Forbidden. The WebSocket handshake was rejected: the API key is missing or invalid (verified live: wrong and missing keys both return HTTP 403).

Returns address balances and counters.

curl -X POST 'wss://bsc-blockbook.nownodes.io/wss/{apiKey}' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "5",
    "method": "getAccountInfo",
    "params": {
      "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
      "details": "basic",
      "tokens": "derived",
      "page": null,
      "pageSize": 10,
      "from": null,
      "to": null,
      "contractFilter": ""
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("wss://bsc-blockbook.nownodes.io/wss/{apiKey}");
const result = await provider.send("getAccountInfo", {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "details": "basic",
  "tokens": "derived",
  "page": null,
  "pageSize": 10,
  "from": null,
  "to": null,
  "contractFilter": ""
});
console.log(result);

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

uri = URI('wss://bsc-blockbook.nownodes.io/wss/{apiKey}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "getAccountInfo",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "details": "basic",
    "tokens": "derived",
    "page": null,
    "pageSize": 10,
    "from": null,
    "to": null,
    "contractFilter": ""
  },
  "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("wss://bsc-blockbook.nownodes.io/wss/{apiKey}"))
response = w3.provider.make_request("getAccountInfo", {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "details": "basic",
  "tokens": "derived",
  "page": None,
  "pageSize": 10,
  "from": None,
  "to": None,
  "contractFilter": ""
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("wss://bsc-blockbook.nownodes.io/wss/{apiKey}"),
});

const result = await client.request({
  method: "getAccountInfo",
  params: {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "details": "basic",
  "tokens": "derived",
  "page": null,
  "pageSize": 10,
  "from": null,
  "to": null,
  "contractFilter": ""
},
});

console.log(result);

const endpoint = "wss://bsc-blockbook.nownodes.io/wss/{apiKey}";
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: "getAccountInfo", params: {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "details": "basic",
  "tokens": "derived",
  "page": null,
  "pageSize": 10,
  "from": null,
  "to": null,
  "contractFilter": ""
}, id: 1 });
console.log(result);

const response = await fetch('wss://bsc-blockbook.nownodes.io/wss/{apiKey}', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": "5",
      "method": "getAccountInfo",
      "params": {
        "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
        "details": "basic",
        "tokens": "derived",
        "page": null,
        "pageSize": 10,
        "from": null,
        "to": null,
        "contractFilter": ""
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": "5",
  "method": "getAccountInfo",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "details": "basic",
    "tokens": "derived",
    "page": None,
    "pageSize": 10,
    "from": None,
    "to": None,
    "contractFilter": ""
  }
}

response = requests.post('wss://bsc-blockbook.nownodes.io/wss/{apiKey}', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('wss://bsc-blockbook.nownodes.io/wss/{apiKey}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "id": "5",
    "method": "getAccountInfo",
    "params": {
      "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
      "details": "basic",
      "tokens": "derived",
      "page": null,
      "pageSize": 10,
      "from": null,
      "to": null,
      "contractFilter": ""
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "id": "5",
  "method": "getAccountInfo",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "details": "basic",
    "tokens": "derived",
    "page": null,
    "pageSize": 10,
    "from": null,
    "to": null,
    "contractFilter": ""
  }
}

{
  "id": "5",
  "data": {
    "address": "0xba98D6a5ac827632E3457De7512d211e4ff7e8bD",
    "balance": "0",
    "unconfirmedTxs": 0,
    "txs": 0,
    "nonce": "0"
  }
}

string

Documentation

How to migrate to NOWNodes

Returns address balances and counters.

Body

Parameters

Response