Balance history

Get balance at level

get

Returns account balance at the specified block

Path parameters
addressstringRequired

Account address (starting with tz or KT)

levelinteger · int32Required

Block height at which you want to know account balance

Responses
200Success
application/json
Responseinteger · int64
get
GET /v1/accounts/{address}/balance_history/{level} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*
200Success
1

Get balance at date

get

Returns account balance at the specified datetime

Path parameters
addressstringRequired

Account address (starting with tz or KT)

datetimestring · date-timeRequired

Datetime at which you want to know account balance (e.g. 2020-01-01, or 2019-12-30T23:42:59Z)

Responses
200Success
application/json
Responseinteger · int64
get
GET /v1/accounts/{address}/balance_history/{datetime} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*
200Success
1

Get balance history

get

Returns time series with historical balances (only changes, without duplicates).

Path parameters
addressstringRequired

Account address (starting with tz or KT)

Query parameters
stepinteger · int32 | nullableOptional

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

selectone of | nullableOptional

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.

sortone of | nullableOptional

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

offsetinteger · int32Optional

Specifies which or how many items should be skipped

Default: 0
limitinteger · int32 · max: 10000Optional

Maximum number of items to return

Default: 100
quoteone ofOptional

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

Default: None
string · enumOptionalPossible values:
Responses
200Success
application/json
get
GET /v1/accounts/{address}/balance_history HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*
200Success
[
  {
    "level": 1,
    "timestamp": "2025-07-14T00:45:42.777Z",
    "balance": 1,
    "quote": {
      "btc": 1,
      "eur": 1,
      "usd": 1,
      "cny": 1,
      "jpy": 1,
      "krw": 1,
      "eth": 1,
      "gbp": 1
    }
  }
]
PreviousBalanceNextReport