Benutzerhandbuch für den Hyperliquid Whale Tracker

📑 Inhaltsverzeichnis

📖 Übersicht

Der Hyperliquid Whale Tracker ist eine fortschrittliche Funktion, die die Aktivitäten von Wal-Wallets an der Hyperliquid-Börse überwacht und automatisches Kopieren von Trades ermöglicht. Wenn ein verfolgter Wal eine neue Position eröffnet, kann das System automatisch Signale an Discord/Telegram übertragen und/oder gespiegelte Trades auf Ihrem Konto platzieren.

🔍 Echtzeit-Erkennung

Überwacht die Positionen von Walen alle 5 Minuten und erkennt neue Positionen sofort.

📢 Mehrplattform-Benachrichtigungen

Überträgt Signale an Discord, Telegram und WhatsApp mit reichhaltiger Formatierung.

🤖 Automatisches Kopieren von Trades

Spiegelt automatisch Wal-Positionen mit Ihren benutzerdefinierten Einstellungen und Risikoparametern.

🎯 Intelligentes Schließen von Positionen

Schließt Ihre Position automatisch, wenn der Wal seine Position schließt.

⚙️ Konfiguration

Grundeinstellungen

Befindet sich in Ihrer Konfigurationsdatei unter HyperLiquidWhaleTracker:

HyperLiquidWhaleTracker: is_enabled: true # Wal-Tracking aktivieren/deaktivieren tracking_addresses: # Liste der Wal-Wallet-Adressen - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4" - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae" - "0x9458f423df6569f053358ee9906613cd69c1ec04" # Weitere Adressen hinzufügen... place_order: false # Automatisch gespiegelte Orders platzieren broadcast_signals: true # An Messaging-Plattformen übertragen max_orders_per_whale: 2 # Maximale gleichzeitige Orders pro Wal

Konfiguration der Messaging-Plattformen

broadcast: # Discord discord_webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK" # Telegram telegram_bot_token: "YOUR_BOT_TOKEN" telegram_chat_id: "YOUR_CHAT_ID" # WhatsApp (optional) whatsapp_token: "YOUR_TOKEN" whatsapp_phone_id: "YOUR_PHONE_ID"

Trade-Einstellungen

general: initial_trade_amount: 100 # USD-Betrag pro Trade leverage: 10 # Hebelmultiplikator demo_mode: false # Testen ohne echte Trades sltp_settings: take_profit_percent: 5.0 # Gewinnmitnahme % stop_loss_percent: 2.0 # Stop-Loss %

🔧 Funktionsweise

Erkennungsprozess

1Erste Überprüfung

Beim ersten Start registriert das System alle bestehenden Wal-Positionen ohne Übertragung (verhindert Spam).

2Kontinuierliche Überwachung

Alle 5 Minuten führt das System folgende Schritte aus:

  • Holt aktuelle Positionen für jeden verfolgten Wal
  • Vergleicht mit zuvor gesehenen Positionen
  • Erkennt NEUE Positionen, die zuvor nicht vorhanden waren

3Positionsidentifikation

Eine Position gilt als NEU, wenn:

  • Die Münze beim letzten Check nicht im Portfolio des Wals war
  • Das System diese Position noch nicht übertragen hat

4Aktionsausführung

Für jede neue Position:

  • Überträgt Signal an konfigurierte Plattformen (falls aktiviert)
  • Platziert Kopier-Trade-Order (falls aktiviert)
  • Fügt Position zur Überwachung für automatisches Schließen hinzu

Verfolgte Wal-Positionsdaten

Datenpunkt Beschreibung
Münze Handelspaar (z. B. BTC, ETH, SOL)
Seite Long- oder Short-Position
Größe Positionsgröße in Kontrakten
Einstiegspreis Einstiegspreis des Wals
Hebel Positionshebel
Unrealisierter PnL Aktueller Gewinn/Verlust
Liquidationspreis Risikoschwelle

📢 Signalübertragung

Übertragungen aktivieren

