okx/agent-skills/okx-cex-market
Claude Code and agent skill by okx/agent-skills
- community
Checking that the SKILL.md file is still in the repository.
Use this skill when the user asks for: price of any asset, ticker, order book, candles, OHLCV, funding rate, open interest, OI change scanner, market screener (top movers, high-volume, newly listed), mark price, index price, recent trades, instrument list, stock tokens, metals prices (gold, XAU, XAG), commodities (oil, OIL), forex rates (EUR/USD, EURUSDT), bond instruments, non-crypto assets, or any technical indicator query (RSI, MACD, EMA, Bollinger Bands, KDJ, SuperTrend, AHR999, BTC rainbow, and 70+ more). All commands are read-only and do NOT require API credentials. Do NOT use for account balance/positions (okx-cex-portfolio), placing/cancelling orders (okx-cex-trade), or bots (okx-cex-bot). Do NOT use when the user wants to TRADE a directional view as an event contract — that is okx-cex-trade. Merely ASKING which way an asset's price is moving is a market-data question and belongs here.
Install
npx vskill@latest install okx/agent-skills/okx-cex-marketSKILL.md
OKX CEX Market Data CLI
Compliance notice: This skill provides raw market data only. No strategy, recommendation, or optimization logic is embedded. All indicator outputs are objective numerical values; interpretation and trading decisions remain solely with the user.
Public market data for OKX: prices, order books, candles, funding rates, open interest, instrument info, and technical indicators. All commands are read-only and require no API credentials.
Skill routing
- Market data / indicators →
okx-cex-market(this skill) - Account balance / positions →
okx-cex-portfolio - Place / cancel orders →
okx-cex-trade - Trading a directional view as an event contract →
okx-cex-trade - Market sentiment / most bullish-bearish coins →
okx-sentiment-tracker - Grid / DCA bots →
okx-cex-bot
Preflight
Before running any command, follow `../_shared/preflight.md`. Use metadata.version from this file's frontmatter as the reference for Step 2.
Install
Market data commands return the same public data regardless of demo/live mode — no API credentials required. If the user's profile has demo=true set and they want live data context, they can use --live to confirm they are in live mode (it has no effect on public market data but clarifies environment). Always inform the user which environment is active (demo or live) when it is relevant to their query. No confirmation needed before running any market command. Add --json to any command for raw OKX API v5 response. Add --env to wrap the output as {"env", "profile", "data"}.
Command Index
| # | Command | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
| 1 | okx market ticker <instId> | Last price, 24h high/low/vol/change% | |||||||
| 2 | okx market tickers <instType> | All tickers for SPOT / SWAP / FUTURES / OPTION | |||||||
| 3 | okx market instruments --instType <type> [--instId <id>] [--uly <uly>] [--instFamily <fam>] [--seriesId <id>] | List instruments (instId, ctVal, lotSz, minSz, tickSz, state); OPTION requires --uly or --instFamily; EVENTS requires --seriesId | |||||||
| 4 | okx market orderbook <instId> [--sz <n>] | Order book asks/bids (default top 5 per side, max 400) | |||||||
| 5 | okx market candles <instId> [--bar <bar>] [--limit <n>] [--after <ts>] [--before <ts>] | OHLCV candles (default --bar 1m); auto-routes to historical endpoint for data back to 2021; --after paginates back in time, --before paginates forward | |||||||
| 6 | okx market index-candles <instId> [--bar <bar>] [--limit <n>] [--history] | Index OHLCV (use BTC-USD not BTC-USDT) | |||||||
| 7 | okx market funding-rate <instId> [--history] [--limit <n>] | Current or historical funding rate (SWAP only) | |||||||
| 8 | okx market trades <instId> [--limit <n>] | Recent public trades | |||||||
| 9 | okx market mark-price --instType <type> [--instId <id>] | Mark price (SWAP / FUTURES / OPTION) | |||||||
| 10 | okx market index-ticker [--instId <id>] [--quoteCcy <ccy>] | Index price (e.g., BTC-USD) | |||||||
| 11 | okx market price-limit <instId> | Upper/lower price limits (SWAP / FUTURES only) | |||||||
| 12 | okx market open-interest --instType <type> [--instId <id>] | Open interest in contracts and base currency | |||||||
| 13 | `okx market instruments-by-category --instCategory <3\ | 4\ | 5\ | 6\ | 7>` | Discover instruments by asset category: 3=Stock tokens (AAPL/TSLA), 4=Metals (gold/silver), 5=Commodities (oil/gas), 6=Forex (EUR/USD), 7=Bonds | |||
| 13† | okx market stock-tokens | Deprecated — use instruments-by-category --instCategory 3 instead | |||||||
| 14 | `okx market filter --instType <SPOT\ | SWAP\ | FUTURES> [--sortBy <field>] [--sortOrder <asc\ | desc>] [--limit <n>] [--baseCcy <ccy>] [--quoteCcy <ccy>] [--settleCcy <ccy>] [--instFamily <fam>] [--ctType <linear\ | inverse>] [--minLast <n>] [--maxLast <n>] [--minChg24hPct <n>] [--maxChg24hPct <n>] [--minMarketCapUsd <n>] [--maxMarketCapUsd <n>] [--minVolUsd24h <n>] [--maxVolUsd24h <n>] [--minFundingRate <n>] [--maxFundingRate <n>] [--minOiUsd <n>] [--maxOiUsd <n>]` | Screen / rank instruments by multi-dimensional criteria (price, volume, OI, funding rate, market cap). Prints Total: N + a ranked table of matching instruments (No results only when nothing matches). Add --json for the raw OKX API v5 response (structurally unchanged). | |||
| 15 | `okx market oi-history <instId> [--bar <5m\ | 15m\ | 1H\ | 4H\ | 1D>] [--limit <n>] [--ts <ms>]` | OI history time series with bar-over-bar delta for a single instrument | |||
| 16 | `okx market oi-change --instType <SWAP\ | FUTURES> [--bar <5m\ | 15m\ | 1H\ | 4H\ | 1D>] [--sortBy <field>] [--sortOrder <asc\ | desc>] [--limit <n>] [--minOiUsd <n>] [--minVolUsd24h <n>] [--minAbsOiDeltaPct <n>]` | Find instruments with largest OI changes (accumulation/distribution scanner) | |
| 17 | okx market indicator list | List all supported indicator names and descriptions | |||||||
| 18 | okx market indicator <indicator> <instId> [--bar] [--params] [--list] [--limit] [--backtest-time] | Technical indicator values. For period-based indicators (ema/ma/wma/rsi/macd/bb/…) the CLI applies a sensible default period when --params is omitted (e.g. EMA/RSI → 14, MACD → 12,26,9, BB → 20,2) so values render without you specifying params; explicit --params always wins. If no values come back, the CLI prints a visible hint (try --params …) — never silent. | |||||||
| 19 | `okx market pair-spread <instIdA> <instIdB> [--bar <5m\ | 15m>] [--window <window>] [--backtest-time <ms>]` | Spread statistics (abs + ratio: mean/stdDev/median/min/max) over a lookback window; supports backtest mode |
Operation Flow
Step 1 — Identify data type and load reference
| User intent | Reference to load | |
|---|---|---|
| Price, candles, order book, recent trades | {baseDir}/references/price-data-commands.md | |
| Technical indicators (RSI, MACD, EMA, BB, KDJ, SuperTrend, AHR999, Rainbow, etc.) | {baseDir}/references/indicator-commands.md | |
| Funding rate, mark price, open interest, price limit, index ticker | {baseDir}/references/derivatives-commands.md | |
| Screen / rank instruments; find top movers, high-OI, high-volume contracts | Use okx market filter directly | |
| OI history time series for a single instrument | Use okx market oi-history directly | |
| OI change scanner; find contracts with large OI shifts | Use okx market oi-change directly | |
| Pair spread statistics; mean-reversion / pairs-trade sizing | Use okx market pair-spread directly | |
| List instruments, discover stock tokens, metals/commodities/forex/bonds, find option instIds | {baseDir}/references/instrument-commands.md | |
| Multi-step or cross-skill workflows; MCP tool names | {baseDir}/references/workflows.md |
Event contracts are not served by this skill.
| User asks | Do | |
|---|---|---|
| Which way an asset is moving — "is BTC going up", "what's the 15m trend" | Answer here with candles / indicators | |
| Direction and whether they can trade it | Answer the data half here, then name okx-cex-trade for the trade half | |
| To trade an event contract — "buy YES/NO on …" | Route to `okx-cex-trade`, serve nothing here |
Never substitute another product for an event contract — not a perp, not a futures position, not market data presented as the contract they asked for. If you cannot load okx-cex-trade, say so and stop.
Step 2 — Run commands immediately
All market data commands are read-only — no confirmation needed.
Step 3 — No writes, no verification needed
All commands in this skill are read-only.
Edge Cases
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/okx-cex-market/SKILL.md
Popularity
- Repository stars
- 43
- Repository forks
- 6
- 7-day trend score
- 19
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 17 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/okx/agent-skills/okx-cex-market)