Hyperliquid Whale コピー取引 — プロの取引を瞬時にミラー

概要

Hyperliquid Whale Trackerは、ウォレットアドレス（クジラ）を監視し、それらのウォレットがポジションを開いたり閉じたりしたときに反応します。主に2つのモードをサポートします：

シグナルのみモード — クジライベントを通知チャネル（Telegram、Discord、WhatsAppなど）にブロードキャストします。
ミラーモード — 自動的にミラーリングされた注文を実行し、クジラがポジションを閉じるときにそれらを閉じます。

この機能はtradesettings.yamlから完全に設定可能で、ボットインスタンスごとに有効化できます。デフォルトでは無効化されています。

設定

tradesettings.yaml（または設定を一元化している場合はappsettings.yamlのバリエーション）内のHyperLiquidWhaleTrackerセクションを追加または更新します。例：

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # 1つ以上のクジラのウォレットアドレスを追加
    - "0x1cD4...Aa77"
  place_order: false             # true = ミラーリングされた注文を自動実行、false = シグナルのみ
  order_amount: 100.0            # ミラーリングされた取引ごとの基準通貨の金額
  leverage: 3                    # ミラーリングされた取引に使用するレバレッジ（該当する場合）
  broadcast_signals: true        # true = クジラが取引を開く/閉じる際に通知を送信
  max_open_per_whale: 2          # 追跡されたクジラごとの最大オープン取引数（安全）
  slippage_tolerance_percent: 0.5 # ミラーリングされた注文実行時の最大許容スリッページ
  follow_partial_fills: true     # trueの場合、ボットは部分的な約定を比例してミラーリング
  close_on_whale_close: true     # クジラがポジションを閉じるときにミラーリングされた注文を閉じる
  include_liquidations: false    # trueの場合、清算をミラーリング（推奨されません）
  only_follow_buy: false         # trueの場合、買いのみ追跡
  only_follow_sell: false        # trueの場合、売りのみ追跡
  min_whale_order_value: 50.0    # 追跡/ミラーリングのための最小注文価値（基準通貨）
  cooldown_seconds: 30           # 同一クジラのイベント処理間の待機時間（秒）

フィールドの説明

is_enabled — クジラトラッカーの有効/無効（デフォルト：false）。
tracking_addresses — 追跡するウォレットアドレスのリスト。制限なし。好きなだけ追加可能ですが、リソース使用に注意してください。
place_order — trueの場合、ボットはミラーリングされた注文を自動的に実行しようとします。falseの場合、シグナルのみをブロードキャストします。
order_amount — 取引ごとの基準通貨（例：USDT）でのミラーリングされた注文のサイズ。本番環境では資金管理サイズ設定を検討してください。
leverage — ミラーリングされた先物ポジションを開くためのレバレッジ（取引所がレバレッジをサポートする場合のみ）。
broadcast_signals — 設定されたブロードキャストチャネルにフォーマットされたメッセージを送信。
max_open_per_whale — 単一のクジラへの過剰なエクスポージャーを避けるための安全制限。
slippage_tolerance_percent — 注文実行時の最大許容スリッページ。
follow_partial_fills — クジラの注文が部分的に約定した場合、ボットは同じ約定比率をミラーリングします。
close_on_whale_close — クジラがポジションを閉じるときにミラーリングされた注文を閉じる。
include_liquidations — 極端なリスクを理解している場合にのみ清算をミラーリング。
only_follow_buy / only_follow_sell — 買いのみまたは売りのみを追跡するためのフィルター。
min_whale_order_value — この閾値以下の小さなクジラ注文を無視。
cooldown_seconds — クジラごとのイベント処理間隔を設けてイベントスパムを防止。

動作の仕組み（技術的フロー）

イベントソース：ボットは設定されたアドレスに対してHyperliquidウォレットイベントを購読（またはブロックチェーン/APIをポーリング）します。
イベント検出：新しい注文の開閉イベントが検出されると、ボットはフィルター（最小価値、アクションタイプ、クールダウン）に対してそれを検証します。
決定：place_order = trueの場合、ボットは設定された取引所認証情報を使用して、レバレッジとサイズルールを含むミラーリング注文リクエストを作成します。falseの場合、ブロードキャストメッセージのみを作成します。
実行：スリッページ許容範囲と利用可能な残高を考慮して注文を実行しようとします。follow_partial_fills = trueの場合、ボットはミラーリングされた注文数量を適切に調整します。
ライフサイクル：ボットはミラーリングされた注文の状態を監視し、close_on_whale_close = trueの場合、クジラがポジションを閉じるとミラーリングされた注文を閉じます。
ロギングとアラート：すべてのイベントとアクションが記録されます（ロギングとモニタリングを参照）。設定されている場合、通知がブロードキャストされます。

前提条件と権限

有効なライセンスと設定されたtradesettings.yamlを持つ動作中のMagicTradeBotインスタンス。
place_orderが有効な場合、取引権限を持つ取引所APIキー。Hyperliquidウォレットベースのアクションにはプライベートキーも必要になる場合があります — プライベートキーをプレーンテキストで保存しないでください（環境変数を使用）。
API制限を避けるための安定したインターネット接続とappsettings.yamlでの適切なレート制限設定。

セキュリティの考慮事項

