Balances

Get ticket balances

Returns a list of ticket balances.

get

/v1/tickets/balances

Query parameters

idone of | nullable

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

ticket.idone of | nullable

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

ticket.ticketerone of | nullable

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

ticket.rawTypeone of | nullable

Filter by ticket content type in Micheline format.
Click on the parameter to expand more details.

ticket.rawContentone of | nullable

Filter by ticket content in Micheline format.
Click on the parameter to expand more details.

ticket.contentone of | nullable

Filter by ticket content in JSON format.
Note, this parameter supports the following format: content{.path?}{.mode?}=..., so you can specify a path to a particular field to filter by (for example, ?content.color.in=red,green).
Click on the parameter to expand more details.

ticket.typeHashone of | nullable

Filter by 32-bit hash of ticket content type.
Click on the parameter to expand more details.

ticket.contentHashone of | nullable

Filter by 32-bit hash of ticket content.
Click on the parameter to expand more details.

accountone of | nullable

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

balanceone of | nullable

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

transfersCountone of | nullable

Filter by number of transfers.
Click on the parameter to expand more details.

firstLevelone of | nullable

Filter by level of the block where the balance was first changed.
Click on the parameter to expand more details.

firstTimeone of | nullable

Filter by timestamp (ISO 8601) of the block where the balance was first changed.
Click on the parameter to expand more details.

lastLevelone of | nullable

Filter by level of the block where the balance was last changed.
Click on the parameter to expand more details.

lastTimeone of | nullable

Filter by timestamp (ISO 8601) of the block where the balance was last changed.
Click on the parameter to expand more details.

sortone of | nullable

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.

offsetone of | nullable

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

limitinteger · int32 · max: 10000

Maximum number of items to return.

selectone of | nullable

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/balances'

200

200

[
  {
    "id": 1,
    "ticket": {
      "id": 1,
      "ticketer": {
        "alias": "text",
        "address": "text"
      },
      "rawType": {
        "type": 0
      },
      "rawContent": {
        "type": 0
      },
      "content": null,
      "typeHash": 1,
      "contentHash": 1,
      "totalSupply": "text"
    },
    "account": {
      "alias": "text",
      "address": "text"
    },
    "balance": "text",
    "transfersCount": 1,
    "firstLevel": 1,
    "firstTime": "2025-03-14T00:27:19.560Z",
    "lastLevel": 1,
    "lastTime": "2025-03-14T00:27:19.560Z"
  }
]