Guide de l’utilisateur du Hyperliquid Whale Tracker

📑 Table des matières

📖 Aperçu

Le Hyperliquid Whale Tracker est une fonctionnalité avancée qui surveille les activités des portefeuilles de baleines sur l'échange Hyperliquid et permet le trading par copie automatique. Lorsqu'une baleine suivie ouvre une nouvelle position, le système peut automatiquement diffuser des signaux sur Discord/Telegram et/ou placer des trades en miroir sur votre compte.

🔍 Détection en temps réel

Surveille les positions des baleines toutes les 5 minutes et détecte les nouvelles positions instantanément.

📢 Alertes multi-plateformes

Diffuse les signaux sur Discord, Telegram et WhatsApp avec un formatage riche.

🤖 Copie automatique des trades

Miroite automatiquement les positions des baleines avec vos paramètres personnalisés et vos paramètres de risque.

🎯 Suivi intelligent de la clôture

Ferme automatiquement votre position lorsque la baleine ferme la sienne.

⚙️ Configuration

Paramètres de base

Situés dans votre fichier de configuration sous HyperLiquidWhaleTracker :

HyperLiquidWhaleTracker: is_enabled: true # Activer/désactiver le suivi des baleines tracking_addresses: # Liste des adresses de portefeuilles de baleines - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4" - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae" - "0x9458f423df6569f053358ee9906613cd69c1ec04" # Ajouter plus d'adresses... place_order: false # Placer automatiquement des ordres en miroir broadcast_signals: true # Diffuser vers les plateformes de messagerie max_orders_per_whale: 2 # Nombre maximum d'ordres simultanés par baleine

Configuration des plateformes de messagerie

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 (optionnel) whatsapp_token: "YOUR_TOKEN" whatsapp_phone_id: "YOUR_PHONE_ID"

Paramètres de trading

general: initial_trade_amount: 100 # Montant en USD par trade leverage: 10 # Multiplicateur de levier demo_mode: false # Tester sans trades réels sltp_settings: take_profit_percent: 5.0 # Pourcentage de prise de profit stop_loss_percent: 2.0 # Pourcentage de stop loss

🔧 Fonctionnement

Processus de détection

1Analyse initiale

Lors de la première exécution, le système enregistre toutes les positions existantes des baleines sans diffuser (évite le spam).

2Surveillance continue

Toutes les 5 minutes, le système :

  • Récupère les positions actuelles pour chaque baleine suivie
  • Compare avec les positions vues précédemment
  • Détecte les NOUVELLES positions qui n'étaient pas là avant

3Identification des positions

Une position est considérée comme NOUVELLE lorsque :

  • La monnaie n'était pas dans le portefeuille de la baleine lors du dernier contrôle
  • Le système n'a pas diffusé cette position auparavant

4Exécution des actions

Pour chaque nouvelle position :

  • Diffuse le signal vers les plateformes configurées (si activé)
  • Place un ordre de copie (si activé)
  • Ajoute la position à la surveillance pour le suivi de la clôture automatique

Données des positions des baleines suivies

Point de données Description
Monnaie Paire de trading (ex. : BTC, ETH, SOL)
Côté Position longue ou courte
Taille Taille de la position en contrats
Prix d'entrée Prix d'entrée de la baleine
Leverage Leverage de la position
PnL non réalisé Profit/perte actuel
Prix de liquidation Seuil de risque

📢 Diffusion des signaux

Activer les diffusions

Définissez broadcast_signals: true dans votre configuration pour recevoir des notifications lorsque les baleines ouvrent des positions.

Notifications Discord

Format d'incorporation riche

  • Codé par couleur (Vert pour LONG, Rouge pour SHORT)
  • Champs organisés avec tous les détails de la position
  • Lien cliquable vers le portefeuille de la baleine
  • Horodatage pour le suivi
🐋 Alerte baleine : Baleine #1 Baleine #1 a ouvert une position LONG sur BTC 📊 Détails de la position Monnaie : BTC Côté : LONG 📈 Taille : 50.5 Leverage : 20x 💰 Informations sur le prix Prix d'entrée : 65 432,10 $ PnL non réalisé : -125,50 $ ⏰ Timing Position ouverte : 2025-01-15 14:30:00 UTC Détectée : 14:35:00

Notifications Telegram

Format Markdown

  • Format texte propre et lisible
  • Blocs de code en monospace pour les données
  • Lien de suivi direct
  • Mise en page adaptée aux mobiles
🐋 *ALERTE BALEINE* 🟢 *Baleine #1* a ouvert une position *LONG* *Détails de la position :* Monnaie : BTC Côté : LONG Taille : 50.5 Prix d'entrée : 65 432,10 $ Leverage : 20x PnL non réal. : -125,50 $ Liquidation : 60 123,45 $ text*Timing :* Ouverte : 2025-01-15 14:30:00 UTC Détectée : 2025-01-15 14:35:00 text🔗 [Suivre sur CoinGlass] _Baleine : 0x2ea18c23..._

Sélection de la plateforme

Le système diffuse vers toutes les plateformes configurées avec des identifiants valides. Les plateformes sans identifiants sont automatiquement ignorées :

  • Discord : Nécessite discord_webhook_url
  • Telegram : Nécessite à la fois telegram_bot_token et telegram_chat_id
  • WhatsApp : Nécessite whatsapp_token et whatsapp_phone_id

