MagicTradeBot v3.1 — Présentation de la fonctionnalité de copie de trading des baleines Hyperliquid

Publié: 17 octobre, 2025

Le nouveau Hyperliquid Whale Tracker de MagicTradeBot vous permet de suivre l’activité de trading au niveau des portefeuilles sur Hyperliquid et d’autres échanges décentralisés basés sur les portefeuilles. Vous pouvez désormais suivre n’importe quelle adresse de portefeuille, recevoir des notifications en temps réel et même copier automatiquement les transactions des baleines avec des options complètes de sécurité, de filtrage et de contrôle.

🚀 Aperçu

Le Hyperliquid Whale Tracker est un nouveau module de MagicTradeBot v3.1 conçu pour les traders souhaitant tirer parti de la transparence on-chain. Il surveille en continu les portefeuilles de baleines sélectionnés et réagit lorsque ces portefeuilles ouvrent ou ferment des positions. Vous pouvez l’utiliser dans deux modes principaux :

  • Mode signal uniquement — recevez des alertes de transactions de baleines en temps réel via Telegram, Discord, WhatsApp ou Webhooks.
  • Mode miroir — exécutez automatiquement les transactions copiées sur votre compte d’échange connecté, avec des garde-fous intelligents.

La configuration est entièrement gérée via votre fichier tradesettings.yaml et peut être activée par instance de bot. Par défaut, elle est désactivée pour des raisons de sécurité.

⚙️ Exemple de configuration

Pour activer le tracker, ajoutez la section suivante dans votre fichier 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

Cette configuration suit deux portefeuilles de baleines, copie leurs transactions avec un effet de levier de 3x et un montant de 150 $ par transaction, et ferme automatiquement les positions copiées lorsque les baleines ferment les leurs.

🧠 Fonctionnement

  1. Source d’événements — Le bot s’abonne aux événements on-chain des portefeuilles Hyperliquid spécifiés.
  2. Détection d’événements — Lorsqu’une baleine ouvre ou ferme une position, le bot valide la transaction selon les filtres (taille, délai, direction).
  3. Décision — Si place_order = true, une transaction copiée est créée via votre API d’échange ; sinon, un signal est diffusé.
  4. Exécution — Les ordres sont passés en respectant les limites de glissement, l’effet de levier et la marge disponible. Les exécutions partielles peuvent être copiées proportionnellement.
  5. Cycle de vie — Le bot surveille les positions copiées et les ferme automatiquement si close_on_whale_close est activé.
  6. Journalisation et alertes — Tous les événements sont enregistrés et peuvent être envoyés à vos canaux de notification ou de surveillance.

🔒 Sécurité et contrôles des risques

  • Ne jamais coder en dur les clés API ou privées — utilisez des variables d’environnement ou des secrets chiffrés.
  • Limitez les permissions au trading uniquement ; n’activez jamais les retraits.
  • Utilisez le DemoMode pour les tests initiaux avant la mise en production.
  • Définissez max_open_per_whale et slippage_tolerance_percent de manière prudente.
  • Activez la surveillance des erreurs (ex. : Sentry, PagerDuty) pour les déploiements en production.

📣 Notifications et diffusions

Lorsque broadcast_signals: true est activé, MagicTradeBot envoie des alertes formatées pour chaque événement de transaction de baleine.

Exemple (Telegram / Discord) :

[Hyperliquid Whale] NOUVEL ORDRE
Baleine : 0x2aB3...Ff12
Action : ACHAT (Long)
Symbole : BTCUSDT
Taille : 0.5 BTC (~25 000 USDT)
Effet de levier : 3x
Copié : oui (ID de commande : M-123456)

Exemple (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"
}

🧩 Tests et mode démo

  • Définissez place_order: false et DemoMode: true pour des tests sécurisés.
  • Vérifiez les messages de signal avant d’activer le trading miroir.
  • Commencez avec un petit order_amount et confirmez la détection correcte des événements.
  • Surveillez completedorders.yaml pour les journaux des transactions copiées.

⚡ Bonnes pratiques opérationnelles

  • Utilisez cooldown_seconds pour éviter le sur-trading lorsque les baleines divisent leurs ordres.
  • Gardez le mode signal uniquement pendant les marchés volatils.
  • Combinez avec les modules de gestion monétaire pour un dimensionnement dynamique et une réduction des risques.
  • Utilisez Prometheus et Loki pour la surveillance et l’audit des événements.

⚠️ Limitations et risques

  • Suivre une baleine ≠ profit garanti — les baleines peuvent aussi perdre ou manipuler.
  • La latence d’exécution et le glissement peuvent provoquer des écarts dans les résultats des transactions copiées.
  • Le suivi de nombreux portefeuilles augmente la charge API — ajustez les limites de taux en conséquence.

💬 FAQ

Q : Puis-je suivre n’importe quel portefeuille ?

Oui. Ajoutez toute adresse publique de portefeuille sous tracking_addresses — le bot détectera automatiquement l’activité de trading correspondante.

Q : Correspond-il exactement à la taille de la position de la baleine ?

Non. Il utilise votre order_amount configuré ou une taille proportionnelle si follow_partial_fills est activé.

Q : Et si une baleine envoie plusieurs micro-ordres ?

Utilisez cooldown_seconds et follow_partial_fills pour éviter les doublons et contrôler la surexposition.

Bien que le suivi des activités publiques de portefeuilles soit transparent sur la blockchain, assurez-vous de respecter les conditions des échanges et les réglementations locales. MagicTradeBot fournit les outils — vous êtes responsable de leur utilisation légale et éthique.

🛠️ Support et dépannage

  • Consultez completedorders.yaml et les journaux pour détecter les erreurs.
  • Vérifiez les permissions API et les configurations des variables d’environnement.
  • Contactez le support officiel MagicTradeBot via votre tableau de bord pour obtenir une assistance technique.