Returns balance history points.

POST

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

Returns aggregated balance history for an address or descriptor. from and to are Unix timestamps; groupBy is the aggregation interval in seconds (default 3600); currencies filters fiat rates. Verified live: an address without history returns an empty array, and a range that spans more than 1000000 transactions is rejected with a data.error message. Live error example for an over-wide range: "balance history spans more than 1000000 transactions in the requested range; narrow the from/to range".

Body

application/json

Blockbook WebSocket request for getBalanceHistory, 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.

frominteger | null

Unix timestamp lower bound.

tointeger | null

Unix timestamp upper bound.

currenciesArray<string>

Fiat currency filter.

groupByinteger | null

Aggregation interval in seconds.

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 balance history points.

curl -X POST 'wss://bsc-blockbook.nownodes.io/wss/{apiKey}' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "7",
    "method": "getBalanceHistory",
    "params": {
      "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
      "from": null,
      "to": null,
      "currencies": [
        ""
      ],
      "groupBy": null
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("wss://bsc-blockbook.nownodes.io/wss/{apiKey}");
const result = await provider.send("getBalanceHistory", {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "from": null,
  "to": null,
  "currencies": [
    ""
  ],
  "groupBy": null
});
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": "getBalanceHistory",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "from": null,
    "to": null,
    "currencies": [
      ""
    ],
    "groupBy": null
  },
  "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("getBalanceHistory", {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "from": None,
  "to": None,
  "currencies": [
    ""
  ],
  "groupBy": None
})
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: "getBalanceHistory",
  params: {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "from": null,
  "to": null,
  "currencies": [
    ""
  ],
  "groupBy": null
},
});

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: "getBalanceHistory", params: {
  "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
  "from": null,
  "to": null,
  "currencies": [
    ""
  ],
  "groupBy": null
}, 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": "7",
      "method": "getBalanceHistory",
      "params": {
        "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
        "from": null,
        "to": null,
        "currencies": [
          ""
        ],
        "groupBy": null
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": "7",
  "method": "getBalanceHistory",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "from": None,
    "to": None,
    "currencies": [
      ""
    ],
    "groupBy": None
  }
}

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": "7",
    "method": "getBalanceHistory",
    "params": {
      "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
      "from": null,
      "to": null,
      "currencies": [
        ""
      ],
      "groupBy": null
    }
  }'

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

Request Body

{
  "id": "7",
  "method": "getBalanceHistory",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "from": null,
    "to": null,
    "currencies": [
      ""
    ],
    "groupBy": null
  }
}

{
  "id": "7",
  "data": []
}

string

Documentation

How to migrate to NOWNodes

Returns balance history points.

Body

Parameters

Response