Get account balance history.

GET

https://xvg-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 0.6.0: balance-history queries are rate-limited per client and batch fiat lookups are capped at 1000 timestamps. 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

HTTP 200 Verge Blockbook response for getBalanceHistory.

400Bad Request

Domain or validation error. live-verified: JSON body {"error": "..."} (unknown block/transaction, invalid address, malformed broadcast hex, missing filter parameters).

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes (and for the v1 GET broadcast route on this instance).

500Internal Server Error

Internal Server Error. live-verified on the deployed instance: JSON body {"error":"Internal server error"} (observed on /api/rawtx and invalid XPUB lookups).

Get account balance history.

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

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xvg-blockbook.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://xvg-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

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

const data = await response.json();

const endpoint = "https://xvg-blockbook.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://xvg-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://xvg-blockbook.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": 1788566400,
    "txs": 1,
    "received": "3034124",
    "sent": "0",
    "sentToSelf": "0"
  }
]

{
  "error": "Invalid address, checksum mismatch"
}

{
  "error": "Invalid address, checksum mismatch"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}