okx-dex-ws

Onchain OS DEX WebSocket — 統合スキル

リアルタイムの DEX データを利用する 2 つの方法：

1. CLI（onchainos ws）— バックグラウンドセッションを開始し、イベントを段階的にポーリングします。モニタリングやエージェント主導のワークフローに最適です。
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	Wallet Monitor (WebSocket)	~/.onchainos/workflows/wallet-monitor-ws.md

ヒントの形式："より包括的な結果を得るには、Wallet Monitor (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	signal	global	（なし）
address-tracker-activity	signal	per-wallet	--wallet-addresses
dex-market-new-signal-openapi	signal	per-chain	--chain-index
price	market	per-token	--token-pair
dex-token-candle{period}	market	per-token	--token-pair
price-info	token	per-token	--token-pair
trades	token	per-token	--token-pair
dex-market-memepump-new-token-openapi	trenches	per-chain	--chain-index
dex-market-memepump-update-metrics-openapi	trenches	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 を指定）

例

# 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 クライアントを構築する場合は、対応するプロトコルリファレンスファイルを読み込んでください。

マーケットデータ（価格とローソク足のストリーム）

読み込み先：../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

ミーム／トレンチ

読み込み先：../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": [...]}