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   # 验证

市场数据命令返回相同的公开数据，与演示/实盘模式无关——无需 API 凭证。如果用户的配置文件设置了 demo=true 且他们需要实盘数据上下文，可以使用 --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>]	按多维度条件（价格、成交量、持仓量、资金费率、市值）筛选/排名交易产品。输出 Total: N + 匹配产品的排名表格（无匹配时显示 No results）。添加 --json 获取原始 OKX API v5 响应（结构不变）。
15	okx market oi-history <instId> [--bar <5m|15m|1H|4H|1D>] [--limit <n>] [--ts <ms>]	单个交易产品的持仓量历史时间序列，含柱间变化量
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>]	查找持仓量变化最大的交易产品（积累/派发扫描器）
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、彩虹图等）	{baseDir}/references/indicator-commands.md
资金费率、标记价格、持仓量、价格限制、指数行情	{baseDir}/references/derivatives-commands.md
筛选/排名交易产品；查找涨幅榜、高持仓量、高成交量合约	直接使用 okx market filter
单个交易产品的持仓量历史时间序列	直接使用 okx market oi-history
持仓量变化扫描器；查找持仓量大幅变动的合约	直接使用 okx market oi-change
价差统计；均值回归/配对交易规模	直接使用 okx market pair-spread
列出交易产品、发现股票代币、贵金属/大宗商品/外汇/债券、查找期权 instId	{baseDir}/references/instrument-commands.md
多步骤或跨技能工作流；MCP 工具名称	{baseDir}/references/workflows.md

步骤 2 — 立即运行命令

所有市场数据命令均为只读——无需确认。

步骤 3 — 无需写入，无需验证

本技能中的所有命令均为只读。

---

边界情况

• instId 格式：SPOT BTC-USDT · SWAP BTC-USDT-SWAP · FUTURES BTC-USDT-250328 · OPTION BTC-USD-250328-95000-C · 指数 BTC-USD · 股票代币 TSLA-USDT-SWAP · 贵金属/大宗商品/外汇/债券：先使用 instruments-by-category 发现有效的 instId
• OPTION 列表：instruments --instType OPTION 需要 --uly BTC-USD；如果未知，先运行 open-interest --instType OPTION 发现活跃的 instId
• funding-rate / price-limit：仅 SWAP · mark-price：仅 SWAP / FUTURES / OPTION
• candles --bar：大写——1H 而非 1h；使用 --after <ts> 向前翻页到历史数据（可回溯至2021年）；index-candles 支持 --history 获取更长的历史
• ⚠️ 大范围历史数据：在使用 --after/--before 获取之前，估算 K线数量 = time_range_ms / bar_interval_ms。如果估算值 > 500，告知用户估算数量并在继续前请求确认。这可以防止静默填满上下文窗口。
• indicator --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）；SPOT 省略
• market filter quoteCcy：支持逗号分隔列表，例如 --quoteCcy USDT,USDC
• market filter SPOT + 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 ≤ 该值的柱，用于历史翻页
• 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（不支持 SPOT）
• market oi-change minAbsOiDeltaPct：按绝对持仓量变化过滤——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。
• indicator --bar 有效值：3m 5m 15m 1H 4H 12Hutc 1Dutc 3Dutc 1Wutc——指标不支持 1m（如需1分钟数据，请使用 candles）
• indicator --limit：1–100（仅在使用 returnList 时，即请求历史序列时）
• indicator 参数顺序：指标名称在 instId 之前——okx market indicator rsi BTC-USDT
• indicator --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。）
• indicator 无返回值：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 不影响市场数据结果（公共端点）；它们仅决定活跃交易环境上下文