okx-cex-market

OKX CEX 市場數據 CLI

合規聲明：此技能僅提供原始市場數據。不包含任何策略、建議或最佳化邏輯。所有指標輸出均為客觀數值；解讀與交易決策完全由使用者自行負責。

OKX 公開市場數據：價格、訂單簿、K線、資金費率、未平倉合約、交易產品資訊及技術指標。所有指令皆為唯讀，且不需要 API 憑證。

技能分流

• 市場數據 / 指標 → okx-cex-market（此技能）
• 帳戶餘額 / 持倉 → okx-cex-portfolio
• 下單 / 取消訂單 → okx-cex-trade
• 網格 / DCA 機器人 → okx-cex-bot

前置檢查

執行任何指令前，請先遵循 ../_shared/preflight.md。
使用此檔案 frontmatter 中的 metadata.version 作為步驟 2 的參考。

安裝

npm install -g @okx_ai/okx-trade-cli
okx market ticker BTC-USDT   # 驗證

市場數據指令無論在 demo 或 live 模式下皆回傳相同的公開數據 — 不需要 API 憑證。如果使用者的設定檔設有 demo=true 且希望取得即時數據環境，可以使用 --live 來確認處於即時模式（對公開市場數據無影響，但可釐清環境）。務必在使用者查詢相關時告知目前活躍的環境（demo 或 live）。執行任何市場指令前無需確認。在任何指令後加上 --json 可取得原始 OKX API v5 回應。加上 --env 可將輸出包裝為 {"env", "profile", "data"}。

---

指令索引

#	指令	說明
1	okx market ticker <instId>	最新價格、24小時高低/成交量/漲跌幅%
2	okx market tickers <instType>	所有 SPOT / SWAP / FUTURES / OPTION 的報價
3	okx market instruments --instType <type> [--instId <id>]	列出交易產品（instId, ctVal, lotSz, minSz, tickSz, state）
4	okx market orderbook <instId> [--sz <n>]	訂單簿賣出/買入（預設每側前5檔，最多400檔）
5	okx market candles <instId> [--bar <bar>] [--limit <n>] [--after <ts>] [--before <ts>]	OHLCV K線（預設 --bar 1m）；自動路由至歷史端點以取得2021年起的數據；--after 向後分頁，--before 向前分頁
6	okx market index-candles <instId> [--bar <bar>] [--limit <n>] [--history]	指數 OHLCV（使用 BTC-USD 而非 BTC-USDT）
7	okx market funding-rate <instId> [--history] [--limit <n>]	當前或歷史資金費率（僅 SWAP）
8	okx market trades <instId> [--limit <n>]	近期公開成交
9	okx market mark-price --instType <type> [--instId <id>]	標記價格（SWAP / FUTURES / OPTION）
10	okx market index-ticker [--instId <id>] [--quoteCcy <ccy>]	指數價格（例如 BTC-USD）
11	okx market price-limit <instId>	價格上下限（僅 SWAP / FUTURES）
12	okx market open-interest --instType <type> [--instId <id>]	以合約數與基礎貨幣計的未平倉合約
13	okx market instruments-by-category --instCategory <3|4|5|6|7>	依資產類別探索交易產品：3=股票代幣（AAPL/TSLA）、4=金屬（黃金/白銀）、5=大宗商品（原油/天然氣）、6=外匯（EUR/USD）、7=債券
13†	okx market stock-tokens	已棄用 — 請改用 instruments-by-category --instCategory 3
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>]	依多維度條件篩選/排名交易產品（價格、成交量、OI、資金費率、市值）。輸出 Total: N 加上符合條件的排名表格（若無符合則顯示 No results）。加上 --json 可取得原始 OKX API v5 回應（結構不變）。
15	okx market oi-history <instId> [--bar <5m|15m|1H|4H|1D>] [--limit <n>] [--ts <ms>]	單一交易產品的 OI 歷史時間序列，含相鄰 K 線變化量
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>]	尋找 OI 變化最大的交易產品（累積/分配掃描器）
17	okx market indicator list	列出所有支援的指標名稱與說明
18	okx market indicator <indicator> <instId> [--bar] [--params] [--list] [--limit] [--backtest-time]	技術指標數值。對於需要週期的指標（ema/ma/wma/rsi/macd/bb/…），若省略 --params，CLI 會自動套用合理的預設週期（例如 EMA/RSI → 14，MACD → 12,26,9，BB → 20,2），使表格有值而非空白；明確指定 --params 則以指定值為準。若無回傳數值，CLI 會顯示提示（try --params …），絕不會無聲無息。
19	okx market pair-spread <instIdA> <instIdB> [--bar <5m|15m>] [--window <window>] [--backtest-time <ms>]	價差統計（絕對值與比率：平均/標準差/中位數/最小值/最大值），支援回測模式

---

操作流程

步驟 1 — 識別數據類型並載入參考

使用者意圖	需載入的參考文件
價格、K線、訂單簿、近期成交	{baseDir}/references/price-data-commands.md
技術指標（RSI、MACD、EMA、BB、KDJ、SuperTrend、AHR999、Rainbow 等）	{baseDir}/references/indicator-commands.md
資金費率、標記價格、未平倉合約、價格限制、指數報價	{baseDir}/references/derivatives-commands.md
篩選/排名交易產品；尋找漲跌幅排行、高OI、高成交量合約	直接使用 okx market filter
單一交易產品的 OI 歷史時間序列	直接使用 okx market oi-history
OI 變化掃描器；尋找 OI 大幅變動的合約	直接使用 okx market oi-change
價差統計；均值回歸/配對交易規模計算	直接使用 okx market pair-spread
列出交易產品、探索股票代幣、金屬/大宗商品/外匯/債券、尋找選擇權 instId	{baseDir}/references/instrument-commands.md
多步驟或跨技能工作流程；MCP 工具名稱	{baseDir}/references/workflows.md

