Hyperliquid Whale Copy-Trading — Profi-Trades sofort spiegeln

Übersicht

Der Hyperliquid Whale Tracker überwacht Wallet-Adressen (sogenannte „Whales“) und reagiert, wenn diese Wallets Positionen eröffnen oder schließen. Er unterstützt zwei Hauptmodi:

Signalmodus — Übermittlung von Whale-Ereignissen an Ihre Benachrichtigungskanäle (Telegram, Discord, WhatsApp usw.).
Spiegelmodus — Automatisches Platzieren gespiegelter Orders und Schließen dieser, wenn der Whale seine Position schließt.

Die Funktion ist vollständig über tradesettings.yaml konfigurierbar und kann pro Bot-Instanz aktiviert werden. Standardmäßig ist sie deaktiviert.

Konfiguration

Fügen Sie den Abschnitt HyperLiquidWhaleTracker in Ihre tradesettings.yaml (oder appsettings.yaml, falls Sie zentralisierte Einstellungen verwenden) hinzu oder aktualisieren Sie ihn. Beispiel:

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # Fügen Sie eine oder mehrere Whale-Wallet-Adressen hinzu
    - "0x1cD4...Aa77"
  place_order: false             # true = automatische Platzierung gespiegelter Orders, false = nur Signale
  order_amount: 100.0            # Betrag in Basiswährung pro gespiegelter Trade
  leverage: 3                    # Hebel für gespiegelte Trades (falls zutreffend)
  broadcast_signals: true        # true = Benachrichtigungen senden, wenn Whale Trades eröffnet/schließt
  max_open_per_whale: 2          # Max. offene gespiegelte Trades pro verfolgtem Whale (Sicherheit)
  slippage_tolerance_percent: 0.5 # Max. akzeptabler Slippage beim Platzieren gespiegelter Orders
  follow_partial_fills: true     # Wenn true, spiegelt der Bot partielle Erfüllungen proportional
  close_on_whale_close: true     # Gespiegelte Order schließen, wenn Whale seine Position schließt
  include_liquidations: false    # Wenn true, werden Liquidationen gespiegelt (nicht empfohlen)
  only_follow_buy: false         # Wenn true, nur Käufe verfolgen
  only_follow_sell: false        # Wenn true, nur Verkäufe verfolgen
  min_whale_order_value: 50.0    # Min. Orderwert (Basiswährung) für Verfolgung/Spiegelung
  cooldown_seconds: 30           # Sekunden Wartezeit zwischen der Verarbeitung von Ereignissen desselben Whales

Beschreibung der Felder

is_enabled — Aktivieren/Deaktivieren des Whale-Trackers (Standard: false).
tracking_addresses — Liste der zu verfolgenden Wallet-Adressen. Keine Obergrenze; fügen Sie so viele hinzu, wie Sie möchten, aber achten Sie auf die Ressourcennutzung.
place_order — Wenn true, versucht der Bot, gespiegelte Orders automatisch zu platzieren. Wenn false, werden nur Signale gesendet.
order_amount — Größe der gespiegelten Order in Ihrer Basiswährung (z. B. USDT) pro Trade. Ziehen Sie für Produktionsumgebungen eine Money-Management-Größenbestimmung in Betracht.
leverage — Hebel für gespiegelte Futures-Positionen (nur wenn die Börse Hebel unterstützt).
broadcast_signals — Formatted Nachrichten an die konfigurierten Broadcast-Kanäle senden.
max_open_per_whale — Sicherheitsgrenze, um eine Überbelastung durch einen einzelnen Whale zu vermeiden.
slippage_tolerance_percent — Maximal akzeptabler Slippage beim Platzieren von Orders.
follow_partial_fills — Wenn die Order eines Whales teilweise erfüllt wird, spiegelt der Bot das gleiche erfüllte Verhältnis.
close_on_whale_close — Gespiegelte Orders schließen, wenn der Whale seine Position schließt.
include_liquidations — Liquidationen nur spiegeln, wenn Sie die extremen Risiken verstehen.
only_follow_buy / only_follow_sell — Filter, um nur Käufe oder nur Verkäufe zu verfolgen.
min_whale_order_value — Ignoriert kleine Whale-Orders unterhalb dieses Schwellenwerts.
cooldown_seconds — Verhindert Event-Spamming durch Abstand zwischen der Verarbeitung pro Whale.

So funktioniert’s (technischer Ablauf)

