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

application/json

integer · int64Optional

get

HTTPcURLJavaScriptPython

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

application/json

integer · int64Optional

get

HTTPcURLJavaScriptPython

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

Responses

application/json

object[]Optional

get

HTTPcURLJavaScriptPython

GET /v1/accounts/{address}/balance_history HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "level": 1,
    "timestamp": "2025-04-23T18:34:11.181Z",
    "balance": 1,
    "quote": {
      "btc": 1,
      "eur": 1,
      "usd": 1,
      "cny": 1,
      "jpy": 1,
      "krw": 1,
      "eth": 1,
      "gbp": 1
    }
  }
]