Tokens

The tokens query retrieves a paginated list of NFT/token assets with flexible filtering and sorting. This is the primary method for fetching multiple tokens from collections or across the entire index.

tokens(
  first: Int = 10
  skip: Int = 0
  after: String
  where: TokenFilter
  orderBy: TokenOrderBy
  orderDirection: OrderDirection
  whereContract: ContractFilter
  whereSwap: SwapFilter
): Tokens!

Arguments

tokens.first ● Int scalar

tokens.skip ● Int scalar

tokens.after ● String scalar

tokens.where ● TokenFilter input

tokens.orderBy ● TokenOrderBy enum

tokens.orderDirection ● OrderDirection enum

tokens.whereContract ● ContractFilter input

Type

Tokens object

Argument Descriptions

Pagination Controls

Argument	Type	Default	Description
first	Int	10	Number of tokens to return.
skip	Int	0	Legacy pagination offset.
after	String	-	Cursor for next page.

Core Filters

Argument	Type	Description
where	TokenFilter	Filter by metadataStatus, burned, name_like, etc.
whereContract	ContractFilter	Filter by contract properties id, name, type, etc.

Sorting Options

Argument	Type	Options
orderBy	TokenOrderBy	CONTRACT, COLLECTION_HOLDERS, TOKEN_ID, NAME, CREATED_AT, CREATED_BLOCK
orderDirection	OrderDirection	ASC, DESC

Example

Fetch First 10 Collection Tokens

query Tokens($first: Int, $whereContract: ContractFilter, $orderBy: TokenOrderBy) {
  tokens(first: $first, whereContract: $whereContract, orderBy: $orderBy) {
    tokens {
      tokenID
      image {
        url
      }
      name
    }
  }
}

Variables

{
  "first": "10",
  "whereContract": {
    "id": "0x49cF6f5d44E70224e2E23fDcdd2C053F30aDA28B"
  },
  "orderBy": "TOKEN_ID"
}

Response

This response is an example only and may not reflect current data.

{
  "data": {
    "tokens": {
      "tokens": [
        {
          "tokenID": "1",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/1.png"
          },
          "name": "CloneX #1"
        },
        {
          "tokenID": "2",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/2.png"
          },
          "name": "CloneX #2"
        },
        {
          "tokenID": "3",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/3.png"
          },
          "name": "CloneX #3"
        },
        {
          "tokenID": "4",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/4.png"
          },
          "name": "CloneX #4"
        },
        {
          "tokenID": "5",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/5.png"
          },
          "name": "CloneX #5"
        },
        {
          "tokenID": "6",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/6.png"
          },
          "name": "CloneX #6"
        },
        {
          "tokenID": "7",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/7.png"
          },
          "name": "CloneX #7"
        },
        {
          "tokenID": "8",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/8.png"
          },
          "name": "CloneX #8301"
        },
        {
          "tokenID": "9",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/9.png"
          },
          "name": "CloneX #1174"
        },
        {
          "tokenID": "10",
          "image": {
            "url": "https://clonex-assets.rtfkt.com/images/10.png"
          },
          "name": "CloneX #19995"
        }
      ]
    }
  }
}

Common Use Cases

1. Collection Browsing: Display tokens from a specific contract.
2. Marketplace Listings: Show filtered tokens for sale.
3. Data Analysis: Study token distributions/metadata.
4. Wallet Integration: Load all tokens owned by an address.

Best Practices

• Always include first to limit response size.
• Use where filters before sorting for better performance.
• Request count only when needed for UI pagination.
• Combine with contract query for collection context.

Related Queries

• token: For single token lookups.
• contract: To verify collection details.