🚀 Überblick
Der Hyperliquid Whale Tracker ist ein neues Modul in MagicTradeBot v3.1, das für Trader entwickelt wurde, die von der On-Chain-Transparenz profitieren möchten. Es überwacht kontinuierlich ausgewählte Whale-Wallets und reagiert, wenn diese Positionen eröffnen oder schließen. Sie können es in zwei Hauptmodi verwenden:
- Nur-Signal-Modus — Empfangen Sie Echtzeit-Whale-Handelssignale über Telegram, Discord, WhatsApp oder Webhooks.
- Spiegelmodus — Führen Sie automatisch gespiegelte Trades auf Ihrem verbundenen Börsenkonto aus, mit intelligenten Schutzmechanismen.
Die Konfiguration wird vollständig über Ihre tradesettings.yaml-Datei verwaltet und kann pro Bot-Instanz aktiviert werden. Standardmäßig ist sie aus Sicherheitsgründen deaktiviert.
⚙️ Konfigurationsbeispiel
Um den Tracker zu aktivieren, fügen Sie den folgenden Abschnitt in Ihre tradesettings.yaml-Datei ein:
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
Diese Konfiguration verfolgt zwei Whale-Wallets, spiegelt deren Trades mit einem 3x-Hebel und 150 $ pro Trade und schließt gespiegelte Positionen automatisch, wenn die Whales ihre schließen.
🧠 Funktionsweise
- Ereignisquelle — Der Bot abonniert die On-Chain-Wallet-Ereignisse von Hyperliquid für die angegebenen Adressen.
- Ereigniserkennung — Wenn ein Whale eine Position öffnet oder schließt, validiert der Bot den Trade basierend auf Filtern (Größe, Cooldown, Richtung).
- Entscheidung — Wenn
place_order = true, wird ein gespiegelter Trade über Ihre verbundene Exchange-API erstellt; andernfalls wird nur ein Signal gesendet. - Ausführung — Aufträge werden unter Berücksichtigung der Slippage-Grenzen, des Hebels und der verfügbaren Margin platziert. Teilfüllungen können proportional gespiegelt werden.
- Lebenszyklus — Der Bot überwacht gespiegelte Positionen und schließt sie automatisch, wenn
close_on_whale_closeaktiviert ist. - Protokollierung & Warnungen — Alle Ereignisse werden protokolliert und optional an Ihre Benachrichtigungs- oder Überwachungskanäle gesendet.
🔒 Sicherheit & Risikokontrollen
- Speichern Sie niemals API-Schlüssel oder private Schlüssel im Klartext — verwenden Sie Umgebungsvariablen oder verschlüsselte Secrets.
- Beschränken Sie Berechtigungen auf nur Handel; aktivieren Sie niemals Abhebungen.
- Verwenden Sie
DemoModefür erste Tests, bevor Sie live gehen. - Setzen Sie max_open_per_whale und slippage_tolerance_percent konservativ.
- Aktivieren Sie Fehlermonitoring (z. B. Sentry, PagerDuty) für Produktionsumgebungen.
📣 Benachrichtigungen & Signale
Wenn broadcast_signals: true aktiviert ist, sendet MagicTradeBot formatierte Benachrichtigungen für jedes Whale-Handelsereignis.
Beispiel (Telegram / Discord):
[Hyperliquid Whale] NEUER AUFTRAG
Whale: 0x2aB3...Ff12
Aktion: KAUFEN (Long)
Symbol: BTCUSDT
Größe: 0.5 BTC (~25.000 USDT)
Hebel: 3x
Gespiegelt: ja (Order-ID: M-123456)
Beispiel (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"
}
🧩 Test- & Demomodus
- Setzen Sie
place_order: falseundDemoMode: truefür sicheres Testen. - Überprüfen Sie Signalnachrichten, bevor Sie den Spiegelhandel aktivieren.
- Beginnen Sie mit einem kleinen
order_amountund verifizieren Sie die korrekte Ereigniserkennung. - Überwachen Sie
completedorders.yamlfür Protokolle der gespiegelten Trades.
⚡ Betrieb – Best Practices
- Verwenden Sie cooldown_seconds, um Überhandel durch aufgeteilte Whale-Orders zu vermeiden.
- Behalten Sie den Nur-Signal-Modus in volatilen Märkten bei.
- Kombinieren Sie ihn mit Money-Management-Modulen für dynamische Positionsgrößen und Risikobegrenzung.
- Verwenden Sie Prometheus und Loki für Metriken und Ereignisüberwachung.
⚠️ Einschränkungen & Risiken
- Whale-Tracking ≠ garantierter Gewinn — auch Wale können verlieren oder manipulieren.
- Ausführungslatenz und Slippage können zu Abweichungen bei gespiegelten Trades führen.
- Das Verfolgen vieler Wallets erhöht die API-Last — passen Sie die Ratenlimits entsprechend an.
💬 FAQ
F: Kann ich jede Wallet verfolgen?
Ja. Fügen Sie einfach eine öffentliche Wallet-Adresse unter tracking_addresses hinzu — der Bot erkennt automatisch die zugehörige Handelsaktivität.
F: Entspricht die Positionsgröße der des Whales?
Nein. Es wird Ihre konfigurierte order_amount oder eine proportionale Größe verwendet, wenn follow_partial_fills aktiviert ist.
F: Was passiert, wenn ein Whale viele kleine Orders sendet?
Verwenden Sie cooldown_seconds und follow_partial_fills, um doppelte Trades und Überbelastung zu vermeiden.
⚖️ Rechtlicher & Ethischer Hinweis
Obwohl das Verfolgen öffentlicher Wallet-Aktivitäten on-chain transparent ist, stellen Sie sicher, dass Sie die Nutzungsbedingungen der Börse und lokale Vorschriften einhalten. MagicTradeBot stellt nur die Tools bereit — Sie sind für die rechtmäßige und ethische Nutzung verantwortlich.
🛠️ Support & Fehlerbehebung
- Überprüfen Sie
completedorders.yamlund Protokolle auf Fehler. - Verifizieren Sie API-Berechtigungen und Umgebungsvariablen-Konfigurationen.
- Kontaktieren Sie den offiziellen MagicTradeBot-Support über Ihr Dashboard für technische Unterstützung.