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.

Resized NFT images size guide:

  • extra_small: 125x125px

  • small: 250x250px

  • medium: 500x500px

  • large: 750x750px

Inputs

filter

NameTypeDescription

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

EnumDescription

ethereum

Ethereum mainnet

base

Base mainnet

zora

Zora mainnet

gold

Gold Chain L3

degen

Degen Chain L3

ham

Ham Chain L3

Outputs

NameTypeDescription

address

Address!

NFT contract address on the blockchain

blockchain

TokenBlockchain

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.

erc6551Accounts

Any ERC6551 accounts owned by the associated NFT.

id

ID!

Airstack unique identifier for the NFT token

lastTransferBlock

Int

Block number of the token NFT's most recent transfer

lastTransferHash

String

Hash of the token NFT's most recent transfer

lastTransferTimestamp

Time

Timestamp of the token NFT's most recent transfer

metaData

NftMetadata

Metadata associated with the NFT token

rawMetaData

Map

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

String!

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

Last updated