Balances

Get token balances

Returns a list of token balances.

get

/v1/tokens/balances

Query parameters

idnullable one of

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

accountnullable one of

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

token.idnullable one of

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

token.contractnullable one of

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

token.tokenIdnullable one of

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

token.standardnullable one of

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

token.metadatanullable one of

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.

balancenullable one of

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

firstLevelnullable one of

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

firstTimenullable one of

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

lastLevelnullable one of

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

lastTimenullable one of

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

indexedAtnullable one of

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

200

200

[
  {
    "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-02-06T12:41:08.981Z",
    "lastLevel": 1,
    "lastTime": "2025-02-06T12:41:08.981Z"
  }
]