Ereignisquelle: Der Bot abonniert Hyperliquid-Wallet-Ereignisse (oder fragt die Blockchain/API ab) für die konfigurierten Adressen.
Ereigniserkennung: Bei Erkennung eines neuen Eröffnungs-/Schließungsereignisses validiert der Bot es gegen Filter (Mindestwert, Aktionstyp, Cooldown).
Entscheidung: Wenn place_order = true, erstellt der Bot eine gespiegelte Order-Anfrage mit Ihren konfigurierten Börsenanmeldedaten, einschließlich Hebel- und Größenregeln. Wenn false, wird nur eine Broadcast-Nachricht erstellt.
Ausführung: Versucht, die Order zu platzieren, unter Berücksichtigung von Slippage-Toleranz und verfügbarem Guthaben. Wenn follow_partial_fills = true, passt der Bot die gespiegelten Order-Mengen entsprechend an.
Lebenszyklus: Der Bot überwacht den Status der gespiegelten Order und schließt sie, wenn close_on_whale_close = true, wenn der Whale seine Position schließt.
Protokollierung & Alarme: Alle Ereignisse und Aktionen werden protokolliert (siehe Protokollierung & Überwachung). Benachrichtigungen werden gesendet, wenn konfiguriert.

Voraussetzungen & Berechtigungen

Funktionierende MagicTradeBot-Instanz mit gültiger Lizenz und konfigurierter tradesettings.yaml.
Börsen-API-Schlüssel mit Handelsberechtigungen (falls place_order aktiviert ist). Für Hyperliquid-Wallet-basierte Aktionen benötigen Sie möglicherweise auch einen privaten Schlüssel — speichern Sie private Schlüssel niemals im Klartext (verwenden Sie Umgebungsvariablen).
Stabile Internetverbindung und angemessene Rate-Limit-Einstellungen in appsettings.yaml, um API-Sperren zu vermeiden.

Sicherheitsüberlegungen

Speichern Sie niemals private Schlüssel oder API-Geheimnisse in Repository-Dateien. Verwenden Sie Umgebungsvariablen oder Betriebssystem-Secrets-Management.
Beschränken Sie API-Schlüssel-Berechtigungen auf das absolut Notwendige (idealerweise nur Handel, keine Auszahlungen).
Testen Sie gründlich im DemoMode, bevor Sie Live-Spiegel-Orders aktivieren.
Legen Sie konservative Standardwerte fest: max_open_per_whale, slippage_tolerance_percent und min_whale_order_value.
Aktivieren Sie Protokollierung und Incident-Benachrichtigungen (Sentry, PagerDuty), um über Ausführungsfehler oder unerwartetes Verhalten informiert zu werden.

Benachrichtigungs- & Broadcast-Beispiele

Wenn broadcast_signals auf true gesetzt ist, sendet der Bot eine formatierte Nachricht. Beispielvorlagen unten:

Telegram / Discord (Text)


[Hyperliquid Whale] NEUE ORDER
Whale: 0x2aB3...Ff12
Aktion: KAUF (Long)
Symbol: BTCUSDT
Größe: 0.5 BTC (~25000 USDT)
Hebel: 3x
Zeit: 2025-10-16T12:34:56Z
Gespiegelt: Ja (Order-ID: M-123456)   # oder "Gespiegelt: Nein" wenn place_order=false

WhatsApp / Webhook (JSON-Payload)

{
  "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"
}

Testen & Demo-Modus

Testen Sie immer zuerst mit DemoMode: true oder mit Börsen-Testnets.
Stellen Sie place_order: false ein, um die Ereigniserkennung und das Broadcast-Format zu überprüfen, ohne Trades auszuführen.
Verwenden Sie kleine order_amount während Live-Tests und überwachen Sie die Protokolle in completedorders.yaml und der Terminalausgabe.

Operative Best Practices

Verwenden Sie max_open_per_whale, um eine Überbelastung durch die Trade-Sequenzen eines Whales zu vermeiden.
Aktivieren Sie cooldown_seconds, um doppelte Verarbeitung zu reduzieren, wenn Whales Orders in viele Mikro-Orders aufteilen.
Bevorzugen Sie Signalmodus bei volatilen Marktbedingungen oder wenn Sie keine schnelle Ausführung/Slippage-Kontrolle gewährleisten können.
Stellen Sie bei Spiegelung mit Hebel sicher, dass Sie über Margin und Sicherheitsvorkehrungen (globale Zwangsschließungsschwellen) verfügen.
Protokollieren Sie jedes eingehende Ereignis und jede gespiegelte Aktion für Nachvollziehbarkeit und Backtesting.

