Hyperliquid Whale Trading Copié — Reproduisez instantanément les trades des pros

Aperçu

L'Hyperliquid Whale Tracker surveille les adresses de portefeuille (whales) et réagit lorsque ces portefeuilles ouvrent ou ferment des positions. Il prend en charge deux modes principaux :

Mode signal uniquement — diffuse les événements des whales vers vos canaux de notification (Telegram, Discord, WhatsApp, etc.).
Mode miroir — place automatiquement des ordres copiés et les ferme lorsque la whale ferme sa position.

La fonctionnalité est entièrement configurable via tradesettings.yaml et peut être activée par instance de bot. Par défaut, elle est désactivée.

Configuration

Ajoutez ou mettez à jour la section HyperLiquidWhaleTracker dans votre tradesettings.yaml (ou variante appsettings.yaml si vous centralisez les paramètres). Exemple :

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # Ajoutez une ou plusieurs adresses de portefeuille de whale
    - "0x1cD4...Aa77"
  place_order: false             # true = placer automatiquement les ordres copiés, false = signal uniquement
  order_amount: 100.0            # Montant en BaseCurrency par trade copié
  leverage: 3                    # Levier à utiliser pour les trades copiés (si applicable)
  broadcast_signals: true        # true = envoyer des notifications lorsque la whale ouvre/ferme des trades
  max_open_per_whale: 2          # Nombre maximal de trades ouverts par whale suivie (sécurité)
  slippage_tolerance_percent: 0.5 # Slippage maximal acceptable lors de la copie des ordres
  follow_partial_fills: true     # Si true, le bot copie proportionnellement les fills partiels
  close_on_whale_close: true     # Fermer l'ordre copié lorsque la whale ferme sa position
  include_liquidations: false    # Si true, copiera les liquidations (non recommandé)
  only_follow_buy: false         # Si true, suivre uniquement les achats
  only_follow_sell: false        # Si true, suivre uniquement les ventes
  min_whale_order_value: 50.0    # Valeur minimale des ordres pour le suivi/la copie
  cooldown_seconds: 30           # Secondes à attendre entre le traitement des événements pour la même whale

Descriptions des champs

is_enabled — Activer/désactiver le tracker de whales (par défaut : false).
tracking_addresses — Liste des adresses de portefeuille à suivre. Pas de limite stricte ; ajoutez autant que vous le souhaitez mais surveillez l'utilisation des ressources.
place_order — Si true, le bot tentera de placer automatiquement des ordres copiés. Si false, il se contente de diffuser des signaux.
order_amount — Taille de l'ordre copié dans votre devise de base (ex : USDT) par trade. Pensez à utiliser une gestion de taille adaptée en production.
leverage — Levier pour ouvrir des positions futures copiées (si la plateforme prend en charge le levier).
broadcast_signals — Envoyer des messages formatés aux canaux de diffusion configurés.
max_open_per_whale — Limite de sécurité pour éviter la surexposition à une seule whale.
slippage_tolerance_percent — Slippage maximal acceptable lors de la copie des ordres.
follow_partial_fills — Si un ordre de whale est partiellement rempli, le bot copie le même ratio rempli.
close_on_whale_close — Fermer les ordres copiés lorsque la whale ferme sa position.
include_liquidations — Copier les liquidations uniquement si vous comprenez les risques extrêmes.
only_follow_buy / only_follow_sell — Filtres pour suivre uniquement les achats ou uniquement les ventes.
min_whale_order_value — Ignorer les petits ordres de whales en dessous de ce seuil.
cooldown_seconds — Évite le spam d'événements en espaçant le traitement par whale.

Fonctionnement (flux technique)

Source d'événements : Le bot s'abonne aux événements de portefeuille Hyperliquid (ou interroge la blockchain/API) pour les adresses configurées.
Détection d'événement : À la détection d'un nouvel ordre ouvert/fermé, le bot le valide selon les filtres (valeur minimale, type d'action, cooldown).
Décision : Si place_order = true, le bot crée une demande d'ordre copié avec vos identifiants d'échange configurés, incluant levier et règles de taille. Sinon, il construit uniquement un message de diffusion.
Exécution : Tente de placer l'ordre, en tenant compte du slippage et du solde disponible. Si follow_partial_fills = true, le bot ajuste les quantités copiées proportionnellement.
Cycle de vie : Le bot surveille le statut des ordres copiés et, si close_on_whale_close = true, ferme les ordres copiés lorsque la whale ferme les siens.
Journalisation & alertes : Tous les événements et actions sont enregistrés (voir Journalisation & Monitoring). Les notifications sont diffusées si configurées.

Prérequis & Permissions

Instance MagicTradeBot fonctionnelle avec licence valide et tradesettings.yaml configuré.
Clés API d'échange avec permissions de trading (si place_order est activé). Pour les actions basées sur les portefeuilles Hyperliquid, une clé privée peut être nécessaire — ne jamais stocker les clés privées en clair (utilisez les variables d'environnement).
Connexion Internet stable et paramètres de rate-limit adéquats dans appsettings.yaml pour éviter les blocages API.

Considérations de sécurité

