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                          # サポートされている全 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>]                      # セッションを停止

チャンネル クイックリファレンス

チャンネル	グループ	パターン	必須パラメータ
kol_smartmoney-tracker-activity	signal	グローバル	(なし)
address-tracker-activity	signal	ウォレット単位	--wallet-addresses
dex-market-new-signal-openapi	signal	チェーン単位	--chain-index
price	market	トークン単位	--token-pair
dex-token-candle{period}	market	トークン単位	--token-pair
price-info	token	トークン単位	--token-pair
trades	token	トークン単位	--token-pair
dex-market-memepump-new-token-openapi	trenches	チェーン単位	--chain-index
dex-market-memepump-update-metrics-openapi	trenches	チェーン単位	--chain-index

パラメータ形式

• --token-pair: chainIndex:tokenContractAddress (例: 1:0xdac17f958d2ee523a2206206994597c13d831ec7)
• --chain-index: カンマ区切りのチェーン ID (例: 1,501,56)
• --wallet-addresses: カンマ区切りのアドレス、最大 200 個
• --idle-timeout: この期間内にポーリングがない場合は自動停止 (デフォルト 30m; 1h, 2h, 300s, 0 で無効化)

例

# スマートマネー取引フィード
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

# Ethereum + Solana での買いシグナルアラート
onchainos ws start --channel dex-market-new-signal-openapi --chain-index 1,501

# Solana での新しいメメトークンローンチ
onchainos ws start --channel dex-market-memepump-new-token-openapi --chain-index 501

# K-line 1 分足ローソク足
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": [...]}