🚀 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
- Source d’événements — Le bot s’abonne aux événements on-chain des portefeuilles Hyperliquid spécifiés.
- 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).
- Décision — Si
place_order = true, une transaction copiée est créée via votre API d’échange ; sinon, un signal est diffusé. - 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.
- Cycle de vie — Le bot surveille les positions copiées et les ferme automatiquement si
close_on_whale_closeest activé. - 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
DemoModepour 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: falseetDemoMode: truepour des tests sécurisés. - Vérifiez les messages de signal avant d’activer le trading miroir.
- Commencez avec un petit
order_amountet confirmez la détection correcte des événements. - Surveillez
completedorders.yamlpour 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.
⚖️ Avis légal et éthique
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.yamlet 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.