🚀 概要
Hyperliquid Whale Tracker は、オンチェーンの透明性を活用したいトレーダーのために設計された MagicTradeBot v3.1 の新しいモジュールです。選択したクジラウォレットを継続的に監視し、それらのウォレットがポジションを開いたり閉じたりする際に反応します。以下の2つの主要モードで使用できます。
- シグナル専用モード — Telegram、Discord、WhatsApp、または Webhooks 経由でリアルタイムのクジラ取引アラートを受信します。
- ミラーモード — 接続された取引所アカウントで、インテリジェントなセーフガード付きのミラートレードを自動的に実行します。
設定はすべて tradesettings.yaml ファイルで管理され、ボットごとに有効化できます。安全性のため、デフォルトでは無効になっています。
⚙️ 設定例
トラッカーを有効にするには、tradesettings.yaml ファイルに以下のセクションを追加します:
HyperLiquidWhaleTracker:
is_enabled: true
tracking_addresses:
- "0x2aB3...Ff12"
- "0x1cD4...Aa77"
place_order: true
order_amount: 150.0
leverage: 3
broadcast_signals: true
max_open_per_whale: 2
slippage_tolerance_percent: 0.5
follow_partial_fills: true
close_on_whale_close: true
include_liquidations: false
only_follow_buy: false
only_follow_sell: false
min_whale_order_value: 100.0
cooldown_seconds: 60
この設定では、2つのクジラウォレットを追跡し、1トレードあたり$150で3倍レバレッジのミラートレードを行い、クジラがポジションを閉じた際に自動的にクローズします。
🧠 動作の仕組み
- イベントソース — ボットは、指定されたアドレスの Hyperliquid のオンチェーンウォレットイベントを購読します。
- イベント検出 — クジラがポジションを開閉した際、ボットはフィルター(サイズ、クールダウン、方向)に基づいて取引を検証します。
- 判断 —
place_order = trueの場合、接続された取引所 API を使用してミラートレードが作成されます。それ以外の場合はシグナルが送信されます。 - 実行 — 注文はスリッページ制限、レバレッジ、利用可能な証拠金を考慮して実行されます。部分約定は比例的にミラー可能です。
- ライフサイクル —
close_on_whale_closeが有効な場合、ボットはミラーポジションを監視し、自動的にクローズします。 - ログとアラート — すべてのイベントは記録され、必要に応じて通知・監視チャンネルに送信されます。
🔒 セキュリティとリスク管理
- APIキーや秘密鍵をハードコードしないでください — 環境変数または暗号化されたシークレットを使用してください。
- 権限を取引専用に制限し、出金を有効にしないでください。
- 本稼働前に
DemoModeでテストを行ってください。 - max_open_per_whale と slippage_tolerance_percent は慎重に設定してください。
- 本番環境では Sentry や PagerDuty などのエラーモニタリングを有効にしてください。
📣 通知とブロードキャスト
broadcast_signals: true の場合、MagicTradeBot は各クジラ取引イベントごとにフォーマット済みのアラートを送信します。
例 (Telegram / Discord):
[Hyperliquid Whale] 新規注文
Whale: 0x2aB3...Ff12
Action: 買い (ロング)
Symbol: BTCUSDT
Size: 0.5 BTC (~25,000 USDT)
Leverage: 3x
Mirrored: はい (Order ID: M-123456)
例 (Webhook JSON):
{
"type": "hyperliquid.whale.event",
"whale_address": "0x2aB3...Ff12",
"action": "open",
"side": "buy",
"symbol": "BTCUSDT",
"size": 0.5,
"notional": 25000,
"leverage": 3,
"mirrored": true,
"timestamp": "2025-10-16T12:34:56Z"
}
🧩 テストとデモモード
place_order: falseおよびDemoMode: trueを設定して安全にテストします。- ミラートレードを有効にする前にシグナルメッセージを確認してください。
- 小さな
order_amountから開始し、イベント検出が正確であることを確認します。 completedorders.yamlを監視してミラートレードのログを確認します。
⚡ 運用上のベストプラクティス
- cooldown_seconds を使用して、クジラが注文を分割することによる過剰取引を防止します。
- ボラティリティの高い市場では シグナル専用モード を維持します。
- マネーマネジメントモジュール と組み合わせて、動的なロットサイズとリスク軽減を行います。
- Prometheus と Loki を使用して、メトリクスとイベントの監査を実現します。
⚠️ 制限とリスク
- クジラ追跡 = 利益保証ではありません — クジラも損失や操作を行う可能性があります。
- 実行遅延やスリッページにより、ミラートレード結果に乖離が生じる場合があります。
- 多数のウォレットを追跡すると API 負荷が増加します — レート制限を適切に調整してください。
💬 よくある質問 (FAQ)
Q: 任意のウォレットを追跡できますか?
はい。任意の公開ウォレットアドレスを tracking_addresses に追加すれば、関連する取引活動を自動検出します。
Q: クジラのポジションサイズと同じにできますか?
いいえ。設定された order_amount または follow_partial_fills が有効な場合は比例サイズを使用します。
Q: クジラが複数の小口注文を送信した場合は?
cooldown_seconds と follow_partial_fills を使用して、重複取引や過剰エクスポージャーを防止します。
⚖️ 法的および倫理的注意事項
公開ウォレットの活動を追跡することはオンチェーンで透明ですが、取引所の利用規約および地域の規制を遵守してください。 MagicTradeBot はツールを提供しますが、法的および倫理的な使用責任はユーザーにあります。
🛠️ サポートとトラブルシューティング
completedorders.yamlおよびログを確認してエラーをチェックします。- API 権限と環境変数設定を確認してください。
- 公式の MagicTradeBot サポート にダッシュボード経由で技術サポートを依頼できます。