Stellen Sie broadcast_signals: true in Ihrer Konfiguration ein, um Benachrichtigungen zu erhalten, wenn Wale Positionen eröffnen.

Discord-Benachrichtigungen

Rich-Embed-Format

  • Farbkodiert (Grün für LONG, Rot für SHORT)
  • Organisierte Felder mit allen Positionsdetails
  • Klickbarer Link zum Portfolio des Wals
  • Zeitstempel für die Nachverfolgung
🐋 Wal-Alarm: Wal #1 Wal #1 hat eine LONG-Position auf BTC eröffnet 📊 Positionsdetails Münze: BTC Seite: LONG 📈 Größe: 50.5 Hebel: 20x 💰 Preisinformationen Einstiegspreis: $65.432,10 Unrealisierter PnL: $-125,50 ⏰ Zeitangaben Position eröffnet: 2025-01-15 14:30:00 UTC Erkannt: 14:35:00

Telegram-Benachrichtigungen

Markdown-Format

  • Klares, lesbares Textformat
  • Monospace-Codeblöcke für Daten
  • Direkter Tracking-Link
  • Mobilfreundliches Layout
🐋 *WAL-ALARM* 🟢 *Wal #1* hat *LONG*-Position eröffnet *Positionsdetails:* Münze : BTC Seite : LONG Größe : 50.5 Einstiegspreis : $65.432,10 Hebel : 20x Unreal. PnL : $-125,50 Liquidation : $60.123,45 text*Zeitangaben:* Eröffnet : 2025-01-15 14:30:00 UTC Erkannt : 2025-01-15 14:35:00 text🔗 [Auf CoinGlass verfolgen] _Wal: 0x2ea18c23..._

Plattformauswahl

Das System überträgt an alle konfigurierten Plattformen mit gültigen Zugangsdaten. Plattformen ohne Zugangsdaten werden automatisch übersprungen:

  • Discord: Erfordert discord_webhook_url
  • Telegram: Erfordert sowohl telegram_bot_token als auch telegram_chat_id
  • WhatsApp: Erfordert whatsapp_token und whatsapp_phone_id

🤖 Automatisches Kopieren von Trades

Automatisches Trading aktivieren

Stellen Sie place_order: true ein, um Wal-Positionen automatisch zu spiegeln.

Funktionsweise des Kopier-Tradings

  1. Positionsdetektion: System erkennt neue Wal-Position
  2. Symbolabgleich: Findet entsprechendes Handelspaar an Ihrer Börse
  3. Order-Validierung: Überprüft Wal-Order-Limits und Bot-Verfügbarkeit
  4. Order-Platzierung: Platziert Marktauftrag mit Ihren konfigurierten Einstellungen
  5. Überwachung: Fügt Position zum Schließungsüberwachungssystem hinzu

⚠️ Wichtig: Ihre Einstellungen, nicht die des Wals

Ihre Kopier-Trades verwenden IHRE Einstellungen, nicht die des Wals:

  • Ihre Positionsgröße (nicht die des Wals)
  • Ihr Hebel (nicht der des Wals)
  • Ihre TP/SL-Prozentsätze
  • Ihre Risikomanagement-Regeln

Beispiel: Wal eröffnet 100 BTC LONG mit 20x Hebel → Ihr Kopier-Trade: $100 BTC LONG mit 10x Hebel (Ihre Einstellungen)

Börsenkompatibilität

Das System passt Symbole automatisch für Ihre Börse an:

Börse Wal-Symbol Ihr Symbol
Binance BTC BTCUSDT
OKX BTC BTC-USDT-SWAP
Bybit BTC BTCUSDT
Bitget BTC BTCUSDT
HyperLiquid BTC BTC (keine Änderung)

Logik der Order-Platzierung

