Codex Supergraph Data
Authentication
Pass $CODEX_API_KEY in the Authorization header if available. If the server returns 402 Payment Required, use the codex-gateway skill to handle the payment flow.
If both a local and global copy of this skill exist, the local copy takes precedence.
Summary
Use this skill to produce valid Codex GraphQL requests using API key authentication.
| HTTP endpoint | https://graph.codex.io/graphql |
| WebSocket endpoint | wss://graph.codex.io/graphql |
| Schema (SDL) | https://graph.codex.io/schema/latest.graphql |
| Introspection JSON | https://graph.codex.io/schema/latest.json |
| API-key auth | Authorization: <key> or Authorization: Bearer <token> |
Session preflight (required)
Run once and cache:
curl -sS https://graph.codex.io/graphql \
-H "Content-Type: application/json" \
-H "Authorization: $CODEX_API_KEY" \
--data-binary '{"query":"query GetNetworks { getNetworks { id name } }"}'
Use network IDs from this result before expensive requests.
Operation selection
| Need | Operation |
|---|---|
| Networks | getNetworks |
| Token discovery/search | filterTokens |
| Trending tokens | filterTokens with trendingScore24 ranking |
| Token prices | getTokenPrices |
| Pairs for a token | listPairsWithMetadataForToken |
| Pair metadata | pairMetadata |
| Pair OHLCV | getBars |
| Token OHLCV | getTokenBars |
| Token events | getTokenEvents |
| Maker events | getTokenEventsForMaker |
| Wallet leaders | filterTokenWallets |
| Wallet chart/stats | walletChart, detailedWalletStats |
| Holders | holders |
| Top-10 concentration | top10HoldersPercent |
| Live single price | onPriceUpdated |
| Live multi-price | onPricesUpdated |
| Live token events | onTokenEventsCreated, onEventsCreatedByMaker |
| Live bars/pairs | onBarsUpdated, onPairMetadataUpdated, onTokenBarsUpdated |
| Launchpad streams | onLaunchpadTokenEventBatch, onLaunchpadTokenEvent |
| Unconfirmed Solana events | onUnconfirmedEventsCreated |
| Short-lived keys | createApiTokens, apiTokens, apiToken, deleteApiToken |
| Prediction event discovery | filterPredictionEvents |
| Prediction market discovery | filterPredictionMarkets |
| Prediction event detail | detailedPredictionEventStats |
| Prediction market chart | predictionMarketBars |
| Prediction multi-market chart | predictionEventTopMarketsBars |
| Prediction event chart | predictionEventBars |
| Prediction trades | predictionTrades |
| Prediction token holders | predictionTokenHolders |
| Prediction categories | predictionCategories |
| Prediction trader leaderboard | filterPredictionTraders |
| Prediction trader profile | detailedPredictionTraderStats |
| Prediction trader positions | filterPredictionTraderMarkets |
| Prediction trader chart | predictionTraderBars |
Default discovery path: start with filterTokens.
Rules
- Never print raw API keys.
- Validate
networkIdfirst. - Keep selection sets minimal until shape is confirmed.
- Use
onPricesUpdatedinstead of many single-token subscriptions.
References
| File | Purpose |
|---|---|
| references/gotchas.md | Common failure points — check here first |
| references/query-templates.md | Query + websocket templates with examples |
| references/endpoint-playbook.md | Operation selection heuristics by intent |
| references/apis.md | Endpoint/auth matrix, pagination, rate limits |
| references/prediction-markets.md | Prediction market queries — events, markets, traders, charts |
| references/tooling-and-mcp.md | Codex Docs MCP setup for coding tools |