Get account balance history.

GET

https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: A request that spans more than 100,000 transactions in the selected from/to range is now rejected with an error asking to narrow the range, instead of being processed in full. XPUB/descriptor scans are bounded: gap is capped at 10,000, a descriptor may list at most 10 change indexes, and a descriptor whose total derivation scan exceeds the server limit is rejected with an error. Documented as it exists in 0.6.0.

Returns balance history points for an address, XPUB, or descriptor. from and to are Unix timestamps. groupBy is an aggregation interval in seconds and defaults to 3600. When fiatcurrency is omitted, rates can contain all available currencies. sentToSelf is the amount sent from an address to itself or within addresses of the same XPUB.

Load estimate: High; grows with account transaction history, time span, grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

Balance history points.

400Bad Request

Bad Request

401Unauthorized

Unauthorized. Returned when the api-key header is missing, empty, or not accepted by the NOWNodes gateway. The body is plain text.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Unprocessable Entity. Returned by the NOWNodes gateway for requests it accepts but cannot process. The body is plain text.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Get account balance history.

curl -X GET 'https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}'

const response = await fetch('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

const response = await fetch('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://pivxbook.nownodes.io/api/v2/balancehistory/{descriptor}')
request = Net::HTTP::Get.new(uri)

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

[
  {
    "time": 1785898800,
    "txs": 5,
    "received": "627791049",
    "sent": "0",
    "sentToSelf": "100000",
    "rates": {
      "usd": 64345.492,
      "eur": 55589.92
    }
  },
  {
    "time": 1785902400,
    "txs": 1,
    "received": "0",
    "sent": "627791049",
    "sentToSelf": "0",
    "rates": {
      "usd": 64107.65,
      "eur": 55589.92
    }
  }
]

[
  {
    "time": 1785898800,
    "txs": 5,
    "received": "627791049",
    "sent": "0",
    "sentToSelf": "0",
    "rates": {
      "usd": 64345.492
    }
  },
  {
    "time": 1785902400,
    "txs": 1,
    "received": "0",
    "sent": "627791049",
    "sentToSelf": "0",
    "rates": {
      "usd": 64107.65
    }
  }
]

[
  {
    "time": 1786147200,
    "txs": 1,
    "received": "50820000000",
    "sent": "50420000000",
    "sentToSelf": "50820000000",
    "rates": {
      "aed": 7044.44,
      "ars": 2875319,
      "aud": 2714.25,
      "bch": 8.844139,
      "bdt": 236736,
      "bhd": 721.21,
      "bits": 29515,
      "bmd": 1918.16,
      "bnb": 3.228218,
      "brl": 9777.43,
      "btc": 0.02951481,
      "cad": 2675.93,
      "chf": 1549.91,
      "clp": 1752352,
      "cny": 12942,
      "czk": 40247,
      "dkk": 12406.65,
      "dot": 2351,
      "eos": 29651,
      "eth": 1,
      "eur": 1659.31,
      "gbp": 1421.81,
      "gel": 5006.39,
      "hkd": 15045.94,
      "huf": 602964,
      "idr": 34145624,
      "ils": 5754.19,
      "inr": 182491,
      "jpy": 302695,
      "krw": 2700555,
      "kwd": 589.28,
      "link": 231.348,
      "lkr": 641471,
      "ltc": 42.12681,
      "mmk": 4027499,
      "mxn": 32870,
      "myr": 7845.46,
      "ngn": 2618017,
      "nok": 18246.23,
      "nzd": 3255.81,
      "php": 116442,
      "pkr": 530939,
      "pln": 7126.29,
      "rub": 157799,
      "sar": 7209.65,
      "sats": 2951481,
      "sek": 18185.67,
      "sgd": 2451.6,
      "sol": 25.63705,
      "thb": 63097,
      "try": 91491,
      "twd": 61862,
      "uah": 85653,
      "usd": 1918.16,
      "vnd": 50264370,
      "xag": 30.17,
      "xau": 0.441752,
      "xdr": 1353.49,
      "xlm": 11724,
      "xrp": 1852,
      "yfi": 0.92590797,
      "zar": 30971
    }
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Missing address"
}