SkillsAdd

codex-data/skills

codex-supergraph

>- Use when the user asks about token prices, charts, holders, trending tokens, pair data, prediction markets, or any on-chain analytics from Codex. Also use when building GraphQL queries against https://graph.codex.io/graphql. prediction markets, Polymarket, Kalshi, event odds, prediction event, prediction traders, trader leaderboard, trader PnL, prediction charts, outcome probability, open interest, prediction categories, betting markets, market resolution, prediction positions, prediction tr…

First seen Mar 13, 2026

Installation

$ npx skills add codex-data/skills --skill codex-supergraph
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from codex-data/skills.

npx skills add codex-data/skills
codex-gateway 308 agent-payments 7

Browse all from codex-data/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License MIT
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0
Declared agents codex
More metadata
author
codex-data
version
1.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,511 B
  • docs SUMMARY.md 597 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 337 installs

SKILL.md

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 $CODEXAPIKEY 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](references/gotchas.md) Common failure points — check here first
[references/query-templates.md](references/query-templates.md) Query + websocket templates with examples
[references/endpoint-playbook.md](references/endpoint-playbook.md) Operation selection heuristics by intent
[references/apis.md](references/apis.md) Endpoint/auth matrix, pagination, rate limits
[references/prediction-markets.md](references/prediction-markets.md) Prediction market queries — events, markets, traders, charts
[references/tooling-and-mcp.md](references/tooling-and-mcp.md) Codex Docs MCP setup for coding tools

Links