Historical balances

Get historical token balances

Returns a list of token balances at the end of the specified block. Note, this endpoint is quite heavy, therefore at least one of the filters (account, token.id, token.contract with token.tokenId) must be specified.

GEThttps://xtz-index.nownodes.io/v1/tokens/historical_balances/{level}

Path parameters

level*integer (int32)

Level of the block at the end of which historical balances must be calculated

Query parameters

Response

200

Body

application/json

accountnullable one of

Owner account.
Click on the field to expand more details.

Alias (object)

tokennullable one of

Token info.
Click on the field to expand more details.

TokenInfo (object)

balancenullable string

Balance (raw value, not divided by decimals).
[sortable]

Request

JavaScriptCurlPython

const response = await fetch('https://xtz-index.nownodes.io/v1/tokens/historical_balances/{level}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "account": {
      "alias": "text",
      "address": "text"
    },
    "token": {
      "contract": {
        "alias": "text",
        "address": "text"
      },
      "tokenId": "text",
      "standard": "text",
      "totalSupply": "text"
    },
    "balance": "text"
  }
]