codex-supergraph

codex supergraph

SKILL.md

Full skill instructions

Codex Supergraph Data

Codex provides real-time on-chain data — token prices, charts, holders, and prediction markets — via a single GraphQL API. Full documentation: docs.codex.io.

Authentication

Pass $CODEX_API_KEY in the Authorization header if available. Get a free API key at dashboard.codex.io/signup. 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`
Webhooks (server-side alerts)	`createWebhooks`, `deleteWebhooks`, `getWebhooks`
Windowed token change stats	`getDetailedTokenStats`
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 networkId first.
Keep selection sets minimal until shape is confirmed.
Use onPricesUpdated instead 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