Skip to main content
​
String!
The category id — a stable slug (also the value stored on tokens).
​
String!
The display name. For example, Artificial Intelligence.
​
String
An optional short name/abbreviation for compact surfaces (pills, badges). For example, AI. Null when unset — the API does not fall back to name; clients decide whether to.
​
String!
The URL slug (same value as id).
​
String
A short description of the category.
​
CategoryType!
Whether the category is canonical or narrative. See CategoryType
​
CategoryStatus!
The lifecycle status of the category. See CategoryStatus
​
String
The parent category id, for hierarchical categories.
​
Int
The number of tokens currently assigned to the category. Null when the count has not been computed yet.
​
String
deprecated
The category icon URL.
This field is deprecated. Categories no longer carry imagery. Will be null.
​
String
deprecated
The category banner image URL.
This field is deprecated. Categories no longer carry imagery. Will be null.

​
Used By

Returned by
  • balances: Returns list of token balances that a wallet has.
  • categories: Returns the list of token categories, optionally filtered by kind (canonical or narrative) and lifecycle status. Defaults to active categories.
  • category: Returns a single token category by its slug, or null if none matches.
  • categoryTokens: Returns the tokens assigned to a category (including its subcategories), with optional filterTokens-style filters and rankings applied.
  • filterPairs: Returns a list of pairs based on a variety of filters.
  • filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
  • filterTokenWallets: Returns a list of wallets with stats narrowed down to a specific token.
  • getBars: Returns bar chart data to track price changes over time.
  • getCommunityNotes: Returns community gathered notes.
  • getDetailedPairsStats: Returns bucketed stats for a given token within a list of pairs.
  • getDetailedPairStats: Returns bucketed stats for a given token within a pair.
  • getTokenBars: Returns aggregated bar chart data to track price changes over time.
  • holders: Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
  • listPairsForToken: Returns a list of pairs containing a given token.
  • listPairsWithMetadataForToken: Returns a list of pair metadata for a token.
  • onBalanceUpdated: Live-streamed balance updates for a given wallet.
  • onFilterTokensUpdated: Live-streamed filter token updates for the current filterTokens result set.
  • onHoldersUpdated: Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.
  • onLaunchpadTokenEvent: Live-streamed launchpad token event.
  • onLaunchpadTokenEventBatch: Live-streamed launchpad token events batched (more efficient).
  • onPairMetadataUpdated: Live-streamed stat updates for a given token within a pair.
  • pairMetadata: Returns metadata for a pair of tokens.
  • refreshBalances: Force refreshes the balance for a token in a wallet, persisting the result so subsequent balances queries reflect it. Supports contract tokens (<tokenAddress>:<networkId>, EVM only) and native token balances (native:<networkId>, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring.
  • token: Returns a single token by its address & network id.
  • tokens: Returns a list of tokens by their addresses & network id, with pagination.