Hyperliquid Whale Copy Trading — Copia istantaneamente le operazioni dei professionisti

L'Hyperliquid Whale Tracker di MagicTradeBot consente di seguire l'attività dei wallet su Hyperliquid e altre exchange basate su wallet. Monitora qualsiasi indirizzo wallet, ricevi notifiche e, facoltativamente, replica (apri/chiudi) gli ordini automaticamente con controlli flessibili di sicurezza e filtraggio.

Panoramica

L'Hyperliquid Whale Tracker osserva gli indirizzi wallet (whales) e reagisce quando questi aprono o chiudono posizioni. Supporta due modalità principali:

  • Modalità solo segnale — trasmette gli eventi delle whales ai tuoi canali di notifica (Telegram, Discord, WhatsApp, ecc.).
  • Modalità mirror — piazza automaticamente ordini speculari e li chiude quando la whale chiude la sua posizione.

La funzione è completamente configurabile tramite tradesettings.yaml e può essere abilitata per singola istanza del bot. Di default è disabilitata.

Configurazione

Aggiungi o aggiorna la sezione HyperLiquidWhaleTracker nel tuo tradesettings.yaml (o nella variante appsettings.yaml se centralizzi le impostazioni). Esempio: 

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # Aggiungi uno o più indirizzi wallet delle whales
    - "0x1cD4...Aa77"
  place_order: false             # true = piazza automaticamente ordini speculari, false = solo segnale
  order_amount: 100.0            # Quantità in BaseCurrency per ogni trade speculare
  leverage: 3                    # Leva da usare per i trade speculari (se applicabile)
  broadcast_signals: true        # true = invia notifiche quando la whale apre/chiude trade
  max_open_per_whale: 2          # Numero massimo di trade speculari aperti per ogni whale monitorata (sicurezza)
  slippage_tolerance_percent: 0.5 # Slippage massimo accettabile piazzando ordini speculari
  follow_partial_fills: true     # Se true, il bot replica proporzionalmente i fill parziali
  close_on_whale_close: true     # Chiude l'ordine speculare quando la whale chiude la sua posizione
  include_liquidations: false    # Se true, replica le liquidazioni (non raccomandato)
  only_follow_buy: false         # Se true, segue solo acquisti
  only_follow_sell: false        # Se true, segue solo vendite
  min_whale_order_value: 50.0    # Valore minimo dell'ordine (BaseCurrency) per tracking/replica
  cooldown_seconds: 30           # Secondi di attesa tra eventi per la stessa whale

Descrizione dei Campi

  • is_enabled — Abilita/disabilita il tracker delle whales (default: false).
  • tracking_addresses — Elenco degli indirizzi wallet da seguire. Nessun limite rigido; aggiungi quanti ne vuoi, tenendo conto delle risorse.
  • place_order — Se true, il bot tenterà di piazzare automaticamente ordini speculari. Se false, trasmette solo segnali.
  • order_amount — Dimensione dell'ordine speculare nella valuta base (es. USDT) per ogni trade. Considera l'uso della gestione del rischio in produzione.
  • leverage — Leva per aprire posizioni speculari sui futures (solo se la exchange la supporta).
  • broadcast_signals — Invia messaggi formattati ai canali di notifica configurati.
  • max_open_per_whale — Limite di sicurezza per evitare esposizione eccessiva verso una singola whale.
  • slippage_tolerance_percent — Slippage massimo accettabile piazzando ordini.
  • follow_partial_fills — Se un ordine della whale viene riempito parzialmente, il bot replica la stessa proporzione.
  • close_on_whale_close — Chiude gli ordini speculari quando la whale chiude la sua posizione.
  • include_liquidations — Replica le liquidazioni solo se si comprendono i rischi estremi.
  • only_follow_buy / only_follow_sell — Filtra per seguire solo acquisti o solo vendite.
  • min_whale_order_value — Ignora ordini troppo piccoli al di sotto di questa soglia.
  • cooldown_seconds — Evita spam di eventi intervallando il processo per ogni whale.

Come funziona (flusso tecnico)

  1. Fonte degli Eventi: Il bot si iscrive agli eventi dei wallet Hyperliquid (o interroga blockchain/API) per gli indirizzi configurati.
  2. Rilevamento Eventi: Alla rilevazione di un nuovo evento di apertura/chiusura, il bot lo valida secondo filtri (valore minimo, tipo di azione, cooldown).
  3. Decisione: Se place_order = true, il bot crea una richiesta di ordine speculare usando le credenziali della tua exchange, incluse regole di dimensione e leva. Altrimenti crea solo il messaggio di broadcast.
  4. Esecuzione: Tenta di piazzare l'ordine, considerando la tolleranza allo slippage e il saldo disponibile. Se follow_partial_fills = true, adatta proporzionalmente le quantità dell'ordine speculare.
  5. Ciclo di Vita: Il bot monitora lo stato dell'ordine speculare e, se close_on_whale_close = true, chiude l'ordine quando la whale chiude il proprio.
  6. Log & Avvisi: Tutti gli eventi e le azioni vengono registrati. Le notifiche vengono inviate se configurate.

