← 返回 Skills 市场

codex-supergraph

Name: codex-supergraph
Author: nealo

作者 Neal O'Grady · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

206

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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 wh...

使用说明 (SKILL.md)

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: \x3Ckey>` or `Authorization: Bearer \x3Ctoken>`

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 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

安全使用建议

This skill is documentation and query templates for the Codex GraphQL API and appears to do what it says — build and run GraphQL queries/subscriptions. Before installing or using it: - Treat the CODEX_API_KEY as sensitive: the SKILL.md expects an API key (used in examples) but the skill metadata does not declare it as required; ensure the platform will store/handle the key securely and do not paste raw keys into chat. Verify where the agent will read the env var from. - Review any suggested config file changes (e.g., .vscode/mcp.json, ~/.codeium/windsurf/mcp_config.json) before applying them; these write to user config locations and could alter tooling behavior. - Confirm you expect network calls to https://graph.codex.io/graphql and wss://graph.codex.io/graphql and that those endpoints are the intended destination for your data/queries. - Be cautious with subscriptions/streams (e.g., launchpad firehose, high-frequency price feeds) as they can be high-volume; prefer backend-side proxying if you intend heavy use. - If the skill references a codex-gateway or other payment flow, inspect that skill separately before allowing it to run payment flows on your behalf. If you want to proceed, ask the publisher to update the skill metadata to declare CODEX_API_KEY as a required credential (or explicitly mark it optional) so the platform can present the prompt and handle the secret securely.

功能分析

Type: OpenClaw Skill Name: codex-data Version: 1.0.0 The skill bundle provides comprehensive instructions and GraphQL templates for an AI agent to interact with the Codex Supergraph API for blockchain and prediction market data. It includes legitimate API endpoints (graph.codex.io), safety rules against leaking API keys, and standard integration guides for Model Context Protocol (MCP) servers, with no evidence of malicious intent or data exfiltration.

能力评估

✓ Purpose & Capability

Name, description, and all instructions consistently target Codex GraphQL (https://graph.codex.io/graphql) and on-chain analytics; the operations, subscriptions, and examples match the stated purpose.

ℹ Instruction Scope

Instructions are instruction-only examples (curl, GraphQL, TypeScript, websocket) and mainly scoped to calling the Codex API. However the docs also advise writing local config files (e.g., .vscode/mcp.json, ~/.codeium/windsurf/mcp_config.json) and point to a docs MCP server; that recommends touching user config paths beyond mere API calls and is out-of-band for a pure data-query skill.

✓ Install Mechanism

No install spec or code files that would be downloaded/executed. Instruction-only skills are lowest-risk for install mechanisms.

⚠ Credentials

The SKILL.md repeatedly uses an environment variable ($CODEX_API_KEY / process.env.CODEX_API_KEY) for Authorization, but the skill metadata declares no required environment variables or primary credential. This omission is inconsistent and means the skill's runtime expectations (an API key) are not declared up front.

✓ Persistence & Privilege

No elevated persistence requested (always:false). The skill does not request to modify other skills or system/global settings beyond recommending files to add for tooling.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install codex-supergraph
安装完成后，直接呼叫该 Skill 的名称或使用 /codex-supergraph 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of codex-supergraph. - Enables access to Codex on-chain analytics and prediction market data. - Supports token prices, charts, holders, trending tokens, pair data, and more via Codex GraphQL API. - Details required authentication flow with API key and payment handling guidance. - Provides guidance for operation selection and discovery path. - Includes references for troubleshooting and advanced queries.

元数据

Slug codex-supergraph

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题