📖 概要
Hyperliquid Whale Trackerは、Hyperliquid取引所でのクジラウォレットの活動を監視し、自動コピートレーディングを可能にする高度な機能です。追跡中のクジラが新しいポジションを開くと、システムは自動的にDiscord/Telegramにシグナルを配信したり、あなたのアカウントにミラートレードを配置したりできます。
🔍 リアルタイム検出
5分ごとにクジラのポジションを監視し、新しいポジションを即座に検出します。
📢 マルチプラットフォームアラート
Discord、Telegram、WhatsAppにリッチなフォーマットでシグナルを配信します。
🤖 自動コピートレーディング
カスタム設定とリスクパラメータでクジラのポジションを自動的にミラーリングします。
🎯 スマートクローズトラッキング
クジラがポジションを閉じると、あなたのポジションも自動的に閉じます。
⚙️ 設定
基本設定
設定ファイルのHyperLiquidWhaleTrackerの下にあります：
メッセージングプラットフォームの設定
トレード設定
🔧 仕組み
検出プロセス
1初期スキャン
初回実行時、システムは既存のすべてのクジラポジションを登録しますが、配信はしません（スパム防止）。
2継続的モニタリング
5分ごとにシステムは次のことを行います：
- 追跡中の各クジラの現在のポジションを取得
- 以前に見たポジションと比較
- これまで存在しなかった新しいポジションを検出
3ポジション識別
ポジションが新しいとみなされる場合：
- 最後のチェック時にそのコインがクジラのポートフォリオに含まれていなかった場合
- システムがこのポジションを以前に配信していない場合
4アクション実行
各新しいポジションに対して：
- 設定されたプラットフォームにシグナルを配信（有効な場合）
- コピートレード注文を配置（有効な場合）
- 自動クローズ追跡のためのモニタリングにポジションを追加
追跡されるクジラポジションデータ
| データポイント | 説明 |
|---|---|
| コイン | 取引ペア（例：BTC、ETH、SOL） |
| サイド | ロングまたはショートポジション |
| サイズ | 契約単位でのポジションサイズ |
| エントリー価格 | クジラのエントリー価格 |
| レバレッジ | ポジションレバレッジ |
| 未実現PnL | 現在の利益/損失 |
| 清算価格 | リスク閾値 |
📢 シグナル配信
配信の有効化
クジラがポジションを開いたときに通知を受け取るには、設定でbroadcast_signals: trueを設定します。
Discord通知
リッチエンベッドフォーマット
- カラーコーディング（ロングは緑、ショートは赤）
- すべてのポジション詳細を含む整理されたフィールド
- クジラのポートフォリオへのクリック可能なリンク
- 追跡用のタイムスタンプ
Telegram通知
マークダウンフォーマット
- クリーンで読みやすいテキストフォーマット
- データ用のモノスペースコードブロック
- 直接追跡リンク
- モバイルフレンドリーなレイアウト
プラットフォーム選択
システムは有効な認証情報を持つすべての設定済みプラットフォームに配信します。認証情報がないプラットフォームは自動的にスキップされます：
- Discord：
discord_webhook_urlが必要 - Telegram：
telegram_bot_tokenとtelegram_chat_idの両方が必要 - WhatsApp：
whatsapp_tokenとwhatsapp_phone_idが必要
🤖 自動コピートレーディング
自動トレーディングの有効化
クジラのポジションを自動的にミラーリングするには、place_order: trueを設定します。
コピートレーディングの仕組み
- ポジション検出： システムが新しいクジラポジションを検出
- シンボルマッチング： あなたの取引所で対応する取引ペアを見つける
- 注文検証： クジラの注文制限とボットの可用性をチェック
- 注文配置： 設定された設定で市場注文を配置
- モニタリング： クローズモニタリングシステムにポジションを追加
⚠️ 重要：あなたの設定、クジラの設定ではない
コピートレードはクジラの設定ではなく、あなたの設定を使用します：
- あなたのポジションサイズ（クジラのものではない）
- あなたのレバレッジ（クジラのものではない）
- あなたのTP/SLパーセンテージ
- あなたのリスク管理ルール
例： クジラが100 BTCロングを20xレバレッジで開く → あなたのコピートレード：$100 BTCロングを10xレバレッジで（あなたの設定）
取引所互換性
システムはあなたの取引所に合わせてシンボルを自動的に調整します：
| 取引所 | クジラシンボル | あなたのシンボル |
|---|---|---|
| Binance | BTC | BTCUSDT |
| OKX | BTC | BTC-USDT-SWAP |
| Bybit | BTC | BTCUSDT |
| Bitget | BTC | BTCUSDT |
| HyperLiquid | BTC | BTC（変更なし） |
注文配置ロジック
👁️ ポジションモニタリング＆自動クローズ
自動クローズトラッキング
クジラのトレードをコピーすると、システムはクジラのポジションを継続的に監視します。クジラがポジションを閉じると、あなたのコピートレードも自動的に閉じます。
仕組み
- ポジション登録： コピートレード配置後、ポジションがモニタリングに追加される
- 継続的チェック： 5分ごとにシステムがクジラの現在のポジションをチェック
- クローズ検出： クジラのポジションサイズが減少または消滅したことを識別
- 自動クローズ実行： 対応するあなたのポジションを即座に閉じる
クローズシナリオ
完全クローズ（100%）
クジラ： ポジション全体を閉じる
あなたのトレード： ポジションの100%を自動的に閉じる
結果： トレードが完了に移動、running_ordersがクリア
部分クローズ
クジラ： ポジションサイズを縮小（例：50%クローズ）
あなたのトレード： 一致するパーセンテージを閉じる
結果： 新しい数量でトレードが更新
状態管理
🛡️ 安全機能
注文制限
クジラごとの制限（max_orders_per_whale）
- デフォルト： クジラごとの同時注文2件
- 設定可能： 任意の数値を設定（1～10推奨）
- 目的： 単一のクジラへの過剰なエクスポージャーを防ぐ
例： クジラ #1が2つのアクティブポジションを持つ → 新しいポジション検出 → システムがチェック：2/2制限に達している → 注文スキップ：「クジラの注文制限に達しました」
デモモード
実際の資本をリスクにさらさずにシステムをテスト：
デモモードでの動作：
- ✅ クジラのポジションを検出
- ✅ シグナルを配信
- ✅ 注文詳細を記録
- ❌ 実際の注文は配置しない
- ❌ 取引所APIを呼び出さない
ボットの競合防止
コピートレードを配置する前に：
- 対象ボットに実行中の注文があるかチェック
- ボットがすでに取引中の場合は注文をスキップ
- 同一シンボルでの複数同時ポジションを防止
ポジション検証
すべての注文は以下について検証されます：
- 有効なシンボル： あなたの取引所に存在する必要がある
- 現在の価格： 取得可能でなければならない（> 0）
- 数量計算： 取引所の最小値を満たす必要がある
- レバレッジ制限： 取引所が許可する範囲内である必要がある
🔧 トラブルシューティング
一般的な問題
❌ 「クジラアドレスが設定されていません」
問題： tracking_addressesリストが空
解決策：