用途:通过 uxc subscribe 的原始 WebSocket 模式运行 OKX 公共交易所 WebSocket 频道,订阅行情数据。通用运行时行为、sink 处理与事件信封解析复用 uxc 技能。
主要能力:覆盖 OKX 公共频道,包括 tickers、trades、books 与 books5、candle 频道。不覆盖 OKX OnchainOS MCP、私有 WebSocket 登录流程、交易/账户/订单管理频道以及 REST API 工作流。
使用方式:前置条件为 uxc 已安装并在 PATH 中、可访问 OKX 公共 WebSocket 端点、有可写的 sink 路径用于 NDJSON 输出。端点使用 wss://ws.okx.com:8443/ws/v5/public。公共频道连接后需发送订阅帧,例如 {"op":"subscribe","args":[{"channel":"tickers","instId":"BTC-USDT"}]}。启动命令:uxc subscribe start wss://ws.okx.com:8443/ws/v5/public --transport websocket --init-frame '{"op":"subscribe","args":[{"channel":"tickers","instId":"BTC-USDT"}]}' --sink file:$HOME/.uxc/subscriptions/okx-btcusdt-ticker.ndjson。可用 tail -n 5 查看 sink 输出,用 uxc subscribe list 与 uxc subscribe status <job_id> 查询状态,用 uxc subscribe stop <job_id> 停止任务。
适用场景:需要以原始 WebSocket 方式采集 OKX 公共行情并落盘为 NDJSON 的场景。
限制:必须始终传 --transport websocket;--init-frame 为必需,因为公共频道复用同一端点;instId 使用 OKX 命名如 BTC-USDT;自动化应基于 JSON 输出信封,不要使用 --text,优先解析 event_kind、data、meta 等稳定字段;公共频道无需登录,不要与私有 WebSocket 认证流程混用;uxc link 不是主要接口,频道选择位于订阅帧中。参考文档见 references/usage-patterns.md 与 https://www.okx.com/docs-v5/en/。