okx-cex-market

OKX CEX 市场数据 CLI

合规声明：此技能仅提供原始市场数据，不包含策略、建议或优化逻辑。所有指标输出均为客观数值；如何解读和做出交易决策完全由用户自行负责。

OKX 公开市场数据：价格、订单簿、K 线、资金费率、未平仓量、交易品种信息和技术指标。所有命令均为只读，且无需 API 凭据。

技能路由

• 市场数据 / 指标 → okx-cex-market（此技能）
• 账户余额 / 持仓 → okx-cex-portfolio
• 下单 / 撤单 → okx-cex-trade
• 将方向性观点作为事件合约进行交易 → okx-cex-trade
• 市场情绪 / 看涨看跌程度最高的币种 → okx-sentiment-tracker
• 网格 / DCA 机器人 → okx-cex-bot

运行前检查

运行任何命令前，请遵循 ../_shared/preflight.md。 使用此文件 frontmatter 中的 metadata.version 作为步骤 2 的参考。

安装

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

无论是模拟盘还是实盘模式，市场数据命令返回的公开数据都相同，无需 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>] [--uly <uly>] [--instFamily <fam>] [--seriesId <id>]	列出交易品种（instId、ctVal、lotSz、minSz、tickSz、state）；OPTION 需要 --uly 或 --instFamily；EVENTS 需要 --seriesId
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、Rainbow 等）	{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

本技能不提供事件合约服务。

用户询问	操作
某项资产的走势——“BTC 在涨吗”“15m 趋势如何”	在此作答，使用 K 线／指标
方向以及能否交易	在此回答数据部分，然后指出交易部分应使用 okx-cex-trade
交易事件合约——“买入……的 YES/NO”	转交给 okx-cex-trade，此处不提供服务

绝不要用其他产品替代事件合约——不能用永续合约、期货头寸，也不能把市场数据说成用户所问的合约。如果无法加载 okx-cex-trade，请说明并停止。

步骤 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 或 --instFamily BTC-USD；如果未知，先运行 open-interest --instType OPTION 查找活跃的 instId
• EVENTS 列表：instruments --instType EVENTS 需要 --seriesId（例如 --seriesId BTC-ABOVE-DAILY）；先运行 okx event series 查找有效的系列 ID
• 资金费率／价格限制：仅适用于 SWAP · 标记价格：仅适用于 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）；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 ≤ 此值的 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（不支持 SPOT）
• 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 获取的市场数据结果（公开端点）；它们仅决定当前的交易环境上下文