プライベートキーやAPIシークレットをリポジトリファイルにハードコーディングしないでください。環境変数またはOSレベルのシークレット管理を使用してください。
APIキーの権限を必要最低限に制限（理想的には取引のみ、引き出しは不可）。
ライブミラーリング注文を有効にする前に、DemoModeで徹底的にテストしてください。
保守的なデフォルト設定：max_open_per_whale、slippage_tolerance_percent、min_whale_order_value。
実行エラーや予期しない動作を通知するために、ロギングとインシデントアラート（Sentry、PagerDuty）を有効にしてください。

通知とブロードキャストの例

broadcast_signalsがtrueの場合、ボットはフォーマットされたメッセージを送信します。以下の例テンプレートを参照してください：

Telegram / Discord（テキスト）


[Hyperliquid Whale] 新規注文
クジラ: 0x2aB3...Ff12
アクション: 買い（ロング）
シンボル: BTCUSDT
サイズ: 0.5 BTC（約25000 USDT）
レバレッジ: 3倍
時間: 2025-10-16T12:34:56Z
ミラーリング: はい（注文ID: M-123456）   # または place_order=false の場合「ミラーリング: いいえ」

WhatsApp / 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,
  "mirrored_order_id": "M-123456",
  "timestamp": "2025-10-16T12:34:56Z"
}

テストとデモモード

常にDemoMode: trueまたは取引所のテストネットを使用して最初にテストしてください。
place_order: falseを設定して、取引を実行せずにイベント検出とブロードキャスト形式を確認してください。
ライブテスト中は小さなorder_amountを使用し、completedorders.yamlおよびターミナル出力でログを監視してください。

運用のベストプラクティス

max_open_per_whaleを使用して、1つのクジラの取引シーケンスへの過剰なエクスポージャーを回避してください。
クジラが注文を複数のマイクロ注文に分割する場合、cooldown_secondsを有効にして重複処理を減らしてください。
市場が不安定な状況や、迅速な実行/スリッページ制御が確保できない場合は、シグナルのみを優先してください。
レバレッジでミラーリングする場合、マージンとフェイルセーフ（グローバル強制クローズ閾値）を確保してください。
監査可能性とバックテストのために、すべての受信イベントとミラーリングされたアクションをログに記録してください。

ロギングとモニタリング

appsettings.yamlまたはボット設定で有効にすることを推奨するロギング/モニタリング：

リアルタイムトラブルシューティングのためのターミナルログ。
completedorders.yaml — バックテストと損益計算のための完了したミラーリング取引の永続化。
オプションのリモートロギング：Sentry、Loki、LogDNA、DataDogを使用したアラートと履歴監査ログ。
オープンポジション数、ミラーリングされた注文数、エラー率のためのPrometheusメトリクス。

エラー処理とリトライ

注文実行失敗時、ボットは最大3回まで指数バックオフ（設定可能）でリトライします。
スリッページがslippage_tolerance_percentを超えた場合、注文はキャンセルされ、警告が発行されます。
残高不足でミラーリングされた注文を実行できない場合、ボットは警告をブロードキャストし、ミラーリングをスキップします。

制限とリスク

ウォレット追跡は利益を保証するものではありません — クジラはマーケットメーカー、内部者、または短期的な操作を行う可能性があります。
清算や高レバレッジのクジラの動きをミラーリングすると、損失が拡大する可能性があります。
実行の遅延とスリッページは、クジラと異なる取引結果を引き起こす可能性があります。
取引所のAPIレート制限を尊重してください — 多くのクジラを追跡するとAPI呼び出しとリソース使用が増加します。

FAQ

Q: 任意のウォレットアドレスを追跡できますか？

A: はい — tracking_addressesに公開ウォレットアドレスを追加してください。ボットはそのアドレスに関連する開閉イベントの検出を試みます。

Q: ボットはポジションサイズを正確に複製しますか？

A: 必ずしもそうではありません。ボットはorder_amountをミラーリングされた取引サイズとして使用するか（有効な場合、部分約定を比例してミラーリングします）。高度な資金管理設定でパーセントベースのサイズ設定を実装できます。

Q: クジラが注文を複数のマイクロ注文に分割した場合どうなりますか？

A: cooldown_secondsとfollow_partial_fillsを使用して、分割注文のミラーリング方法を制御し、過剰なエクスポージャーを回避してください。

開始チェックリスト

トラッカーを有効化：tradesettings.yamlでis_enabled: trueを設定。
tracking_addressesにクジラアドレスを追加。
最初にplace_order: falseを設定して、イベントと通知を確認。
Telegram/Discord/WhatsAppへのブロードキャスト配信を確認。
準備ができたらplace_order: trueに切り替え、ライブ検証が完了するまでDemoMode: trueを維持。
注文エラー、スリッページ、残高不足イベントのログを監視し、アラートを設定。

完全な例スニペット（`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

法的および倫理的注意

公開ウォレット活動の追跡とミラーリングは技術的に可能ですが、現地の法律、取引所の規約、倫理的取引慣行の遵守を確保する必要があります。MagicTradeBotはツールを提供します — それらを合法的かつ責任を持って使用する責任はあなたにあります。

サポートとトラブルシューティング

問題が発生した場合：

ターミナルログとcompletedorders.yamlでエラーを確認してください。
APIキーと権限を確認（取引許可、引き出し無効）。
シークレットに使用されている場合、環境変数がファイル設定を上書きしていることを確認してください。
MagicTradeBotダッシュボードを介してサポートに連絡するか、完全な設定ドキュメントを参照してください。