Balances

Get token balances

get

Returns a list of token balances.

Query parameters

idone of | nullableOptional

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

accountone of | nullableOptional

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

token.idone of | nullableOptional

Filter by internal TzKT id. Note, this is not the same as tokenId.
Click on the parameter to expand more details.

token.contractone of | nullableOptional

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

token.tokenIdone of | nullableOptional

Filter by tokenId (for FA1.2 tokens tokenId is always "0").
Click on the parameter to expand more details.

token.standardone of | nullableOptional

Filter by token standard (fa1.2 or fa2).
Click on the parameter to expand more details.

token.metadataone of | nullableOptional

Filter by metadata. Note, this parameter supports the following format: token.metadata{.path?}{.mode?}=..., so you can specify a path to a particular field to filter by, for example: ?token.metadata.symbol.in=kUSD,uUSD.
Click on the parameter to expand more details.

balanceone of | nullableOptional

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

firstLevelone of | nullableOptional

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

firstTimeone of | nullableOptional

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

lastLevelone of | nullableOptional

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

lastTimeone of | nullableOptional

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

indexedAtone of | nullableOptional

sortone of | nullableOptional

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 | nullableOptional

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

limitinteger · int32 · max: 10000Optional

Maximum number of items to return.

selectone of | nullableOptional

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

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /v1/tokens/balances HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "id": 1,
    "account": {
      "alias": "text",
      "address": "text"
    },
    "token": {
      "id": 1,
      "contract": {
        "alias": "text",
        "address": "text"
      },
      "tokenId": "text",
      "standard": "text",
      "totalSupply": "text",
      "metadata": null
    },
    "balance": "text",
    "balanceValue": 1,
    "transfersCount": 1,
    "firstLevel": 1,
    "firstTime": "2025-06-03T01:44:58.297Z",
    "lastLevel": 1,
    "lastTime": "2025-06-03T01:44:58.297Z"
  }
]