skills/codex-gateway/SKILL.md
Use when the user wants to query the Codex Supergraph and the server returns a 402 challenge. Pays per query via the MPP 402 challenge flow. Only supports queries, not mutations or subscriptions.
npx skillsauth add codex-data/skills codex-gatewayInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill when the Codex Supergraph returns a 402 Payment Required response. The MPP challenge flow lets you pay per query without needing an API key. For higher volume, get an API key at dashboard.codex.io/signup — see docs.codex.io for details.
| | |
| --------------------- | --------------------------------------------------------------- |
| HTTP endpoint | https://graph.codex.io/graphql |
| Credential header | Authorization: Payment <base64url-credential> |
402 Payment Required with WWW-Authenticate: Payment ... challenges.Authorization: Payment <credential>.Payment-Receipt header.403 in MPP mode.query operations.references/query-templates.md below for the correct GraphQL schema. Do not guess query or field names.| File | Purpose | | ---- | ------- | | ../codex-supergraph/references/query-templates.md | GraphQL query schema and examples — read before constructing queries | | ../codex-supergraph/references/gotchas.md | Common query failure points | | references/gotchas.md | MPP-specific failure points | | rules/wallets.md | Wallet setup: tempo wallet/request (Tempo) | | references/mpp-flow.md | Auth matrix, challenge details, error codes |
development
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. TRIGGERS: token price, token chart, trending tokens, pair data, holders, 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 trades
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.
development
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
development
Run, watch, debug, and extend OpenClaw QA testing with qa-lab and qa-channel. Use when Codex needs to execute the repo-backed QA suite, inspect live QA artifacts, debug failing scenarios, add new QA scenarios, or explain the OpenClaw QA workflow. Prefer the live OpenAI lane with regular openai/gpt-5.4 in fast mode; do not use gpt-5.4-pro or gpt-5.4-mini unless the user explicitly overrides that policy.