# okx cex market ## Metadata - Canonical URL: https://6ducklearn.com/skills/okx-cex-market/ - Markdown URL: https://6ducklearn.com/skills/okx-cex-market/index.md - Product: skills - Category: market-research - Tags: okx, trading, official, curated, market-research - Updated: 2026-07-11T06:17:26.001373+00:00 ## Summary 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). ## Content > **6DuckLearn provenance:** Official OKX skill from https://github.com/okx/agent-skills. Curated here means source-reviewed by 6DuckLearn; it is not an endorsement of a strategy, asset, return claim, or suitability. > > **Financial safety boundary:** Never request secrets in chat. Before any external API call or action that places, cancels, or amends an order; changes leverage; transfers funds; creates or stops a bot; subscribes to or redeems an earn product; or signs/broadcasts a transaction, show the exact live/demo profile, instrument, side, size, price constraints, fees, and worst-case loss, then obtain explicit user approval. Default to read-only or demo mode when uncertain. Treat all analysis as research, not investment advice. # 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` - Grid / DCA bots → `okx-cex-bot` ## Preflight Before running any command, follow [`../_shared/preflight.md`](../_shared/preflight.md). Use `metadata.version` from this file's frontmatter as the reference for Step 2. ## Install ```bash npm install -g @okx_ai/okx-trade-cli okx market ticker BTC-USDT # verify ``` 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 ` | Last price, 24h high/low/vol/change% | | 2 | `okx market tickers ` | All tickers for SPOT / SWAP / FUTURES / OPTION | | 3 | `okx market instruments --instType [--instId ]` | List instruments (instId, ctVal, lotSz, minSz, tickSz, state) | | 4 | `okx market orderbook [--sz ]` | Order book asks/bids (default top 5 per side, max 400) | | 5 | `okx market candles [--bar ] [--limit ] [--after ] [--before ]` | 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 [--bar ] [--limit ] [--history]` | Index OHLCV (use `BTC-USD` not `BTC-USDT`) | | 7 | `okx market funding-rate [--history] [--limit ]` | Current or historical funding rate (SWAP only) | | 8 | `okx market trades [--limit ]` | Recent public trades | | 9 | `okx market mark-price --instType [--instId ]` | Mark price (SWAP / FUTURES / OPTION) | | 10 | `okx market index-ticker [--instId ] [--quoteCcy ]` | Index price (e.g., BTC-USD) | | 11 | `okx market price-limit ` | Upper/lower price limits (SWAP / FUTURES only) | | 12 | `okx market open-interest --instType [--instId ]` | 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 [--sortBy ] [--sortOrder ] [--limit ] [--baseCcy ] [--quoteCcy ] [--settleCcy ] [--instFamily ] [--ctType ] [--minLast ] [--maxLast ] [--minChg24hPct ] [--maxChg24hPct ] [--minMarketCapUsd ] [--maxMarketCapUsd ] [--minVolUsd24h ] [--maxVolUsd24h ] [--minFundingRate ] [--maxFundingRate ] [--minOiUsd ] [--maxOiUsd ]` | 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 [--bar <5m\|15m\|1H\|4H\|1D>] [--limit ] [--ts ]` | OI history time series with bar-over-bar delta for a single instrument | | 16 | `okx market oi-change --instType [--bar <5m\|15m\|1H\|4H\|1D>] [--sortBy ] [--sortOrder ] [--limit ] [--minOiUsd ] [--minVolUsd24h ] [--minAbsOiDeltaPct ]` | 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 [--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 [--bar <5m\|15m>] [--window ] [--backtest-time ]` | 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` | ### 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 - **instId format**: SPOT `BTC-USDT` · SWAP `BTC-USDT-SWAP` · FUTURES `BTC-USDT-250328` · OPTION `BTC-USD-250328-95000-C` · Index `BTC-USD` · Stock token `TSLA-USDT-SWAP` · Metals/Commodities/Forex/Bonds: use `instruments-by-category` to discover valid instIds first - **OPTION listing**: `instruments --instType OPTION` requires `--uly BTC-USD`; if unknown, run `open-interest --instType OPTION` first to discover active instIds - **funding-rate / price-limit**: SWAP only · mark-price: SWAP / FUTURES / OPTION only - **candles `--bar`**: uppercase — `1H` not `1h`; use `--after ` to paginate back into historical data (back to 2021); index-candles supports `--history` for extended history - **⚠️ Large historical range**: before fetching with `--after`/`--before`, estimate candle count = `time_range_ms / bar_interval_ms`. If estimate > 500, tell the user the estimated count and ask for confirmation before proceeding. This prevents silently filling the context window. - **indicator `--bar`**: uses `1Dutc` not `1D`, `1Wutc` not `1W` — different from candle bar values - **`market filter` sortBy values**: `last` `chg24hPct` `marketCapUsd` `volUsd24h` `fundingRate` `oiUsd` `listTime` — default `volUsd24h` - **`market filter` ctType**: `linear` or `inverse` (SWAP/FUTURES only); omit for SPOT - **`market filter` quoteCcy**: comma-separated list supported, e.g. `--quoteCcy USDT,USDC` - **`market filter` SPOT + quoteCcy**: when `--instType SPOT`, the API returns instruments across **all** quote currencies (USDT, USDC, BTC, ETH, etc.) mixed together — this pollutes sort order and bloats results. Always pass `--quoteCcy USDT` by default unless the user explicitly asks for other quote currencies. - **`market filter` chg24hPct**: value is a percentage number — `--minChg24hPct -5` means -5%, `--maxChg24hPct 10` means 10% - **`market oi-history` ts**: Unix ms timestamp; returns bars with ts ≤ this value for historical pagination - **`market oi-history` / `oi-change` bar**: valid values `5m` `15m` `1H` `4H` `1D` — default `1H`. Server accepts case variants (`1h` == `1H`) but prefer canonical casing. - **`market oi-history` limit**: 1–500 (default 50) - **`market oi-change` instType**: only `SWAP` or `FUTURES` supported (not SPOT) - **`market oi-change` minAbsOiDeltaPct**: filters by absolute OI change — `1.0` keeps only rows where |oiDeltaPct| ≥ 1% - **`market oi-change` sortBy values**: `oiUsd` `oiDeltaUsd` `oiDeltaPct` `absOiDeltaPct` `volUsd24h` `fundingRate` `last` — default `oiDeltaPct` (signed). Use `absOiDeltaPct` to rank by |oiDeltaPct| (largest magnitude regardless of direction). - **`market oi-change` limit**: 1–100 (default 20). For deeper than 100 rows, fetch `oi-history` per instId. - **indicator `--bar` valid values**: `3m` `5m` `15m` `1H` `4H` `12Hutc` `1Dutc` `3Dutc` `1Wutc` — `1m` is **not supported** for indicators (use `candles` for 1-minute data) - **indicator `--limit`**: 1–100 (only used with `returnList`, i.e. when a historical series is requested) - **indicator arg order**: indicator name before instId — `okx market indicator rsi BTC-USDT` - **indicator `--params`**: comma-separated, no spaces — `--params 5,20`. For period-based indicators (ema/ma/wma/rsi/macd/bb/…) omitting `--params` makes the CLI substitute a default period (EMA/MA/WMA/RSI → `14`, MACD → `12,26,9`, BB → `20,2`) so the table is populated instead of empty; pass `--params` explicitly to override the default. (CLI-only convenience — the MCP `market_get_indicator` raw-data path still requires an explicit `paramList`.) - **indicator no values returned**: the CLI never prints nothing — if a query yields no values (e.g. a non-period indicator, or a period indicator with no default), it prints a visible hint: `No indicator values returned. This indicator may require a period — try --params (e.g. --params 14).` - **BTC-only indicators**: `ahr999`, `rainbow` — BTC-USDT only - **Unknown indicator name**: returns a `ValidationError` with similar-name suggestions before the API is called — use `market_list_indicators` / `okx market indicator list` to see all valid names - **Stock token hours**: US stocks trade Mon–Fri ~09:30–16:00 ET; verify live price before acting - **No data returned**: instrument may be delisted — verify with `okx market instruments` - **`boll`** is an alias for `bb` ## Global Notes - No API key required for any command in this skill - Rate limit: 20 req / 2 s per IP - Candle data is sorted newest-first - `vol24h` is in base currency (e.g., BTC for BTC-USDT) - `--demo`/`--live` and `--profile` do not affect market data results via CLI (public endpoints); they only determine the active trading environment context ## Related Skills - [okx cex smartmoney](https://6ducklearn.com/skills/okx-cex-smartmoney/index.md): Smart Money analytics on OKX: leaderboard traders, position tracking, trade records, closed-position history, aggregated consensus signals, and signal history. Use this skill when the user asks about 聪明钱, smart money, 牛人榜, leaderboard, top traders, 交易员排行, trader ranking, trader positions, trader PnL, 交易员持仓, 交易员收益, 历史平仓, closed positions, realized PnL track record, trade history, 成交记录, smart money signal, 聪明钱信号, long/short ratio, 多空比, capital flow, 资金流向, position conviction, 仓位强度, entry price distribution, smart money overview, 聪明钱总览, signal history, 信号历史, trader search, 搜索交易员, who is trading BTC, 谁在交易BTC, recommend traders, 推荐交易员, best traders, top performers. - [okx sentiment tracker](https://6ducklearn.com/skills/okx-sentiment-tracker/index.md): Use this skill when the user asks about: 'any crypto news', 'latest news', 'market update', 'daily briefing', 'BTC news', 'ETH news', 'news on SOL', 'search SEC ETF', 'regulation news', 'Bitcoin halving', 'is BTC bullish or bearish', 'coin sentiment', 'sentiment trend', 'trending coins', 'top bullish coins', 'bearish sentiment', 'social buzz', 'market mood', 'fear and greed', 'full article', 'read more', 'economic calendar', '经济日历', 'macro data', '宏观数据', 'NFP', 'nonfarm', '非农', 'CPI', 'GDP', 'FOMC', '利率决议', 'interest rate decision', 'PMI', 'unemployment rate', '失业率', 'economic events', '经济事件', or any request for crypto news, market intelligence, sentiment analysis, social trend data, or macro-economic calendar. Requires API credentials. Do NOT use for market prices/candles (okx-cex-market), placing orders (okx-cex-trade), or account info (okx-cex-portfolio). - [earn hunter](https://6ducklearn.com/skills/earn-hunter/index.md): Automatically monitors OKX Flash Earn, Fixed Earn, and Flexible Earn opportunities, sends push notifications, and guides subscription. Use when user says: Notify me about Flash Earn, monitor earn, notify me about earn, check financial products regularly, execute earn-hunter scan, earn-hunter scan, notify me when flexible annual yield is high, monitor flexible earn. - [okx cex auth](https://6ducklearn.com/skills/okx-cex-auth/index.md): Use this skill when the user wants to 'login/log in/sign in', 'authenticate', 'authorize', 'connect OKX account', 'set up credentials', 'first time setup', 'configure okx', '登录', '授权', '认证', '连接账户', '首次配置'. Also when any OKX CLI command fails with an auth error: 'Run okx auth login first', 'Session expired', 'not authenticated', 'requires_auth', '401 Unauthorized', 'token expired/not found', 'StorageNotFoundError', '会话过期', '未认证', '需要登录'. Also when the user asks about login status or the login was interrupted. Also when the user wants to install/update/check/remove the okx-auth binary — 'install/update/remove auth', 'download okx-auth', '安装/更新/卸载认证', 'auth binary status', 'Failed to spawn okx-auth'. Also use before using okx-cex-trade/portfolio/earn/bot for the first time. Do NOT use for market data queries (use okx-cex-market). - [okx cex bot](https://6ducklearn.com/skills/okx-cex-bot/index.md): Manage Grid bots (spot/contract/coin-margined) and DCA Martingale bots (Spot DCA 现货马丁 / Contract DCA 合约马丁) on OKX. Covers create, stop, amend, monitor P&L, TP/SL, margin/investment adjustment, and AI-recommended parameters. Requires API credentials. Not for regular orders (okx-cex-trade), market data (okx-cex-market), or account info (okx-cex-portfolio). - [okx cex earn](https://6ducklearn.com/skills/okx-cex-earn/index.md): Manages OKX Simple Earn (flexible savings/lending), Flash Earn, On-chain Earn (staking/DeFi), Dual Investment (DCD/双币赢), and AutoEarn (自动赚币) via the okx CLI. Use this skill whenever the user wants to check earn balances, browse flash-earn projects, subscribe or redeem earn products, view or set lending rates, monitor on-chain staking orders, interact with dual investment structured products, or manage auto-earn — even if phrased casually as 活期赚币, 定期赚币, 闪赚, 赚币, 申购, 赎回, 链上赚币, 质押, 理财, 双币赢, 双币理财, 双币申购, 高卖, 低买, dual investment, DCD, flash earn, buy low, sell high structured product, earn with target price, 目标价, 自动赚币, auto earn, auto-earn, 自动借出, 自动质押, auto lend, auto staking, USDG earn, USDG 赚币, 闲置资金自动理财, fixed earn, fixed deposit, term deposit, 定期理财, 定期. Also use when the user asks about idle funds and whether to earn on them.