🤖 Copie automatique des trades

Activer le trading automatique

Définissez place_order: true pour miroiter automatiquement les positions des baleines.

Fonctionnement du trading par copie

  1. Détection de position : Le système détecte une nouvelle position de baleine
  2. Correspondance des symboles : Trouve la paire de trading correspondante sur votre échange
  3. Validation de l'ordre : Vérifie les limites d'ordre des baleines et la disponibilité du bot
  4. Placement de l'ordre : Place un ordre au marché avec vos paramètres configurés
  5. Surveillance : Ajoute la position au système de surveillance de clôture

⚠️ Important : Vos paramètres, pas ceux de la baleine

Vos trades en copie utilisent VOS paramètres, pas ceux de la baleine :

  • Votre taille de position (pas celle de la baleine)
  • Votre levier (pas celui de la baleine)
  • Vos pourcentages TP/SL
  • Vos règles de gestion des risques

Exemple : La baleine ouvre 100 BTC LONG à 20x de levier → Votre trade en copie : 100 $ BTC LONG à 10x de levier (vos paramètres)

Compatibilité des échanges

Le système adapte automatiquement les symboles pour votre échange :

Échange Symbole de la baleine Votre symbole
Binance BTC BTCUSDT
OKX BTC BTC-USDT-SWAP
Bybit BTC BTCUSDT
Bitget BTC BTCUSDT
HyperLiquid BTC BTC (sans changement)

Logique de placement des ordres

SI nouvelle position de baleine détectée : → Vérifier si broadcast_signals est activé → Envoyer les notifications → Vérifier si place_order est activé : → Vérifier que la limite d'ordre de la baleine n'est pas dépassée → Trouver la paire de trading active correspondante → Vérifier que le bot n'a pas d'ordres en cours (éviter les conflits) → Calculer la taille de l'ordre à partir de VOS paramètres → Placer un ordre au marché avec VOS TP/SL → Sauvegarder dans opentrades.yaml → Ajouter à la surveillance pour la clôture automatique

👁️ Surveillance des positions & Clôture automatique

Suivi de clôture automatique

Lorsque vous copiez un trade de baleine, le système surveille la position de la baleine en continu. Si la baleine ferme sa position, votre trade en copie se ferme automatiquement aussi.

Fonctionnement

  1. Enregistrement de la position : Après avoir placé un trade en copie, la position est ajoutée à la surveillance
  2. Vérification continue : Toutes les 5 minutes, le système vérifie les positions actuelles de la baleine
  3. Détection de clôture : Identifie quand la taille de la position de la baleine diminue ou disparaît
  4. Exécution de clôture automatique : Ferme immédiatement votre position correspondante

Scénarios de clôture

Clôture complète (100 %)

Baleine : Ferme toute la position

Votre trade : Ferme automatiquement 100 % de la position

Résultat : Trade déplacé vers terminé, running_orders vidé

Clôture partielle

Baleine : Réduit la taille de la position (ex. : clôture de 50 %)

Votre trade : Ferme le pourcentage correspondant

Résultat : Trade mis à jour avec les nouvelles quantités

Gestion de l'état

# Avant clôture running_orders: - order_id: "12345" symbol: "BTCUSDT" status: "Active" whale_address: "0x2ea..." # Après clôture running_orders: null # Vidé, prêt pour le prochain trade completed_trades: - order_id: "12345" status: "Closed" realized_pnl: 45.30 close_reason: "Baleine #1 a fermé la position BTC"

🛡️ Fonctionnalités de sécurité

Limites d'ordre

Limite par baleine (max_orders_per_whale)

  • Par défaut : 2 ordres simultanés par baleine
  • Configurable : Définir n'importe quel nombre (1-10 recommandé)
  • Objectif : Éviter une surexposition à une seule baleine

Exemple : Baleine #1 a 2 positions actives → Nouvelle position détectée → Système vérifie : limite de 2/2 atteinte → Ordre ignoré : "Limite d'ordre de baleine atteinte"

Mode démo

Testez le système sans risquer de capital réel :

general: demo_mode: true # Simule les ordres sans exécution

En mode démo :

  • ✅ Détecte les positions des baleines
  • ✅ Diffuse les signaux
  • ✅ Enregistre les détails des ordres
  • ❌ Aucun ordre réel placé
  • ❌ Aucun appel à l'API de l'échange

Prévention des conflits de bot

Avant de placer un trade en copie :

  • Vérifie si le bot cible a des ordres en cours
  • Ignore l'ordre si le bot est déjà en train de trader
  • Évite plusieurs positions simultanées sur le même symbole

Validation des positions

Chaque ordre est validé pour :

  • Symbole valide : Doit exister sur votre échange
  • Prix actuel : Doit être récupérable (> 0)
  • Calcul de la quantité : Doit respecter les minimums de l'échange
  • Limites de levier : Dans la plage autorisée par l'échange

🔧 Dépannage

Problèmes courants

❌ "Aucune adresse de baleine configurée"

Problème : La liste tracking_addresses est vide

Solution :

HyperLiquidWhaleTracker: tracking_addresses: - "0xVOTRE_ADRESSE_BALEINE_ICI"

📎 Related Topics