Ne jamais coder en dur les clés privées ou secrets API dans les fichiers du dépôt. Utilisez des variables d'environnement ou un gestionnaire de secrets OS.
Limiter les permissions des clés API au strict nécessaire (trading, idéalement sans retraits).
Tester soigneusement en DemoMode avant d'activer les ordres copiés en direct.
Définir des valeurs par défaut conservatrices : max_open_per_whale, slippage_tolerance_percent et min_whale_order_value.
Activer la journalisation et les alertes (Sentry, PagerDuty) pour être informé des erreurs d'exécution ou comportements inattendus.

Exemples de notifications & diffusion

Lorsque broadcast_signals est true, le bot envoie un message formaté. Exemples :

Telegram / Discord (texte)


[Hyperliquid Whale] NOUVEL ORDRE
Whale : 0x2aB3...Ff12
Action : ACHAT (Long)
Symbole : BTCUSDT
Taille : 0.5 BTC (~25000 USDT)
Levier : 3x
Heure : 2025-10-16T12:34:56Z
Copié : oui (id ordre : M-123456)   # ou "Copié : non" si place_order=false

WhatsApp / Webhook (payload 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"
}

Mode test & démo

Toujours tester avec DemoMode: true ou en utilisant les testnets des exchanges.
Définir place_order: false pour vérifier la détection des événements et la mise en forme des diffusions sans exécuter de trades.
Utiliser de petits order_amount lors des tests en direct et surveiller les logs dans completedorders.yaml et le terminal.

Bonnes pratiques opérationnelles

Utiliser max_open_per_whale pour éviter la surexposition à la séquence de trades d'une whale.
Activer cooldown_seconds pour réduire le traitement en double si les whales divisent les ordres en micro-ordres.
Préférer signal uniquement lors de marchés volatils ou lorsque l'exécution rapide / contrôle du slippage ne peut être garanti.
Si vous copiez avec levier, assurez-vous d'avoir de la marge et des sécurités (seuils globaux de fermeture forcée).
Journaliser chaque événement entrant et action copiée pour l'audit et les backtests.

Journalisation & monitoring

Journalisation / monitoring recommandés à activer dans appsettings.yaml ou votre configuration de bot :

Logs terminal pour dépannage en temps réel.
completedorders.yaml — trades copiés complétés persistés pour backtest et PnL.
Journalisation distante optionnelle : Sentry, Loki, LogDNA, DataDog pour alertes et logs historiques.
Métriques Prometheus pour le nombre de positions ouvertes, ordres copiés et taux d'erreurs.

Gestion des erreurs & retries

En cas d'échec de placement d'ordre, le bot réessaie jusqu'à 3 fois avec backoff exponentiel (configurable).
Si le slippage dépasse slippage_tolerance_percent, l'ordre est annulé et un avertissement est émis.
Si l'ordre copié ne peut être placé faute de solde suffisant, le bot diffuse un avertissement et ignore la copie.

Limitations & risques

Suivre des portefeuilles ne garantit pas un profit — les whales peuvent être market makers, initiés ou effectuer des manipulations à court terme.
Copier des liquidations ou des mouvements à fort levier peut amplifier les pertes.
La latence d'exécution et le slippage peuvent provoquer des résultats différents par rapport à la whale.
Respecter les limites de l'API de l'exchange — suivre de nombreuses whales augmente les appels API et l'utilisation des ressources.

FAQ

Q : Puis-je suivre n'importe quelle adresse de portefeuille ?

R : Oui — ajoutez n'importe quelle adresse publique dans tracking_addresses. Le bot tentera de détecter les événements d'ouverture/fermeture associés à cette adresse.

Q : Le bot reproduira-t-il exactement la taille des positions ?

R : Pas nécessairement. Le bot utilise order_amount comme taille du trade copié (ou copie proportionnellement les fills partiels si activé). Vous pouvez utiliser une taille basée sur pourcentage dans la configuration avancée de money-management.

Q : Que se passe-t-il si une whale divise un ordre en plusieurs micro-ordres ?

R : Utilisez cooldown_seconds et follow_partial_fills pour contrôler la copie des ordres fractionnés et éviter la surexposition.

Checklist de démarrage

Activer le tracker : définir is_enabled: true dans tradesettings.yaml.
Ajouter les adresses de whales dans tracking_addresses.
Définir place_order = false initialement pour vérifier les événements et notifications.
Vérifier que les diffusions sont envoyées sur Telegram/Discord/WhatsApp.
Passer à place_order: true une fois à l'aise, garder DemoMode = true jusqu'à la vérification en direct terminée.
Surveiller les logs et définir des alertes pour les erreurs de placement, slippage et solde insuffisant.

Exemple complet (à copier dans `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

Avis légal & éthique

Suivre et copier l'activité publique des portefeuilles est techniquement possible, mais vous devez respecter les lois locales, les conditions des exchanges et les pratiques éthiques de trading. MagicTradeBot fournit les outils — il vous appartient de les utiliser légalement et de manière responsable.

Support & dépannage

En cas de problème :

Vérifiez les logs du terminal et completedorders.yaml pour les erreurs.
Vérifiez les clés API et leurs permissions (trading autorisé, retraits désactivés).
Confirmez que les variables d'environnement remplacent les paramètres de fichiers si elles sont utilisées pour les secrets.
Contactez le support via votre tableau de bord MagicTradeBot ou consultez la documentation complète de configuration.