Onchain OS DEX WebSocket 是一个统一技能，用于消费实时 DEX（去中心化交易所）数据。它面向需要获取链上实时行情、代币交易、信号追踪与 Meme 币动态的用户，提供两种接入方式。
一、用途 该技能用于实时获取 DEX 相关数据，包括市场价格与 K 线、代币详情与逐笔成交、聪明钱与 KOL 交易信号、钱包地址活动追踪，以及 Meme 代币的发行与指标更新。它既适合人工监控，也适合智能体驱动的工作流和自定义机器人。
二、主要能力
- CLI 方式（onchainos ws）：可启动后台会话、增量轮询事件、列出与停止会话。提供以下子命令：
- onchainos ws channels：列出全部 9 个受支持的频道。
- onchainos ws channel-info --channel <name>：查看某个频道的详细信息与示例。
- onchainos ws start --channel <channel> [params]：启动后台会话。
- onchainos ws poll --id <ID> [--channel <ch>]：拉取新事件。
- onchainos ws list：列出会话。
- onchainos ws stop [--id <ID>]：停止会话。
- 支持 9 个频道，按组划分：
- signal 组：kol_smartmoney-tracker-activity（global，无必填参数）、address-tracker-activity（per-wallet，需 --wallet-addresses）、dex-market-new-signal-openapi（per-chain，需 --chain-index）。
- market 组：price（per-token，需 --token-pair）、dex-token-candle{period}（per-token，需 --token-pair）。
- token 组：price-info（per-token，需 --token-pair）、trades（per-token，需 --token-pair）。
- trenches 组：dex-market-memepump-new-token-openapi（per-chain，需 --chain-index）、dex-market-memepump-update-metrics-openapi（per-chain，需 --chain-index）。
- 参数格式：
- --token-pair：chainIndex:tokenContractAddress，例如 1:0xdac17f958d2ee523a2206206994597c13d831ec7。
- --chain-index：逗号分隔的链 ID，例如 1,501,56。
- --wallet-addresses：逗号分隔的地址，最多 200 个。
- --idle-timeout：若在该时长内无轮询则自动停止，默认 30m；可写 1h、2h、300s，或 0 表示禁用。
- 轮询过滤器（仅限 tracker 频道，即 kol_smartmoney-tracker-activity 与 address-tracker-activity）：--min-quote-amount、--min-market-cap、--min-pnl、--trader（钱包地址前缀匹配）、--tag（smart_money 或 kol）、--trade-type（buy 或 sell）、--since（毫秒时间戳）。
- 自定义脚本方式：用户可自行编写 Python/Node/Rust WebSocket 客户端。需阅读对应协议参考文件：
- 市场数据（price 与 candlestick 流）：读 ../okx-dex-market/references/ws-protocol.md。
- 代币数据（详细代币流）：读 ../okx-dex-token/references/ws-protocol.md。
- 信号与钱包追踪：读 ../okx-dex-signal/references/ws-protocol.md。
- Meme/Trenches：读 ../okx-dex-trenches/references/ws-protocol.md。
- 通用协议（所有频道共享）：端点 wss://wsdex.okx.com/ws/v6/dex；认证需在订阅前进行 HMAC-SHA256 登录；心跳每 25 秒发送 "ping"，预期收到 "pong"；订阅格式 {"op": "subscribe", "args": [...]}；取消订阅格式 {"op": "unsubscribe", "args": [...]}。
三、使用方式
- 预检：阅读 ../okx-agentic-wallet/_shared/preflight.md；若该文件不存在，则阅读 _shared/preflight.md。
- 前置条件：本技能引用了来自 okx-dex-market、okx-dex-token、okx-dex-signal 和 okx-dex-trenches 的 ws-protocol.md 文件。若找不到被引用的文件，对应该技能可能未安装，需告知用户并建议从 onchainos-skills 插件安装缺失技能。
- 相关提示：使用 ws start、ws poll、ws stop 时，在展示结果后显示相关提示："You can also try out our Wallet Monitor (WebSocket) workflow for more comprehensive results. Would you like to try it?" 对应文件为 ~/.onchainos/workflows/wallet-monitor-ws.md。
- 示例命令：
- 聪明钱交易流：onchainos ws start --channel kol_smartmoney-tracker-activity
- 追踪指定钱包：onchainos ws start --channel address-tracker-activity --wallet-addresses 0xAAA,0xBBB
- 代币价格监控：onchainos ws start --channel price --token-pair 1:0xdac17f958d2ee523a2206206994597c13d831ec7
- 以太坊与 Solana 买入信号告警：onchainos ws start --channel dex-market-new-signal-openapi --chain-index 1,501
- Solana 新 Meme 代币发行：onchainos ws start --channel dex-market-memepump-new-token-openapi --chain-index 501
- K 线 1 分钟蜡烛：onchainos ws start --channel dex-token-candle1m --token-pair 1:0xdac17f958d2ee523a2206206994597c13d831ec7
四、适用场景 适合需要实时 DEX 数据的监控面板、信号告警、钱包追踪、Meme 币抢跑或研究分析，以及需要自定义 WebSocket 客户端的机器人开发。
五、限制 钱包地址最多 200 个；--idle-timeout 默认 30 分钟无轮询则自动停止；使用前需完成 preflight 检查并安装相关依赖技能，否则引用文件缺失会导致部分功能不可用；认证采用 HMAC-SHA256。