codex-supergraph

Codex Supergraph 数据

Codex 通过一个 GraphQL API 提供覆盖 100 多个网络的实时链上数据，包括代币价格、图表、持有者、钱包、启动平台、代币风险和预测市场。完整文档：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
Schema（SDL）	https://graph.codex.io/schema/latest.graphql
Introspection JSON	https://graph.codex.io/schema/latest.json
API 密钥身份验证	Authorization: <key> 或 Authorization: Bearer <token>
Agent 文档索引	https://docs.codex.io/llms.txt

会话预检（必需）

运行一次并缓存：

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
Launchpad 排名	filterLaunchpads
Launchpad 数据流	onLaunchpadTokenEventBatch、onLaunchpadTokenEvent
单个价格实时数据	onPriceUpdated
多个价格实时数据	onPricesUpdated
代币事件实时数据	onTokenEventsCreated、onEventsCreated（交易对）、onEventsCreatedByMaker
实时 K 线/交易对	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 开始。预确认数据流通过事件和 K 线订阅上的 commitmentLevel 参数设置（仅限 Solana 的 Preprocessed、Processed、Confirmed）；旧版 onUnconfirmed* 订阅已弃用。

规则

• 绝不输出原始 API 密钥。
• 首先验证 networkId。
• 确认数据形状前，尽量精简选择集。
• 使用 onPricesUpdated，不要订阅多个单个代币。
• 钱包、持有者和余额查询需要 Growth 或 Enterprise 计划；入门计划返回空结果是计划权限限制，并非缺少数据。
• 全网数据流（BarFeed、PriceFeed、EventFeed）按 API 密钥启用；onTokenBarsUpdated 返回“tokenId required”表示该密钥没有相应权限。
• 如果问题涉及安全性，先读取 risk，再读取 isScam，绝不要将 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	钱包 PnL、筛选器、余额、持有者、标签、计划权限限制
references/launchpads.md	Launchpad 数据流、筛选、排名、生命周期
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