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

Name	Type	Description
_and	[TokenTransferFilter!]	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	[TokenTransferFilter!]	Combines multiple filtering conditions, and only returns the data that does not meet any of the specified conditions.
_or	[TokenTransferFilter!]	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

Name	Description
ethereum	Ethereum mainnet
base	Base mainnet
zora	Zora mainnet
gold	Gold Chain L3
degen	Degen Chain L3

order

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

Outputs

Outputs

Name	Type	Description
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	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	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