Transfers

Get token transfers

Returns a list of token transfers.

get

/v1/tokens/transfers

Query parameters

idnullable one of

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

levelnullable one of

Filter by level of the block where the transfer was made.
Click on the parameter to expand more details.

timestampnullable one of

Filter by timestamp (ISO 8601) of the block where the transfer was made.
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.

anyofnullable one of

Filter by any of the specified fields (from or to). Example: anyof.from.to=tz1... will return transfers where from OR to is equal to the specified value. This parameter is useful when you need to get both incoming and outgoing transfers of the account at once.
Click on the parameter to expand more details.

fromnullable one of

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

tonullable one of

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

amountnullable one of

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

transactionIdnullable one of

Filter by id of the transaction, caused the token transfer.
Click on the parameter to expand more details.

originationIdnullable one of

Filter by id of the origination, caused the token transfer.
Click on the parameter to expand more details.

migrationIdnullable one of

Filter by id of the migration, caused the token transfer.
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/transfers'

200

200

[
  {
    "id": 1,
    "level": 1,
    "timestamp": "2025-02-06T13:03:05.702Z",
    "token": {
      "id": 1,
      "contract": {
        "alias": "text",
        "address": "text"
      },
      "tokenId": "text",
      "standard": "text",
      "totalSupply": "text",
      "metadata": null
    },
    "from": {
      "alias": "text",
      "address": "text"
    },
    "to": {
      "alias": "text",
      "address": "text"
    },
    "amount": "text",
    "transactionId": 1,
    "originationId": 1,
    "migrationId": 1
  }
]