WENN neue Wal-Position erkannt wird: → Überprüfen, ob broadcast_signals aktiviert ist → Benachrichtigungen senden → Überprüfen, ob place_order aktiviert ist: → Verifizieren, dass Wal-Order-Limit nicht überschritten ist → Passendes aktives Handelspaar finden → Überprüfen, dass Bot keine laufenden Orders hat (Konflikte vermeiden) → Ordergröße aus IHREN Einstellungen berechnen → Marktauftrag mit IHREM TP/SL platzieren → In opentrades.yaml speichern → Zur Überwachung für automatisches Schließen hinzufügen

👁️ Positionsüberwachung & Automatisches Schließen

Automatisches Schließungs-Tracking

Wenn Sie einen Wal-Trade kopieren, überwacht das System die Position des Wals kontinuierlich. Wenn der Wal seine Position schließt, wird Ihr Kopier-Trade automatisch geschlossen.

Funktionsweise

  1. Positionsregistrierung: Nach Platzierung des Kopier-Trades wird die Position zur Überwachung hinzugefügt
  2. Kontinuierliche Überprüfung: Alle 5 Minuten überprüft das System die aktuellen Positionen des Wals
  3. Schließungsdetektion: Erkennt, wenn die Positionsgröße des Wals abnimmt oder verschwindet
  4. Automatische Schließung: Schließt sofort Ihre entsprechende Position

Schließungsszenarien

Vollständige Schließung (100%)

Wal: Schließt die gesamte Position

Ihr Trade: Schließt automatisch 100% der Position

Ergebnis: Trade wird als abgeschlossen markiert, running_orders geleert

Teilweise Schließung

Wal: Reduziert die Positionsgröße (z. B. 50% Schließung)

Ihr Trade: Schließt den entsprechenden Prozentsatz

Ergebnis: Trade wird mit neuen Mengen aktualisiert

Zustandsverwaltung

# Vor Schließung running_orders: - order_id: "12345" symbol: "BTCUSDT" status: "Active" whale_address: "0x2ea..." # Nach Schließung running_orders: null # Geleert, bereit für nächsten Trade completed_trades: - order_id: "12345" status: "Closed" realized_pnl: 45.30 close_reason: "Wal #1 hat BTC-Position geschlossen"

🛡️ Sicherheitsfunktionen

Order-Limits

Limit pro Wal (max_orders_per_whale)

  • Standard: 2 gleichzeitige Orders pro Wal
  • Konfigurierbar: Beliebige Zahl einstellen (1-10 empfohlen)
  • Ziel: Verhindert Überbelastung durch einen einzelnen Wal

Beispiel: Wal #1 hat 2 aktive Positionen → Neue Position erkannt → System prüft: 2/2 Limit erreicht → Order übersprungen: "Wal-Order-Limit erreicht"

Demo-Modus

Testen Sie das System ohne Risiko für echtes Kapital:

general: demo_mode: true # Simuliert Orders ohne Ausführung

Im Demo-Modus:

  • ✅ Erkennt Wal-Positionen
  • ✅ Überträgt Signale
  • ✅ Protokolliert Order-Details
  • ❌ Keine echten Orders platziert
  • ❌ Keine API-Aufrufe an die Börse

Verhinderung von Bot-Konflikten

Vor Platzierung eines Kopier-Trades:

  • Prüft, ob der Ziel-Bot laufende Orders hat
  • Überspringt Order, wenn der Bot bereits handelt
  • Verhindert mehrere gleichzeitige Positionen auf demselben Symbol

Positionsvalidierung

Jeder Order wird validiert für:

  • Gültiges Symbol: Muss an Ihrer Börse existieren
  • Aktueller Preis: Muss abrufbar sein (> 0)
  • Mengenberechnung: Muss die Mindestanforderungen der Börse erfüllen
  • Hebelgrenzen: Innerhalb des von der Börse erlaubten Bereichs

🔧 Fehlerbehebung

Häufige Probleme

❌ "Keine Wal-Adressen konfiguriert"

Problem: Die Liste tracking_addresses ist leer

Lösung:

HyperLiquidWhaleTracker: tracking_addresses: - "0xYOUR_WHALE_ADDRESS_HERE"

📎 Related Topics