Historical balances

Get historical ticket balances

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

get

/v1/tickets/historical_balances/{level}

Path parameters

levelinteger int32required

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

Query parameters

idnullable one of

Filter by internal TzKT id. Click on the parameter to expand more details.

ticket.idnullable one of

Filter by internal TzKT id. Click on the parameter to expand more details.

ticket.ticketernullable one of

Filter by ticketer address.
Click on the parameter to expand more details.

accountnullable one of

Filter by account address.
Click on the parameter to expand more details.

balancenullable one of

Filter by balance.
Click on the parameter to expand more details.

sortnullable one of

Sorts items (asc or desc) by the specified field. You can see what fields can be used for sorting in the response description, below.
Click on the parameter to expand more details.

offsetnullable one of

Specifies which or how many items should be skipped.
Click on the parameter to expand more details.

limitinteger int32

Maximum number of items to return.

selectnullable one of

Specify a comma-separated list of fields to include into response or leave it undefined to get default set of fields. This parameter accepts values of the following format: {field}{path?}{as alias?}, so you can do deep selection (for example, ?select=balance,token.metadata.symbol as token,...).
Note, if you select just one field, the response will be flatten into a simple array of values.
Click on the parameter to expand the details.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}'

200

200

[
  {
    "id": 1,
    "ticket": {
      "id": 1,
      "ticketer": {
        "alias": "text",
        "address": "text"
      },
      "rawType": {
        "type": 0
      },
      "rawContent": {
        "type": 0
      },
      "content": null,
      "typeHash": 1,
      "contentHash": 1
    },
    "account": {
      "alias": "text",
      "address": "text"
    },
    "balance": "text"
  }
]