categoryTokens

Returns the tokens in a category, with the same filters and rankings as filterTokens. Results are TokenFilterResult objects, so a category page can reuse the exact rendering you already have for token screener rows. This is a convenience wrapper for scoping token discovery to one category. If you need to combine multiple categories (anyOf, allOf, noneOf) or mix category constraints with other boolean logic, use filterTokens with the categories filter (TokenCategoryFilter) instead.

Returns

CategoryTokenConnection

See CategoryTokenConnection

Show Properties

[TokenFilterResult]

The list of tokens in the category matching the filter parameters. See TokenFilterResult

Int

The number of tokens returned.

Int

Where in the list the server started when returning items.

Arguments

String!

required

The category slug.

TokenFilters

A set of additional filters to apply. See TokenFilters

Show Properties

TokenBoolFilter

Recursive boolean expression for combining token filters. See TokenBoolFilter

TokenCategoryFilter

See TokenCategoryFilter

NumberFilter

The unix timestamp for the creation of the token’s first pair. See NumberFilter

NumberFilter

The unix timestamp for the creation of the token. See NumberFilter

NumberFilter

The unix timestamp for the token’s last transaction. See NumberFilter

NumberFilter

The number of buys in the past 5 minutes. See NumberFilter

NumberFilter

The number of buys in the past hour. See NumberFilter

NumberFilter

The number of buys in the past 12 hours. See NumberFilter

NumberFilter

The number of buys in the past 24 hours. See NumberFilter

NumberFilter

The number of buys in the past 4 hours. See NumberFilter

NumberFilter

The percent price change in the past 5 minutes. Decimal format. See NumberFilter

NumberFilter

The percent price change in the past hour. Decimal format. See NumberFilter

NumberFilter

The percent price change in the past 12 hours. Decimal format. See NumberFilter

NumberFilter

The percent price change in the past 24 hours. Decimal format. See NumberFilter

NumberFilter

The percent price change in the past 4 hours. Decimal format. See NumberFilter

NumberFilter

The percent volume change in the past 5 minutes. Decimal format. See NumberFilter

NumberFilter

The percent volume change in the past hour. Decimal format. See NumberFilter

NumberFilter

The percent volume change in the past 4 hours. Decimal format. See NumberFilter

NumberFilter

The percent volume change in the past 12 hours. Decimal format. See NumberFilter

NumberFilter

The percent volume change in the past 24 hours. Decimal format. See NumberFilter

[String]

The list of exchange contract IDs to filter by. Applied in conjunction with network filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.

[String]

The list of exchange contract addresses to filter by.

NumberFilter

The highest price in USD in the past 5 minutes. See NumberFilter

NumberFilter

The highest price in USD in the past hour. See NumberFilter

NumberFilter

The highest price in USD in the past 12 hours. See NumberFilter

NumberFilter

The highest price in USD in the past 24 hours. See NumberFilter

NumberFilter

The highest price in USD in the past 4 hours. See NumberFilter

NumberFilter

The amount of liquidity in the token’s top pair. See NumberFilter

NumberFilter

The token’s cumulative route-backed liquidity in USD, summed across the token’s pairs with valid routing liquidity. Distinct from liquidity, which covers the top pair only. See NumberFilter

NumberFilter

The lowest price in USD in the past hour. See NumberFilter

NumberFilter

The lowest price in USD in the past 5 minutes. See NumberFilter

NumberFilter

The lowest price in USD in the past 12 hours. See NumberFilter

NumberFilter

The lowest price in USD in the past 24 hours. See NumberFilter

NumberFilter

The lowest price in USD in the past 4 hours. See NumberFilter

NumberFilter

The fully diluted market cap. See NumberFilter

NumberFilter

The circulating market cap. See NumberFilter

[Int]

The list of network IDs to filter by. Applied in conjunction with exchangeId filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.

NumberFilter

The number of different wallets holding the token. See NumberFilter

NumberFilter

The token price in USD. See NumberFilter

NumberFilter

The number of sells in the past hour. See NumberFilter

NumberFilter

The number of sells in the past 5 minutes. See NumberFilter

NumberFilter

The number of sells in the past 12 hours. See NumberFilter

NumberFilter

