Get balance history

GET

https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns time series with historical balances* (only changes, without duplicates). * - for non-baker tz-accounts historical balances do not include staked tez, because stakers do not really have staked tez on their balance, they have staking pseudotokens instead. If you want to.

Parameters

addressstringrequiredpath

Account address (starting with tz or KT)

stepinteger<int32> | nullquery

Step of the time series, for example if step = 1000 you will get balances at blocks 1000, 2000, 3000, ....

selectobject | nullquery

Specify comma-separated list of fields to include into response or leave it undefined to return full object. If you select single field, response will be an array of values in both .fields and .values modes.

sortobject | nullquery

Sorts historical balances by specified field. Supported fields: level.

offsetinteger<int32>0query

Specifies which or how many items should be skipped

limitinteger<int32>[0, 10000]100query

Maximum number of items to return

quotestringNoneBtcEurUsdCnyJpyKrwEthGbpNonequery

Comma-separated list of ticker symbols to inject historical prices into response

Response

200OK

Successful response.

400Bad Request

Invalid request.

Get balance history

curl -X GET 'https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history'

const response = await fetch('https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history')
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://xtz-index.nownodes.io/v1/accounts/{address}/balance_history')
data = response.json()

const response = await fetch('https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history";
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://xtz-index.nownodes.io/v1/accounts/{address}/balance_history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/accounts/{address}/balance_history')
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)

[
  {
    "level": 15268314,
    "timestamp": "2026-10-07T10:21:25Z",
    "balance": 1
  }
]

{
  "error": "Invalid request parameters."
}