TokenNfts API

Learn all the detailed references of TokenNfts API that provide ERC721/1155 NFT detail information, including the input filters, supported chains, and output fields.

The TokenNFTs API provides detailed data about a specific NFT token within an NFT Collection, either an ERC721 or ERC1155 contract. You can use this API to return token-specific metadata, including traits, and resized images.

Inputs

filter

Name	Type	Description
address	Address_Comparator_Exp	Contract address (ERC721, ERC1155)
metaData	NftMetadataFilter	allows querying by NFT Token Name, or specific trait or attribute.
tokenId	String_Comparator_Exp	Unique NFT token ID

blockchain

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

Outputs

type TokenNft {
address: Address! # NFT contract address on the blockchain
blockchain: Blockchain # Blockchain where the NFT token is deployed
chainId: String! # Unique blockchain identifier
contentType: String # Content type of the NFT token (image, video, audio, etc.)
contentValue: Media # NFT Media - resized images, animation, videos, etc.
id: # Airstack unique identifier for the NFT token
lastTransferBlock: # Block number of the token NFT's most recent transfer
lastTransferHash: # Hash of the token NFT's most recent transfer
lastTransferTimestamp: # Timestamp of the token NFT's most recent transfer
metaData: NftMetadata # Metadata associated with the NFT token
nftSaleTransactions: # **Nested query** allowing to retrieve token sale transactions
rawMetaData: # NFT token metadata as defined in the contract
token: # **Nested query** allowing to query contract level data
tokenBalances: # **Nested query** with token balance data & owner data
tokenId: IntString! # Unique NFT token ID
tokenTransfers: # **Nested query** with token transfers data
tokenURI: String # URI for the token NFT's resources
totalSupply: String # Total supply of the NFT token
type: TokenType # Type of NFT - ERC721 or ERC1155
}

Resized NFT images size guide:

• extra_small: 125x125px

• small: 250x250px

• medium: 500x500px

• large: 750x750px