The number of sells in the past 24 hours. See NumberFilter

NumberFilter

The number of sells in the past 4 hours. See NumberFilter

NumberFilter

The number of transactions in the past 5 minutes. See NumberFilter

NumberFilter

The number of transactions in the past hour. See NumberFilter

NumberFilter

The number of transactions in the past 12 hours. See NumberFilter

NumberFilter

The number of transactions in the past 24 hours. See NumberFilter

NumberFilter

The number of transactions in the past 4 hours. See NumberFilter

NumberFilter

The unique number of buys in the past hour. See NumberFilter

NumberFilter

The unique number of buys in the past 5 minutes. See NumberFilter

NumberFilter

The unique number of buys in the past 12 hours. See NumberFilter

NumberFilter

The unique number of buys in the past 24 hours. See NumberFilter

NumberFilter

The unique number of buys in the past 4 hours. See NumberFilter

NumberFilter

The unique number of sells in the past 5 minutes. See NumberFilter

NumberFilter

The unique number of sells in the past hour. See NumberFilter

NumberFilter

The unique number of sells in the past 12 hours. See NumberFilter

NumberFilter

The unique number of sells in the past 24 hours. See NumberFilter

NumberFilter

The unique number of sells in the past 4 hours. See NumberFilter

NumberFilter

The unique number of transactions in the past hour. See NumberFilter

NumberFilter

The unique number of transactions in the past 5 minutes. See NumberFilter

NumberFilter

The unique number of transactions in the past 12 hours. See NumberFilter

NumberFilter

The unique number of transactions in the past 24 hours. See NumberFilter

NumberFilter

The unique number of transactions in the past 4 hours. See NumberFilter

NumberFilter

The trade volume in USD in the past hour. See NumberFilter

NumberFilter

The trade volume in USD in the past 12 hours. See NumberFilter

NumberFilter

The trade volume in USD in the past 24 hours. See NumberFilter

NumberFilter

The trade volume in USD in the past 4 hours. See NumberFilter

NumberFilter

The trade volume in USD in the past 5 minutes. See NumberFilter

NumberFilter

The buy volume in USD in the past hour. See NumberFilter

NumberFilter

The buy volume in USD in the past 12 hours. See NumberFilter

NumberFilter

The buy volume in USD in the past 24 hours. See NumberFilter

NumberFilter

The buy volume in USD in the past 4 hours. See NumberFilter

NumberFilter

The buy volume in USD in the past 5 minutes. See NumberFilter

NumberFilter

The sell volume in USD in the past hour. See NumberFilter

NumberFilter

The sell volume in USD in the past 12 hours. See NumberFilter

NumberFilter

The sell volume in USD in the past 24 hours. See NumberFilter

NumberFilter

The sell volume in USD in the past 4 hours. See NumberFilter

NumberFilter

The sell volume in USD in the past 5 minutes. See NumberFilter

Boolean

Whether to include tokens that have been flagged as scams. Default: false

Boolean

Whether to filter for tokens on testnet networks. Use true for testnet tokens only, false for mainnet tokens only and undefined (default) for both.

Boolean

Only include verified tokens

Boolean

Filter potential Scams

Whether to ignore pairs/tokens not relevant to trending. This is done checking against a few factors and ignoring uninteresting tokens like stables / network tokens. If you want all tokens regardless of these checks, then don’t include this field. (default) If you want only tokens that fail the trending ignore checks, then set it to true. (i.e. stablecoins, rugs, network base tokens) If you want only tokens that pass the trending ignore checks, then set it to false.

[String!]

The addresses of the token creators (supports multiple addresses). Max 25 addresses. You cannot provide both creatorAddress and creatorAddresses.

[String!]

A list of launchpad protocols.

[String!]

A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun.

Boolean

Indicates if the launchpad is completed.

Boolean

Indicates if the launchpad has migrated.

NumberFilter

The graduation percentage. See NumberFilter

NumberFilter

The timestamp when the launchpad was completed. See NumberFilter

NumberFilter

The timestamp when the launchpad was migrated. See NumberFilter

Boolean

The token is freezable.

Boolean

The token is mintable.

Boolean

Whether the token name or symbol contains profanity.

NumberFilter

