Token

The Token object represents a single NFT. It provides comprehensive on-chain data, metadata, ownership details, and lifecycle events.

type Token {
  contract: Contract!
  tokenID: String!
  tokenURI: String
  tokenURIStatus: TokenURIStatus
  image: Image
  metadataStatus: MetadataStatus
  metadataContent: String
  metadataContentType: String
  createdAt: Time!
  createdBlock: Int!
  burnedAt: Time
  burnedBlock: Int
  errorMsg: String
  name: String
  description: String
  expired: Boolean
  dexTrades: Int!
  holders(
    first: Int = 10
    skip: Int = 0
    after: String
  ): Balances!
}

Fields

Token.contract ● Contract! non-null object

Token.tokenID ● String! non-null scalar

Token.tokenURI ● String scalar

Token.tokenURIStatus ● TokenURIStatus enum

Token.image ● Image object

Token.metadataStatus ● MetadataStatus enum

Token.metadataContent ● String scalar

Token.metadataContentType ● String scalar

Token.createdAt ● Time! non-null scalar

Token.createdBlock ● Int! non-null scalar

Token.burnedAt ● Time scalar

Token.burnedBlock ● Int scalar

Token.errorMsg ● String scalar

Token.name ● String scalar

Token.description ● String scalar

Token.expired ● Boolean scalar

Token.dexTrades ● Int! non-null scalar

Token.holders ● Balances! non-null object

Token.holders.first ● Int scalar

Token.holders.skip ● Int scalar

Token.holders.after ● String scalar

Returned By

token query

Member Of

Balance object ● Tokens object

Fields Descriptions

Field Name	Type	Description
contract	Contract!	The contract that minted this token.
tokenID	String!	The token ID.
tokenURI	String	The token URI.
tokenURIStatus	TokenURIStatus	The status of the token URI.
image	Image	The image associated with this token.
metadataStatus	MetadataStatus	The status of the metadata.
metadataContent	String	The metadata content.
metadataContentType	String	The content type of the metadata.
createdAt	Time!	When the token was created.
createdBlock	Int!	The block number at which the token was created.
burnedAt	Time	When the token was burned (if applicable).
burnedBlock	Int	The block number at which the token was burned (if applicable).
errorMsg	String	Error message (if any).
name	String	The name of the token.
description	String	The description of the token.
expired	Boolean	Whether the token has expired.
holders	Balances!	The quantity of holders of this token.

Example Query

query Query($contract: ID!, $tokenId: ID!) {
  token(contract: $contract, tokenID: $tokenId) {
    metadataContent
    name
    tokenID
    tokenURI
    description
    holders {
      balances {
        owner
      }
    }
  }
}

Use Cases

• NFT Marketplaces (show NFT details like image, name, description).
• Wallet Dashboards (retrieve metadata and NFT media for display).
• Token Analytics (track mint/burn rates across collections).