Tokens

The Tokens object provides a paginated, cursor-based list of NFTs (Token objects). It enables efficient traversal of large NFT datasets while tracking pagination state via cursor and remaining fields.

type Tokens {
  count: UInt64!
  cursor: String
  tokens: [Token!]!
  timing: String
}

Fields

Tokens.count ● UInt64! non-null scalar

Tokens.cursor ● String scalar

Tokens.tokens ● [Token!]! non-null object

Tokens.timing ● String scalar

Returned By

tokens query

Member Of

Contract object

Field Descriptions

Field Name	Type	Description
count	UInt64!	The total number of tokens
cursor	String	The cursor for pagination
tokens	[Token!]!	The list of token objects
timing	String	Timing information

Example Query

query Tokens($where: TokenFilter, $whereContract: ContractFilter, $first: Int) {
  tokens(where: $where, whereContract: $whereContract, first: $first) {
    tokens {
      name
      tokenID
      tokenURI
      metadataContent
      metadataContentType
      contract {
        name
        symbol
        type
      }
    }
  }
}

Use Cases

• NFT Marketplaces (display token listings with metadata).
• Wallet Dashboards (show owned tokens across collections).
• Analytics Tools (analyze token distribution in a collection).