API Reference

In this section, you’ll find a comprehensive list of all the GraphQL queries, mutations, and types available in the Codex API.

If you need to learn more about GraphQL itself, we recommend reading the GraphQL documentation.

Pick your endpoint

Use this table to find the right endpoint for the data you need. Each entry links to its full reference page.

The data you need	Find it with this
Filtered list of tokens based on specific input variables, available with extensive and enhanced token data	`filterTokens` · `onFilterTokensUpdated` for live updates
Token charts (OHLCV bars)	`getTokenBars` · `onTokenBarsUpdated` for live updates
Token holder filtering with wallet PnL data	`filterTokenWallets`
Live-streamed token prices	`onPricesUpdated`
All transactions for a wallet	`getTokenEventsForMaker`
Holder list and balance	`holders`
Live transactions for a token	`onTokenEventsCreated` · `onEventsCreatedByMaker` for a specific wallet
Newly launched tokens	`onLaunchpadTokenEventBatch`
Wallet balances	`balances` · `onBalanceUpdated` for live updates
Prediction market data	See the Discover prediction markets recipe

Many queries have a real-time subscription counterpart. See Queries vs Subscriptions for the full endpoint mapping and guidance on when to use each.

To help you get started with Codex, here are the top 10 queries and subscriptions used by customers.

filterTokens: Filter and search tokens based on a variety of criteria
getBars: Get bar chart data (OHLCV) to track price changes over time
getTokenEvents: Get transactions (buys, sells) for a pair
pairMetadata: Get metadata and stats for a trading pair
filterTokenWallets: Get wallets with stats for a specific token
holders: Get wallets holding a token, ordered by balance
getTokenEventsForMaker: Get token events for a specific wallet address
top10HoldersPercent: Get the percentage of supply held by the top 10 holders
listPairsWithMetadataForToken: Get all trading pairs for a token with metadata
getTokenPrices: Get real-time or historical prices for a list of tokens

onPairMetadataUpdated: Live stat updates for a token within a pair
onLaunchpadTokenEventBatch: Live launchpad token events, batched for efficiency
onBarsUpdated: Live bar chart data for price tracking
onFilterTokensUpdated: The subscription version of our most popular query, filterTokens
onHoldersUpdated: Live holder count and balance changes for a token
onDetailedStatsUpdated: Live bucketed stats for a token within a pair
onEventsCreated: Live transactions for a token
onPricesUpdated: Live price updates for multiple tokens
onTokenBarsUpdated: Live bar chart data for a token across all its pools
onTokenEventsCreated: Live events for a token across all its pools

Check out our Recipes for more in-depth walkthroughs of popular Codex use cases.

Try out queries interactively in our GraphQL Explorer.