Protokollierung & Überwachung

Empfohlene Protokollierung/Überwachung, die in appsettings.yaml oder Ihrer Bot-Konfiguration aktiviert werden sollte:

Terminalprotokolle für Echtzeit-Fehlerbehebung.
completedorders.yaml — Persistierte abgeschlossene gespiegelte Trades für Backtesting und Gewinn/Verlust.
Optionale Remote-Protokollierung: Sentry, Loki, LogDNA, DataDog für Alarme und historische Prüfprotokolle.
Prometheus-Metriken für die Anzahl offener Positionen, gespiegelter Orders und Fehlerraten.

Fehlerbehandlung & Wiederholungen

Bei Fehlern bei der Orderplatzierung versucht der Bot bis zu 3 Wiederholungen mit exponentiellem Backoff (konfigurierbar).
Wenn der Slippage slippage_tolerance_percent überschreitet, wird die Order abgebrochen und eine Warnung ausgegeben.
Wenn eine gespiegelte Order aufgrund unzureichenden Guthabens nicht platziert werden kann, sendet der Bot eine Warnung und überspringt die Spiegelung.

Einschränkungen & Risiken

Das Verfolgen von Wallets garantiert keinen Gewinn — Whales können Market Maker, Insider oder kurzfristige Manipulationen durchführen.
Das Spiegeln von Liquidationen oder hoch gehebelten Whale-Bewegungen kann Verluste verstärken.
Ausführungslatenz und Slippage können zu anderen Trade-Ergebnissen führen als beim Whale.
Beachten Sie die API-Rate-Limits der Börse — das Verfolgen vieler Whales erhöht die API-Aufrufe und die Ressourcennutzung.

FAQ

F: Kann ich jede Wallet-Adresse verfolgen?

A: Ja — fügen Sie jede öffentliche Wallet-Adresse zu tracking_addresses hinzu. Der Bot versucht, Eröffnungs-/Schließungsereignisse für diese Adresse zu erkennen.

F: Wird der Bot die Positionsgrößen exakt replizieren?

A: Nicht unbedingt. Der Bot verwendet order_amount als Größe für gespiegelte Trades (oder spiegelt partielle Erfüllungen proportional, wenn aktiviert). Sie können prozentbasierte Größenbestimmung in einer erweiterten Money-Management-Konfiguration implementieren.

F: Was passiert, wenn ein Whale eine Order in viele Mikro-Orders aufteilt?

A: Verwenden Sie cooldown_seconds und follow_partial_fills, um zu steuern, wie geteilte Orders gespiegelt werden und um eine Überbelastung zu vermeiden.

Checkliste für den Einstieg

Aktivieren Sie den Tracker: Setzen Sie is_enabled: true in tradesettings.yaml.
Fügen Sie Whale-Adressen zu tracking_addresses hinzu.
Stellen Sie zunächst place_order: false ein, um Ereignisse und Benachrichtigungen zu überprüfen.
Verifizieren Sie, dass Broadcasts an Telegram/Discord/WhatsApp geliefert werden.
Wechseln Sie zu place_order: true, wenn Sie sicher sind, halten Sie DemoMode: true bis zur vollständigen Live-Verifizierung.
Überwachen Sie Protokolle und richten Sie Alarme für Platzierungsfehler, Slippage und unzureichende Guthabenereignisse ein.

Vollständiges Beispiel-Snippet (in `tradesettings.yaml` kopieren)

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

Rechtlicher & ethischer Hinweis

Das Verfolgen und Spiegeln öffentlicher Wallet-Aktivitäten ist technisch machbar, aber Sie sollten die Einhaltung lokaler Gesetze, Börsenbedingungen und ethischer Handelspraktiken sicherstellen. MagicTradeBot stellt die Werkzeuge bereit — es liegt in Ihrer Verantwortung, diese legal und verantwortungsvoll zu nutzen.

Support & Fehlerbehebung

Bei Problemen:

Überprüfen Sie Terminalprotokolle und completedorders.yaml auf Fehler.
Verifizieren Sie API-Schlüssel und Berechtigungen (Handel erlaubt, Auszahlungen deaktiviert).
Stellen Sie sicher, dass Umgebungsvariablen Dateieinstellungen überschreiben, wenn sie für Geheimnisse verwendet werden.
Kontaktieren Sie den Support über Ihr MagicTradeBot-Dashboard oder konsultieren Sie die vollständige Konfigurationsdokumentation.