步驟 2 — 立即執行指令

所有市場數據指令皆為唯讀 — 無需確認。

步驟 3 — 無需寫入或驗證

此技能中的所有指令皆為唯讀。

---

邊界情況

• instId 格式：現貨 BTC-USDT · 永續合約 BTC-USDT-SWAP · 交割合約 BTC-USDT-250328 · 選擇權 BTC-USD-250328-95000-C · 指數 BTC-USD · 股票代幣 TSLA-USDT-SWAP · 金屬/大宗商品/外匯/債券：請先使用 instruments-by-category 探索有效的 instId
• 選擇權列表：instruments --instType OPTION 需要 --uly BTC-USD；若不確定，請先執行 open-interest --instType OPTION 以發現活躍的 instId
• funding-rate / price-limit：僅限 SWAP · mark-price：僅限 SWAP / FUTURES / OPTION
• K線 --bar：大寫 — 1H 而非 1h；使用 --after <ts> 向後分頁至歷史數據（可回溯至2021年）；index-candles 支援 --history 以取得更長歷史
• ⚠️ 大範圍歷史數據：在使用 --after/--before 擷取前，請估算 K線數量 = time_range_ms / bar_interval_ms。若估算值 > 500，請告知使用者估算數量並請求確認後再繼續。避免無聲無息地填滿上下文視窗。
• 指標 --bar：使用 1Dutc 而非 1D，1Wutc 而非 1W — 與 K線的 bar 值不同
• market filter 的 sortBy 值：last chg24hPct marketCapUsd volUsd24h fundingRate oiUsd listTime — 預設為 volUsd24h
• market filter 的 ctType：linear 或 inverse（僅限 SWAP/FUTURES）；現貨請省略
• market filter 的 quoteCcy：支援逗號分隔列表，例如 --quoteCcy USDT,USDC
• market filter 現貨 + quoteCcy：當 --instType SPOT 時，API 會回傳所有報價貨幣（USDT、USDC、BTC、ETH 等）混合的產品 — 這會污染排序順序並膨脹結果。除非使用者明確要求其他報價貨幣，否則預設一律加上 --quoteCcy USDT。
• market filter 的 chg24hPct：數值為百分比數字 — --minChg24hPct -5 表示 -5%，--maxChg24hPct 10 表示 10%
• market oi-history 的 ts：Unix 毫秒時間戳；回傳 ts ≤ 此值的 K線，用於歷史分頁
• market oi-history / oi-change 的 bar：有效值為 5m 15m 1H 4H 1D — 預設 1H。伺服器接受大小寫變體（1h 等同 1H），但建議使用標準大小寫。
• market oi-history 的 limit：1–500（預設 50）
• market oi-change 的 instType：僅支援 SWAP 或 FUTURES（不支援現貨）
• market oi-change 的 minAbsOiDeltaPct：依絕對 OI 變化過濾 — 1.0 僅保留 |oiDeltaPct| ≥ 1% 的資料列
• market oi-change 的 sortBy 值：oiUsd oiDeltaUsd oiDeltaPct absOiDeltaPct volUsd24h fundingRate last — 預設 oiDeltaPct（帶正負號）。使用 absOiDeltaPct 可依 |oiDeltaPct| 排名（無論方向，取絕對值最大者）。
• market oi-change 的 limit：1–100（預設 20）。若需超過 100 筆，請針對每個 instId 使用 oi-history。
• 指標 --bar 的有效值：3m 5m 15m 1H 4H 12Hutc 1Dutc 3Dutc 1Wutc — 指標不支援 1m（1分鐘數據請使用 candles）
• 指標 --limit：1–100（僅在搭配 returnList 要求歷史序列時使用）
• 指標參數順序：指標名稱在前，instId 在後 — okx market indicator rsi BTC-USDT
• 指標 --params：逗號分隔，無空格 — --params 5,20。對於需要週期的指標（ema/ma/wma/rsi/macd/bb/…），省略 --params 會讓 CLI 代入預設週期（EMA/MA/WMA/RSI → 14，MACD → 12,26,9，BB → 20,2），使表格有值而非空白；明確傳入 --params 可覆蓋預設值。（僅 CLI 便利功能 — MCP 的 market_get_indicator 原始數據路徑仍需明確的 paramList。）
• 指標無回傳數值：CLI 絕不會輸出空白 — 若查詢無結果（例如非週期性指標，或週期性指標無預設值），會顯示提示：No indicator values returned. This indicator may require a period — try --params (e.g. --params 14).
• 僅限 BTC 的指標：ahr999、rainbow — 僅限 BTC-USDT
• 未知的指標名稱：在呼叫 API 前會回傳 ValidationError 並提供相似名稱建議 — 請使用 market_list_indicators / okx market indicator list 查看所有有效名稱
• 股票代幣交易時間：美股交易時間為週一至週五約 09:30–16:00 ET；操作前請確認即時價格
• 無數據回傳：交易產品可能已下架 — 請用 okx market instruments 驗證
• boll 是 bb 的別名

全域注意事項

• 此技能中的所有指令均不需要 API 金鑰
• 速率限制：每 IP 每 2 秒 20 次請求
• K線數據按時間由新到舊排序
• vol24h 以基礎貨幣計（例如 BTC-USDT 中的 BTC）
• --demo/--live 和 --profile 不影響 CLI 的市場數據結果（公開端點）；它們僅決定活躍的交易環境上下文