🚀 Panoramica
Il Hyperliquid Whale Tracker è un nuovo modulo di MagicTradeBot v3.1 progettato per i trader che desiderano sfruttare la trasparenza on-chain. Monitora continuamente i portafogli delle balene selezionati e reagisce quando questi aprono o chiudono posizioni. Può essere utilizzato in due modalità principali:
- Modalità solo segnali — ricevi avvisi in tempo reale sulle operazioni delle balene tramite Telegram, Discord, WhatsApp o Webhook.
- Modalità specchio — esegui automaticamente operazioni replicate sul tuo account di exchange collegato, con protezioni intelligenti.
La configurazione è gestita interamente tramite il file tradesettings.yaml e può essere attivata per ogni istanza del bot. Per impostazione predefinita, è disattivata per motivi di sicurezza.
⚙️ Esempio di configurazione
Per attivare il tracker, aggiungi la seguente sezione nel tuo file 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
Questa configurazione monitora due portafogli di balene, replica le loro operazioni con una leva di 3x e un importo di 150 $ per operazione, e chiude automaticamente le posizioni replicate quando le balene chiudono le loro.
🧠 Come funziona
- Fonte degli eventi — Il bot si iscrive agli eventi on-chain dei portafogli Hyperliquid specificati.
- Rilevamento degli eventi — Quando una balena apre o chiude una posizione, il bot valida l’operazione in base ai filtri (dimensione, intervallo di cooldown, direzione).
- Decisione — Se
place_order = true, viene creata un’operazione replicata tramite l’API del tuo exchange; altrimenti, viene trasmesso un segnale. - Esecuzione — Gli ordini vengono effettuati rispettando i limiti di slippage, la leva e il margine disponibile. Le esecuzioni parziali possono essere replicate proporzionalmente.
- Ciclo di vita — Il bot monitora le posizioni replicate e le chiude automaticamente se
close_on_whale_closeè attivato. - Registrazione e avvisi — Tutti gli eventi vengono registrati e, opzionalmente, inviati ai tuoi canali di notifica o monitoraggio.
🔒 Sicurezza e controlli dei rischi
- Non codificare mai chiavi API o chiavi private — utilizza variabili d’ambiente o segreti crittografati.
- Limita le autorizzazioni al solo trading; non abilitare mai i prelievi.
- Utilizza la
DemoModeper i test iniziali prima di passare alla modalità live. - Imposta max_open_per_whale e slippage_tolerance_percent in modo prudente.
- Attiva il monitoraggio degli errori (es. Sentry, PagerDuty) per i deploy in produzione.
📣 Notifiche e trasmissioni
Quando broadcast_signals: true è attivato, MagicTradeBot invia avvisi formattati per ogni evento di operazione delle balene.
Esempio (Telegram / Discord):
[Hyperliquid Whale] NUOVO ORDINE
Balena: 0x2aB3...Ff12
Azione: ACQUISTO (Long)
Simbolo: BTCUSDT
Dimensione: 0.5 BTC (~25.000 USDT)
Leva: 3x
Replicato: sì (ID ordine: M-123456)
Esempio (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"
}
🧩 Test e modalità demo
- Imposta
place_order: falseeDemoMode: trueper test sicuri. - Verifica i messaggi di segnale prima di abilitare il trading in modalità specchio.
- Inizia con un piccolo
order_amounte conferma il rilevamento corretto degli eventi. - Monitora
completedorders.yamlper i registri delle operazioni replicate.
⚡ Migliori pratiche operative
- Utilizza cooldown_seconds per evitare il sovraccarico di trading quando le balene suddividono gli ordini.
- Mantieni la modalità solo segnali durante i mercati volatili.
- Combina con i moduli di gestione del denaro per un dimensionamento dinamico e la mitigazione dei rischi.
- Utilizza Prometheus e Loki per metriche di osservabilità e audit degli eventi.
⚠️ Limiti e rischi
- Seguire una balena ≠ profitto garantito — anche le balene possono perdere o manipolare.
- La latenza di esecuzione e lo slippage possono causare discrepanze nei risultati delle operazioni replicate.
- Il monitoraggio di molti portafogli aumenta il carico API — regola i limiti di frequenza di conseguenza.
💬 Domande frequenti
D: Posso monitorare qualsiasi portafoglio?
Sì. Aggiungi qualsiasi indirizzo pubblico di portafoglio sotto tracking_addresses — il bot rileverà automaticamente l’attività di trading corrispondente.
D: Replica esattamente la dimensione della posizione della balena?
No. Utilizza il tuo order_amount configurato o una dimensione proporzionale se follow_partial_fills è attivato.
D: Cosa succede se una balena invia più micro-ordini?
Utilizza cooldown_seconds indicator_seconds e follow_partial_fills per evitare duplicati e controllare la sovraesposizione.
⚖️ Avviso legale ed etico
Sebbene il monitoraggio delle attività dei portafogli pubblici sia trasparente sulla blockchain, assicurati di rispettare i termini dell’exchange e le normative locali. MagicTradeBot fornisce gli strumenti — sei responsabile del loro utilizzo legale ed etico.
🛠️ Supporto e risoluzione dei problemi
- Controlla
completedorders.yamle i log per rilevare eventuali errori. - Verifica le autorizzazioni API e le configurazioni delle variabili d’ambiente.
- Contatta il supporto ufficiale di MagicTradeBot tramite il tuo dashboard per assistenza tecnica.