The average age of the wallets that traded in the last 24h. See NumberFilter

NumberFilter

The standard deviation of age of the wallets that traded in the last 24h. See NumberFilter

NumberFilter

The percentage of wallets that are less than 1d old that have traded in the last 24h. See NumberFilter

NumberFilter

The percentage of wallets that are less than 7d old that have traded in the last 24h. See NumberFilter

NumberFilter

Filter by total fees in the past 5 minutes. See NumberFilter

NumberFilter

Filter by total fees in the past hour. See NumberFilter

NumberFilter

Filter by total fees in the past 4 hours. See NumberFilter

NumberFilter

Filter by total fees in the past 12 hours. See NumberFilter

NumberFilter

Filter by total fees in the past 24 hours. See NumberFilter

NumberFilter

Filter by pool fees in the past 24 hours. See NumberFilter

NumberFilter

Filter by fee to volume ratio in the past 24 hours. See NumberFilter

NumberFilter

Filter by number of wallets that have sniped the token See NumberFilter

NumberFilter

Filter by percentage of tokens held by snipers See NumberFilter

NumberFilter

Filter by number of wallets that have bundled the token See NumberFilter

NumberFilter

Filter by percentage of tokens held by bundlers See NumberFilter

NumberFilter

Filter by number of wallets that have been an insider of the token See NumberFilter

NumberFilter

Filter by percentage of tokens held by insiders See NumberFilter

NumberFilter

Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders) See NumberFilter

NumberFilter

Filter by percentage of tokens held by suspicious wallets See NumberFilter

NumberFilter

Filter by percentage of tokens held by the dev See NumberFilter

NumberFilter

Filter by top 10 holders percentage. See NumberFilter

NumberFilter

Filter by number of posts in the token’s coin community. See NumberFilter

NumberFilter

Filter by number of members in the token’s coin community. See NumberFilter

NumberFilter

Filter by number of likes in the token’s coin community. See NumberFilter

NumberFilter

Filter by unix timestamp for the most recent post in the token’s coin community. See NumberFilter

Boolean

Filter by whether the token has linked Grid asset data.

[String!]

Filter by Grid bluechip ratings. Returns tokens matching any of the provided ratings.

NumberFilter

Filter by all-time high price. See NumberFilter

NumberFilter

Filter by all-time low price. See NumberFilter

NumberFilter

Filter by all-time high FDV. See NumberFilter

NumberFilter

Filter by all-time low FDV. See NumberFilter

NumberFilter

Filter by all-time high circulating market cap. See NumberFilter

NumberFilter

Filter by all-time low circulating market cap. See NumberFilter

NumberFilter

deprecated

See NumberFilter

This field is deprecated. Age isn’t supported - use createdAt instead

NumberFilter

deprecated

See NumberFilter

This field is deprecated. FDV isn’t supported - use marketCap instead

String

deprecated

The address of the creator of the token.

This field is deprecated. Use creatorAddresses string array instead

[TokenRanking]

A list of ranking attributes to apply. See TokenRanking

Show Properties

TokenRankingAttribute

The attribute to rank tokens by. See TokenRankingAttribute

RankingDirection

The direction to apply to the ranking attribute. See RankingDirection

Int

The maximum number of tokens to return.

Int

Where in the list the server should start when returning items. Use count+page from the previous query to request the next page of results.

Example

Test this query in the Explorer →

{
  categoryTokens(
    slug: "artificial-intelligence"
    filters: {liquidity: {gt: 100000}}
    rankings: [{attribute: volume24, direction: DESC}]
    limit: 25
  ) {
    results {
      token {
        address
        networkId
        name
        symbol
      }
      priceUSD
      liquidity
      marketCap
      volume24
      change24
      holders
    }
    count
    page
  }
}

Usage Guidelines

Apply quality filters such as liquidity and volume minimums to avoid low quality tokens, just as you would with filterTokens.
Use count and page from the previous response to request the next page of results.
Response limit: 200 tokens per request.

API Documentation

Queries

Mutations

Subscriptions

Types

categoryTokens

Returns

Arguments

Example

Usage Guidelines

​Returns

​Arguments

​Example

​Usage Guidelines

Returns

Arguments

Example

Usage Guidelines