mcpField
O
okx-dex-ws

okx-dex-ws

github.com/okx开发3455.8k 次安装1 天前更新
代码仓库

关于 okx-dex-ws

这是一项通过 Onchain OS CLI 或自定义 WebSocket 客户端获取实时 DEX 数据的技能，适用于构建监控工作流、机器人或自定义数据逻辑，涵盖市场价格、代币活动、钱包信号和迷因代币更新。

主要功能

  1. 01启动并管理 WebSocket 会话
  2. 02增量轮询事件
  3. 03查询频道和参数
  4. 04订阅市场与代币数据
  5. 05跟踪钱包及交易信号

适用场景

  1. 01监控代币价格和 K 线
  2. 02跟踪指定钱包的活动
  3. 03使用实时 DEX 数据构建机器人
  4. 04跟踪新迷因代币信号

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/okx/onchainos-skills --skill okx-dex-ws

安装后在 Claude Code 中输入/okx-dex-ws确认已加载。

详细介绍

Onchain OS DEX WebSocket — 统一技能

获取实时 DEX 数据的两种方式：

  1. CLI（onchainos ws）——启动后台会话，增量轮询事件。最适合监控和由 Agent 驱动的工作流。
  2. 脚本——使用 Python/Node/Rust 编写自定义 WebSocket 客户端。最适合机器人和自定义逻辑。

预检

阅读 ../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钱包监控（WebSocket）~/.onchainos/workflows/wallet-monitor-ws.md

提示格式：*"你也可以试试我们的**钱包监控（WebSocket）*工作流，获取更全面的结果。想试试吗？"

方式 1：CLI（onchainos ws）

发现频道
onchainos ws channels                          # list all 9 supported channels
onchainos ws channel-info --channel <name>     # detailed info + example for a channel
启动 / 轮询 / 停止
onchainos ws start --channel <channel> [params]   # start background session
onchainos ws poll --id <ID> [--channel <ch>]       # pull new events
onchainos ws list                                  # list sessions
onchainos ws stop [--id <ID>]                      # stop session(s)
频道速查表
频道分组模式必需参数
kol_smartmoney-tracker-activity信号全局（无）
address-tracker-activity信号按钱包--wallet-addresses
dex-market-new-signal-openapi信号按链--chain-index
price市场按代币--token-pair
dex-token-candle{period}市场按代币--token-pair
price-info代币按代币--token-pair
trades代币按代币--token-pair
dex-market-memepump-new-token-openapitrenches按链--chain-index
dex-market-memepump-update-metrics-openapitrenches按链--chain-index
参数格式
  • --token-pair：chainIndex:tokenContractAddress（例如 1:0xdac17f958d2ee523a2206206994597c13d831ec7）
  • --chain-index：以逗号分隔的链 ID（例如 1,501,56）
  • --wallet-addresses：以逗号分隔的地址，最多 200 个
  • --idle-timeout：若在此时长内未轮询，则自动停止（默认 30m；1h、2h、300s，设为 0 可禁用）
示例
# Smart money trade feed
onchainos ws start --channel kol_smartmoney-tracker-activity

# Track specific wallets
onchainos ws start --channel address-tracker-activity --wallet-addresses 0xAAA,0xBBB

# Token price monitoring
onchainos ws start --channel price --token-pair 1:0xdac17f958d2ee523a2206206994597c13d831ec7

# Buy signal alerts on Ethereum + Solana
onchainos ws start --channel dex-market-new-signal-openapi --chain-index 1,501

# New meme token launches on Solana
onchainos ws start --channel dex-market-memepump-new-token-openapi --chain-index 501

# K-line 1-minute candles
onchainos ws start --channel dex-token-candle1m --token-pair 1:0xdac17f958d2ee523a2206206994597c13d831ec7
轮询筛选条件（仅限追踪器频道）

轮询 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（毫秒时间戳）

方式 2：自定义脚本

如果用户想使用自己的逻辑构建自定义 WebSocket 客户端，请阅读相应的协议参考文件：

市场数据（价格和 K 线流）

阅读：../okx-dex-market/references/ws-protocol.md

频道：price、dex-token-candle{period}

代币数据（详细代币流）

阅读：../okx-dex-token/references/ws-protocol.md

频道：price-info、trades

信号和钱包追踪

阅读：../okx-dex-signal/references/ws-protocol.md

频道：dex-market-new-signal-openapi、kol_smartmoney-tracker-activity、address-tracker-activity

Meme/Trenches

阅读：../okx-dex-trenches/references/ws-protocol.md

频道：dex-market-memepump-new-token-openapi、dex-market-memepump-update-metrics-openapi

通用协议（所有频道共用）

  • 端点：wss://wsdex.okx.com/ws/v6/dex
  • 身份验证：订阅前必须使用 HMAC-SHA256 登录
  • 心跳：每 25 秒发送一次 "ping"，并等待 "pong"
  • 订阅：{"op": "subscribe", "args": [...]}
  • 取消订阅：{"op": "unsubscribe", "args": [...]}

评论

支持 Markdown