Prerequisiti & Permessi

  • Istanza funzionante di MagicTradeBot con licenza valida e tradesettings.yaml configurato.
  • Chiavi API della exchange con permessi di trading (se place_order abilitato). Per azioni basate sui wallet Hyperliquid, potrebbe essere necessaria una chiave privata — non memorizzare mai chiavi private in chiaro (usa variabili d'ambiente).
  • Connessione Internet stabile e configurazione adeguata dei limiti di rate in appsettings.yaml per evitare blocchi API.

Considerazioni sulla Sicurezza

  • Non inserire mai chiavi private o segreti API nei file del repository. Usa variabili d'ambiente o sistemi di gestione dei segreti del sistema operativo.
  • Limita i permessi della API solo a ciò che serve (trading, idealmente senza prelievi).
  • Testa accuratamente in DemoMode prima di attivare ordini speculari live.
  • Imposta valori predefiniti conservativi: max_open_per_whale, slippage_tolerance_percent, e min_whale_order_value.
  • Abilita logging e alerting (Sentry, PagerDuty) per essere avvisato di errori o comportamenti inattesi.

Esempi di Notifica & Broadcast

Quando broadcast_signals è true, il bot invia un messaggio formattato. Esempi:

Telegram / Discord (testo)


[Hyperliquid Whale] NUOVO ORDINE
Whale: 0x2aB3...Ff12
Azione: BUY (Long)
Simbolo: BTCUSDT
Quantità: 0.5 BTC (~25000 USDT)
Leva: 3x
Ora: 2025-10-16T12:34:56Z
Speculare: sì (id ordine: M-123456)   # oppure "Speculare: no" se place_order=false

WhatsApp / Webhook (JSON payload)

{
  "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"
}

Test & Modalità Demo

  • Testa sempre con DemoMode: true o usando testnet della exchange.
  • Imposta place_order: false per verificare rilevamento eventi e formato broadcast senza eseguire trade.
  • Usa piccoli order_amount durante test live e monitora log in completedorders.yaml e terminale.

Best Practices Operative

  • Usa max_open_per_whale per evitare sovra-esposizione a una sequenza di trade di una whale.
  • Abilita cooldown_seconds per ridurre elaborazioni duplicate se le whales dividono ordini in micro-ordini.
  • Preferisci solo segnale in mercati volatili o se non puoi garantire esecuzione veloce/slippage controllato.
  • Se replichi con leva, assicurati di avere margine e fail-safe (chiusura forzata globale).
  • Registra ogni evento in entrata e azione speculare per audit e backtesting.

Logging & Monitoraggio

Logging/monitoraggio raccomandato in appsettings.yaml o configurazione bot:

  • Log sul terminale per troubleshooting in tempo reale.
  • completedorders.yaml — trade speculari completati persistiti per backtest e PnL.
  • Logging remoto opzionale: Sentry, Loki, LogDNA, DataDog per alert e audit storico.
  • Metrica Prometheus per contatore posizioni aperte, ordini speculari e tassi di errore.

Gestione Errori & Ritentativi

  • In caso di fallimento piazzamento ordine, il bot riprova fino a 3 volte con backoff esponenziale (configurabile).
  • Se lo slippage supera slippage_tolerance_percent, l'ordine viene annullato e viene emesso un avviso.
  • Se l'ordine speculare non può essere piazzato per saldo insufficiente, il bot invia un avviso e salta la replica.

Limitazioni & Rischi

  • Seguire wallet non garantisce profitto — le whales possono essere market maker, insider o manipolare il mercato a breve termine.
  • Replicare liquidazioni o movimenti ad alta leva può amplificare le perdite.
  • Latenza e slippage possono causare risultati diversi rispetto alla whale.
  • Rispetta i limiti API della exchange — monitorare molte whales aumenta chiamate API e utilizzo risorse.

FAQ

D: Posso monitorare qualsiasi indirizzo wallet?

R: Sì — aggiungi qualsiasi indirizzo pubblico in tracking_addresses. Il bot tenterà di rilevare eventi di apertura/chiusura associati.

D: Il bot replicherà esattamente le dimensioni delle posizioni?

R: Non necessariamente. Il bot usa order_amount come dimensione del trade speculare (o replica proporzionalmente i fill parziali se abilitato). È possibile implementare un dimensionamento percentuale con configurazione avanzata di gestione capitale.

D: Cosa succede se una whale divide un ordine in molti micro-ordini?

R: Usa cooldown_seconds e follow_partial_fills per controllare come vengono replicate le ordini divisi e prevenire sovra-esposizione.

Checklist per Iniziare

  1. Abilita il tracker: imposta is_enabled: true in tradesettings.yaml.
  2. Aggiungi indirizzi whales in tracking_addresses.
  3. Imposta place_order = false inizialmente per verificare eventi e notifiche.
  4. Verifica che i broadcast arrivino su Telegram/Discord/WhatsApp.
  5. Passa a place_order: true quando pronto, mantenendo DemoMode = true fino alla verifica live.
  6. Monitora log e configura alert per errori di esecuzione, slippage e saldo insufficiente.

Esempio Completo (da copiare in 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

Monitorare e replicare l'attività dei wallet pubblici è tecnicamente possibile, ma bisogna rispettare le leggi locali, i termini delle exchange e le pratiche etiche di trading. MagicTradeBot fornisce gli strumenti — è tua responsabilità usarli legalmente e responsabilmente.

Supporto & Risoluzione Problemi

Se riscontri problemi:

  • Controlla i log sul terminale e completedorders.yaml per errori.
  • Verifica chiavi API e permessi (trading consentito, prelievi disabilitati).
  • Verifica che le variabili d'ambiente sovrascrivano le impostazioni file, se usate per segreti.
  • Contatta il supporto tramite il pannello MagicTradeBot o consulta la documentazione completa di configurazione.

📎 Related Topics