TokenTransfers API

Learn all the detailed references of TokenTransfers API that provide ERC20/721/1155 token transfer information, including the input filters, supported chains, and output fields.

The TokenTransfers API delivers information on token transfers between wallets & contracts.

The TokenTransfers API only covers transfers of the "transfer" type and excludes "sale" transactions for NFT contracts.

Inputs

filter

NameTypeDescription

_and

Combines multiple filtering conditions, and only returns the data that meets all the specified conditions. Note: the relationship between multiple selected filters is always AND by default.

_nor

Combines multiple filtering conditions, and only returns the data that does not meet any of the specified conditions.

_or

Combines multiple filtering conditions, and returns the data that meets at least one of the specified conditions.

blockTimestamp

Time_Comparator_Exp

Allows entering blockTimestamp to filter transactions which happened in specific periods

formattedAmount

Float_Comparator_Exp

Allows filtering based on Balance amount in decimals, e.g. show me Balances above 200

from

Identity_Comparator_Exp

Identity: blockchain address, domain name, social identity

operator

Identity_Comparator_Exp

Executor of the transaction.

to

Identity_Comparator_Exp

Identity: blockchain address, domain name, social identity

tokenAddress

Address_Comparator_Exp

Token contract address (ERC20, ERC721, ERC1155)

tokenId

String_Comparator_Exp

Unique NFT token ID

tokenType

TokenType_Comparator_Exp

ERC20, ERC721, ERC1155

transactionHash

String_Comparator_Exp

Transaction hash of the Token Transfers

blockchain

NameDescription

ethereum

Ethereum mainnet

base

Base mainnet

zora

Zora mainnet

gold

Gold Chain L3

degen

Degen Chain L3

ham

Ham Chain L3

order

NameDescription

blockTimestamp

Sort the result by the block timestamp of when the token transfer occured, either in ascending (ASC) or descending (DESC) order.

Outputs

Outputs

NameTypeDescription

amount

String

Amount transferred in the token transfer

amounts

[String]

ERC1155 batch transfer specific amounts

blockchain

Blockchain

Blockchain where the token transfer took place

blockNumber

Int

Block number of the token transfer

blockTimestamp

Time

Timestamp of the token transfer

chainId

String

Unique blockchain identifier

from

Wallet

**Nested query** - sender's wallet-related information, including address, domains, social profile, other token balances, and transfer history.

id

ID

Airstack unique identifier for the token transfer

operator

Wallet

**Nested query** - Token transfer executor's wallet-related information, including address, domains, social profile, other token balances, and transfer history.

to

Wallet

**Nested query** - receiver's wallet-related information, including address, domains, social profile, other token balances, and transfer history.

token

**Nested query** - token contract level information

tokenAddress

Address

Token contract address

tokenId

String

Token ID associated with the token transfer, if applicable

tokenIds

[String]

List of token IDs associated with the token transfer, if applicable

tokenNft

**Nested query** - individual NFT token level data

tokenType

TokenType

Token type (ERC20, ERC721, or ERC1155)

transactionHash

String!

Transaction hash of the token transfer

`types

String

Type of the token transfer

Last updated

Was this helpful?