codex-supergraph

Codex Supergraph Data

Codex は、100 以上のネットワークに対応した単一の GraphQL API を通じて、トークン価格、チャート、保有者、ウォレット、ローンチパッド、トークンリスク、予測市場などのオンチェーンデータをリアルタイムで提供します。ドキュメント全文はこちらです：docs.codex.io。このスキルで扱っていない内容については、まず docs.codex.io/llms.txt を取得し、そこからページへのリンクをたどってください。

認証

利用可能な場合は、$CODEX_API_KEY を Authorization ヘッダーに渡してください。dashboard.codex.io/signup で API キーを取得できます（初回の有効化に 1 ドルかかり、エントリープランに継続料金はありません）。サーバーが 402 Payment Required を返した場合は、codex-gateway スキルを使用して決済フローを処理してください。

このスキルのローカル版とグローバル版が両方存在する場合は、ローカル版を優先してください。

概要

このスキルを使うと、API キー認証を使用して有効な Codex GraphQL リクエストを作成できます。

HTTP エンドポイント	https://graph.codex.io/graphql
WebSocket エンドポイント	wss://graph.codex.io/graphql
スキーマ（SDL）	https://graph.codex.io/schema/latest.graphql
イントロスペクション JSON	https://graph.codex.io/schema/latest.json
API キー認証	Authorization: <key> または Authorization: Bearer <token>
エージェント向けドキュメントの索引	https://docs.codex.io/llms.txt

セッションの事前確認（必須）

1 回実行してキャッシュしてください。

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 } }"}'

高コストなリクエストを行う前に、この結果からネットワーク ID を使用してください。ネットワークは追加や廃止が行われるため、リストをハードコードしないでください。

操作の選択

必要な情報	操作
ネットワーク	getNetworks、filterNetworks（ランキング形式のネットワーク統計）、getNetworkStatus（インデックス作成の遅延）
トークンの検出／検索	filterTokens（ライブ更新版 onFilterTokensUpdated）
トレンドのトークン	trendingScore24 によるランキングで filterTokens
最新のトークン	createdAt の降順でランキングした filterTokens
トークンのカテゴリ（AI、ミーム、RWA など）	categories、categoryTokens、categories フィルターを使用した filterTokens
トークンのメタデータ	token、tokens
トークン価格	getTokenPrices
トークンのペア	listPairsWithMetadataForToken
ペアのスクリーナー	filterPairs
ペアのメタデータ	pairMetadata、getDetailedPairStats
ペアの OHLCV	getBars
トークンの OHLCV	getTokenBars
スパークライン	tokenSparklines
トークンイベント	getTokenEvents
メーカーイベント	getTokenEventsForMaker
期間指定のトークン変動統計	getDetailedTokenStats
トークンのリスク（詐欺、ハニーポット、税）	token { risk }（buyTax／sellTax を含む）、リスクフィルターを使った filterTokens／filterPairs、新たに実行する場合は simulateTokenContract ＋ getSimulateTokenContractResults
流動性ロック	liquidityMetadataByToken、liquidityMetadata。保有者／権利確定の詳細には liquidityLocksV2
トークンのウォレットリーダー	filterTokenWallets、tokenTopTraders
ウォレットのスクリーナー	filterWallets
ウォレットのチャート／統計	walletChart、detailedWalletStats
ウォレット残高／ポートフォリオ	balances、refreshBalances
保有者	holders（ライブ更新版 onHoldersUpdated）
上位10保有者の集中度	top10HoldersPercent
スナイパー／バンドラー／インサイダー	tokenWalletStats
ウォレットラベルの用語	walletLabelTypes
ローンチパッドランキング	filterLaunchpads
ローンチパッドのストリーム	onLaunchpadTokenEventBatch、onLaunchpadTokenEvent
ライブ単一価格	onPriceUpdated
ライブ複数価格	onPricesUpdated
ライブトークンイベント	onTokenEventsCreated、onEventsCreated（ペア）、onEventsCreatedByMaker
ライブのバー／ペア	onBarsUpdated、onPairMetadataUpdated、onTokenBarsUpdated
ライブ残高／統計	onBalanceUpdated、onDetailedTokenStatsUpdated
有効期間の短いキー	createApiTokens、apiTokens、apiToken、deleteApiToken
Webhook（サーバー側アラート）	createWebhooks、deleteWebhooks、getWebhooks
予測イベントの検出	filterPredictionEvents
予測市場の検出	filterPredictionMarkets
予測イベントの詳細	detailedPredictionEventStats
予測市場のチャート	predictionMarketBars
予測の複数市場チャート	predictionEventTopMarketsBars
予測イベントのチャート	predictionEventBars
予測取引	predictionTrades
予測トークンの保有者	predictionTokenHolders
予測カテゴリ	predictionCategories
予測トレーダーのリーダーボード	filterPredictionTraders
予測トレーダーのプロフィール	detailedPredictionTraderStats
予測トレーダーのポジション	filterPredictionTraderMarkets
予測トレーダーのチャート	predictionTraderBars

デフォルトの検出手順：まず filterTokens を使用します。事前確認ストリームでは、イベントとバーのサブスクリプションで commitmentLevel 引数（Solana のみ Preprocessed、Processed、Confirmed）を使用します。旧式の onUnconfirmed* サブスクリプションは非推奨です。

ルール

• API キーをそのまま出力しないでください。
• まず networkId を検証してください。
• 形状を確認するまでは、選択セットを最小限に保ってください。
• 多数の単一トークンサブスクリプションの代わりに、onPricesUpdated を使用してください。
• ウォレット、保有者、残高のクエリには Growth または Enterprise プランが必要です。エントリープランで結果が空になる場合は、データが欠落しているのではなく、プランによる制限です。
• ネットワーク全体のファイアホースストリーム（BarFeed、PriceFeed、EventFeed）は API キーごとに有効化されます。onTokenBarsUpdated で「tokenId required」と表示される場合、そのキーには利用権限がありません。
• 安全性に関する質問では、isScam より先に risk を確認し、risk が null の場合に安全と判断しないでください。
• 予期しない結果をデバッグする前に、references/gotchas.md を確認してください。

参考資料

ファイル	用途
references/gotchas.md	よくある失敗要因 — まずこちらを確認
references/query-templates.md	例を含むクエリと WebSocket のテンプレート
references/endpoint-playbook.md	目的に応じた操作の選択ヒューリスティック、ページのデータフロー
references/apis.md	エンドポイントと認証の一覧、ネットワーク ID、ページネーション、レート制限
references/token-risk.md	リスク判定、コントラクトシミュレーター、安全性シグナル、流動性ロック
references/wallets-and-balances.md	ウォレットの損益、スクリーナー、残高、保有者、ラベル、プラン制限
references/launchpads.md	ローンチパッドのストリーム、スクリーニング、ランキング、ライフサイクル
references/prediction-markets.md	予測市場のクエリ — イベント、市場、トレーダー、チャート
references/migrations.md	Birdeye、Mobula、CoinGecko、Bitquery、Dune Sim、Serialized からのエンドポイント対応表
references/tooling-and-mcp.md	コーディングツール向け Codex Docs MCP のセットアップ

リンク

• ウェブサイト：www.codex.io
• ドキュメント：docs.codex.io
• API キーを取得：dashboard.codex.io/signup