用途:通过命令行获取 OKX 的公开市场数据,仅供行情查询,不包含策略或交易建议。
主要能力:行情与价格(ticker、tickers、index-ticker、mark-price)、订单簿、成交记录、K线(含指数K线与历史数据)、合约信息、资金费率、持仓量(open-interest、oi-history、oi-change)、价格上下限、配对价差统计,以及 RSI、MACD、EMA、BB 等技术指标;还可按多条件筛选与排序合约。
使用方式:需先全局安装 CLI。
npm install -g @okx_ai/okx-trade-cli okx market ticker BTC-USDT
常用命令包括:okx market ticker <instId>、okx market candles <instId>、okx market orderbook <instId>、okx market funding-rate <instId>、okx market open-interest --instType <type>、okx market filter --instType SPOT、okx market indicator <indicator> <instId>。多数命令支持 --json 输出原始 API v5 响应,--env 包裹环境信息。
适用场景:查询某资产最新价与 24 小时涨跌、查看盘口与K线、检查资金费率与持仓量变化、用筛选器寻找高成交量或持仓量异动合约、计算技术指标数值、比较两个合约的价差。
限制:所有命令为只读,无需 API 密钥,不涉及下单或账户;限速为每 IP 每 2 秒 20 次请求。K线数据按最新在前排序;1 分钟指标不支持,指标时间粒度使用 1Dutc、1Wutc 等写法。instId 格式随品种不同,如 BTC-USDT、BTC-USDT-SWAP、BTC-USD-250328-95000-C;部分命令仅适用于特定品种,如 funding-rate 与 price-limit 仅限 SWAP。拉取大范围历史K线前应估算数量并确认。指标默认周期可在省略 --params 时由 CLI 套用,显式传参优先。ahr999、rainbow 仅支持 BTC-USDT。股票代币有交易时段。账户、下单与事件合约不属于本技能,需转其他技能。