okx/agent-skills

okx-cex-market

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

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/okx/agent-skills --skill okx-cex-market

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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 / Smart Portfolio / Recurring Buy 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

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

#CommandDescription
1okx market ticker <instId>Last price, 24h high/low/vol/change%
2okx market tickers <instType>All tickers for SPOT / SWAP / FUTURES / OPTION
3okx 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
4okx market orderbook <instId> [--sz <n>]Order book asks/bids (default top 5 per side, max 400)
5okx market candles <instId> [--bar <bar>] [--limit <n>] [--after <ts>] [--before <ts>]OHLCV candles (default --bar 1m; UTC+0 bars 6Hutc…3Mutc available from 6H up); auto-routes to historical endpoint for data back to 2021; --after paginates back in time, --before paginates forward
6okx market index-candles <instId> [--bar <bar>] [--limit <n>] [--history]Index OHLCV (use BTC-USD not BTC-USDT)
7okx market funding-rate <instId> [--history] [--limit <n>]Current or historical funding rate (SWAP only)
8`okx market trades <instId> [--limit <n>] [--history [--type <1\2>] [--after <id\ts>] [--before <id>]]`Recent public trades (default 20, max 500). --history pages through the last 3 months (max 100 per page); --type/--after/--before require --history and are rejected otherwise
9okx market mark-price --instType <type> [--instId <id>]Mark price (SWAP / FUTURES / OPTION)
10okx market index-ticker [--instId <id>] [--quoteCcy <ccy>]Index price (e.g., BTC-USD)
11okx market price-limit <instId>Upper/lower price limits (SWAP / FUTURES only)
12okx 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-tokensDeprecated — 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)
17okx market indicator listList all supported indicator names and descriptions
18okx market indicator <indicator> <instId> [--bar] [--params] [--list] [--limit] [--backtest-time]Technical indicator values. Omit `--params` to use the indicator's default (e.g. MACD 12,26,9, BB 20,2, RSI 14, MA 5,20,60, EMA 5,20, Supertrend 3,10); the CLI prints params: … (default). If you pass `--params` it must be complete — too few or too many values is an error (e.g. --params 12,26 for macd). Full list of params and defaults: references/indicator-commands.md. Unknown indicator names are rejected.
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 intentReference 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 contractsUse okx market filter directly
OI history time series for a single instrumentUse okx market oi-history directly
OI change scanner; find contracts with large OI shiftsUse okx market oi-change directly
Pair spread statistics; mean-reversion / pairs-trade sizingUse 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 asksDo
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 itAnswer 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

  • 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 or --instFamily BTC-USD; if unknown, run open-interest --instType OPTION first to discover active instIds
  • EVENTS listing: instruments --instType EVENTS requires --seriesId (e.g. --seriesId BTC-ABOVE-DAILY); run okx event series first to discover valid series IDs
  • funding-rate / price-limit: SWAP only · mark-price: SWAP / FUTURES / OPTION only
  • candles `--bar`: uppercase — 1H not 1h; use --after <ts> 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.
  • `--bar` sets differ by command: the candles list is not the indicator list. Read the matching reference (price-data-commands.md / indicator-commands.md) for each command's bars.
  • indicator `--bar`: uses 1Dutc not 1D, 1Wutc not 1W — indicators accept only the values listed below (a subset of the 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`: either omit it (default used) or pass the complete set — comma-separated integers, no spaces, given once: --params 12,26,9. Fixed-length indicators need exactly the full set (macd 3, kdj 3, bb 2, supertrend 2 as factor,atrPeriod, stoch-rsi 4, …); ma/ema/rsi/wr/wma/dema/tema/zlema/hma/kama take one or more periods. Periods are 2–365; the bb multiplier and supertrend factor are 1–9; alphatrend and halftrend take any int32 integer (negative allowed, no 2–365 range). A leading negative value parses (--params -9,3,3) but is rejected as out of range where the slot is a period or factor. Non-numeric tokens, a wrong count or an out-of-range value fail with an error that shows the expected signature, default and example; a repeated --params fails with specify --params once, comma-separated. Indicators not covered by the params contract (obv, vwap, sar, …) have no default and no count or range check, but malformed values (non-numeric, null, overflow) are still rejected.
  • indicator no values returned: (1) explicit --params and no timeframe returns values → table mode fails with No values returned for <indicator> with params [...] (the period may exceed the available candles), exit code 1; --json prints the raw backend data and exits 0 as before. (2) --params omitted and a default was applied (the params: … (default) line is shown) → prints No indicator values returned for the default params; there may not be enough candles for this instrument and bar. (3) --params omitted for an indicator without a default → prints 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
같은 저장소의 Skills

더 많은 Skills

모든 Skills
okx
커뮤니티

okx-sentiment-tracker

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', 'FO

1시간 설치 수
5
GitHub Stars
201
업데이트
11월 13일
okx
커뮤니티

earn-hunter

Automatically monitors OKX Flash Earn, Fixed Earn and Flexible Earn opportunities, sends push notifications, and guides subscription. 自动监控 OKX 闪赚、定期和活期赚币机会,推送通知并引导申购。Use when user says: 有闪赚通知我, 监控赚币, monitor earn, notify me about earn, 定时检查理财, 执行 earn-hunter 扫描, earn-hunter scan, 活期年化高了通知我, 监控活期.

1시간 설치 수
3
GitHub Stars
201
업데이트
11월 13일
okx
커뮤니티

okx-cex-auth

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', 'requiresauth', '401 Unauthorized', 'token expired/not found', 'StorageNotFoundError', '会话过期', '未认证', '需要登录'. Also when the user asks about login status or the login was

1시간 설치 수
3
GitHub Stars
201
업데이트
11월 13일
okx
커뮤니티

okx-cex-bot

Manage Grid bots (spot/contract/coin-margined), DCA Martingale bots (Spot DCA 现货马丁 / Contract DCA 合约马丁), Smart Portfolio bots (智能组合, auto-rebalancing multi-asset portfolio), and Recurring Buy strategies (定投, periodic fixed-amount multi-coin buys) on OKX. Covers create, stop, pause, amend, monitor P&L, TP/SL, margin/investment adjustment, AI-recommended parameters, and recommended zone backtest. Requires API credentials. Not for regular orders (okx-cex-trade), market data (okx-cex-market), or acc

1시간 설치 수
3
GitHub Stars
201
업데이트
11월 13일