Guida utente di Hyperliquid Whale Tracker

📑 Sommario

📖 Panoramica

Il Hyperliquid Whale Tracker è una funzionalità avanzata che monitora le attività dei portafogli delle balene sull'exchange Hyperliquid e consente il copy trading automatico. Quando una balena monitorata apre una nuova posizione, il sistema può trasmettere automaticamente segnali a Discord/Telegram e/o effettuare operazioni mirror sul tuo account.

🔍 Rilevamento in Tempo Reale

Monitora le posizioni delle balene ogni 5 minuti e rileva istantaneamente nuove posizioni.

📢 Avvisi Multi-Piattaforma

Trasmette segnali a Discord, Telegram e WhatsApp con formattazione ricca.

🤖 Copy Trading Automatico

Replica automaticamente le posizioni delle balene con le tue impostazioni personalizzate e parametri di rischio.

🎯 Tracciamento Intelligente della Chiusura

Chiude automaticamente la tua posizione quando la balena chiude la propria.

⚙️ Configurazione

Impostazioni di Base

Trovate nel file di configurazione sotto HyperLiquidWhaleTracker:

HyperLiquidWhaleTracker: is_enabled: true # Abilita/disabilita il tracciamento delle balene tracking_addresses: # Lista degli indirizzi dei portafogli delle balene - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4" - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae" - "0x9458f423df6569f053358ee9906613cd69c1ec04" # Aggiungi altri indirizzi... place_order: false # Posiziona automaticamente ordini mirror broadcast_signals: true # Trasmette alle piattaforme di messaggistica max_orders_per_whale: 2 # Numero massimo di ordini simultanei per balena

Configurazione delle Piattaforme di Messaggistica

broadcast: # Discord discord_webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK" # Telegram telegram_bot_token: "YOUR_BOT_TOKEN" telegram_chat_id: "YOUR_CHAT_ID" # WhatsApp (opzionale) whatsapp_token: "YOUR_TOKEN" whatsapp_phone_id: "YOUR_PHONE_ID"

Impostazioni di Trading

general: initial_trade_amount: 100 # Importo in USD per trade leverage: 10 # Moltiplicatore di leva demo_mode: false # Test senza operazioni reali sltp_settings: take_profit_percent: 5.0 # Percentuale di take profit stop_loss_percent: 2.0 # Percentuale di stop loss

🔧 Come Funziona

Processo di Rilevamento

1Scansione Iniziale

Al primo avvio, il sistema registra tutte le posizioni esistenti delle balene senza trasmettere (previene lo spam).

2Monitoraggio Continuo

Ogni 5 minuti, il sistema:

  • Recupera le posizioni correnti per ogni balena monitorata
  • Confronta con le posizioni viste precedentemente
  • Rileva le NUOVE posizioni che non erano presenti prima

3Identificazione della Posizione

Una posizione è considerata NUOVA quando:

  • La moneta non era nel portafoglio della balena durante l'ultimo controllo
  • Il sistema non ha trasmesso questa posizione in precedenza

4Esecuzione dell'Azione

Per ogni nuova posizione:

  • Trasmette il segnale alle piattaforme configurate (se abilitato)
  • Posiziona un ordine di copy trading (se abilitato)
  • Aggiunge la posizione al monitoraggio per il tracciamento della chiusura automatica

Dati delle Posizioni delle Balene Monitorate

Punto Dati Descrizione
Moneta Coppia di trading (es. BTC, ETH, SOL)
Lato Posizione lunga o corta
Dimensione Dimensione della posizione in contratti
Prezzo di Entrata Prezzo di entrata della balena
Leva Leva della posizione
PnL Non Realizzato Profitto/perdita corrente
Prezzo di Liquidazione Soglia di rischio

📢 Trasmissione dei Segnali

Abilitazione delle Trasmissioni

Imposta broadcast_signals: true nella tua configurazione per ricevere notifiche quando le balene aprono posizioni.

Notifiche Discord

Formato Rich Embed

  • Codificato a colori (Verde per LONG, Rosso per SHORT)
  • Campi organizzati con tutti i dettagli della posizione
  • Link cliccabile al portafoglio della balena
  • Timestamp per il tracciamento
🐋 Allerta Balena: Balena #1 Balena #1 ha aperto una posizione LONG su BTC 📊 Dettagli della Posizione Moneta: BTC Lato: LONG 📈 Dimensione: 50.5 Leva: 20x 💰 Informazioni sul Prezzo Prezzo di Entrata: $65.432,10 PnL Non Realizzato: $-125,50 ⏰ Tempistiche Posizione Aperta: 2025-01-15 14:30:00 UTC Rilevata: 14:35:00

Notifiche Telegram

Formato Markdown

  • Formato di testo chiaro e leggibile
  • Blocchi di codice monospace per i dati
  • Link diretto per il tracciamento
  • Layout ottimizzato per dispositivi mobili
🐋 *ALLERTA BALENA* 🟢 *Balena #1* ha aperto una posizione *LONG* *Dettagli della Posizione:* Moneta : BTC Lato : LONG Dimensione : 50.5 Prezzo di Entrata : $65.432,10 Leva : 20x PnL Non Real. : $-125,50 Liquidazione : $60.123,45 text*Tempistiche:* Aperta : 2025-01-15 14:30:00 UTC Rilevata : 2025-01-15 14:35:00 text🔗 [Traccia su CoinGlass] _Balena: 0x2ea18c23..._

Selezione della Piattaforma

Il sistema trasmette a tutte le piattaforme configurate con credenziali valide. Le piattaforme senza credenziali vengono automaticamente ignorate:

  • Discord: Richiede discord_webhook_url
  • Telegram: Richiede sia telegram_bot_token che telegram_chat_id
  • WhatsApp: Richiede whatsapp_token e whatsapp_phone_id

🤖 Copy Trading Automatico

Abilitazione del Trading Automatico

Imposta place_order: true per replicare automaticamente le posizioni delle balene.

Come Funziona il Copy Trading

  1. Rilevamento della Posizione: Il sistema rileva una nuova posizione della balena
  2. Corrispondenza dei Simboli: Trova la coppia di trading corrispondente sul tuo exchange
  3. Validazione dell'Ordine: Verifica i limiti dell'ordine della balena e la disponibilità del bot
  4. Piazzamento dell'Ordine: Posiziona un ordine di mercato con le tue impostazioni configurate
  5. Monitoraggio: Aggiunge la posizione al sistema di monitoraggio della chiusura

⚠️ Importante: Le Tue Impostazioni, Non Quelle della Balena

I tuoi ordini di copia utilizzano le TUE impostazioni, non quelle della balena:

  • La tua dimensione della posizione (non quella della balena)
  • La tua leva (non quella della balena)
  • Le tue percentuali di TP/SL
  • Le tue regole di gestione del rischio

Esempio: La balena apre 100 BTC LONG con leva 20x → Il tuo ordine di copia: $100 BTC LONG con leva 10x (le tue impostazioni)

Compatibilità con gli Exchange

Il sistema adatta automaticamente i simboli per il tuo exchange:

Exchange Simbolo della Balena Il Tuo Simbolo
Binance BTC BTCUSDT
OKX BTC BTC-USDT-SWAP
Bybit BTC BTCUSDT
Bitget BTC BTCUSDT
HyperLiquid BTC BTC (nessuna modifica)

Logica di Piazzamento degli Ordini

SE viene rilevata una nuova posizione della balena: → Verifica se broadcast_signals è abilitato → Invia notifiche → Verifica se place_order è abilitato: → Verifica che il limite dell'ordine della balena non sia superato → Trova la coppia di trading attiva corrispondente → Verifica che il bot non abbia ordini in corso (evita conflitti) → Calcola la dimensione dell'ordine dalle TUE impostazioni → Posiziona un ordine di mercato con il TUO TP/SL → Salva in opentrades.yaml → Aggiungi al monitoraggio per la chiusura automatica

👁️ Monitoraggio delle Posizioni & Chiusura Automatica

Tracciamento della Chiusura Automatica

Quando copi un trade di una balena, il sistema monitora continuamente la posizione della balena. Se la balena chiude la sua posizione, anche il tuo trade di copia viene chiuso automaticamente.

Come Funziona

  1. Registrazione della Posizione: Dopo aver piazzato un trade di copia, la posizione viene aggiunta al monitoraggio
  2. Controllo Continuo: Ogni 5 minuti, il sistema verifica le posizioni correnti della balena
  3. Rilevamento della Chiusura: Identifica quando la dimensione della posizione della balena diminuisce o scompare
  4. Esecuzione della Chiusura Automatica: Chiude immediatamente la tua posizione corrispondente

Scenari di Chiusura

Chiusura Completa (100%)

Balena: Chiude l'intera posizione

Il Tuo Trade: Chiude automaticamente il 100% della posizione

Risultato: Il trade viene spostato tra i completati, running_orders svuotato

Chiusura Parziale

Balena: Riduce la dimensione della posizione (es. chiusura del 50%)

Il Tuo Trade: Chiude la percentuale corrispondente

Risultato: Il trade viene aggiornato con le nuove quantità

Gestione dello Stato

# Prima della Chiusura running_orders: - order_id: "12345" symbol: "BTCUSDT" status: "Active" whale_address: "0x2ea..." # Dopo la Chiusura running_orders: null # Svuotato, pronto per il prossimo trade completed_trades: - order_id: "12345" status: "Closed" realized_pnl: 45.30 close_reason: "Balena #1 ha chiuso la posizione BTC"

🛡️ Funzionalità di Sicurezza

Limiti degli Ordini

Limite per Balena (max_orders_per_whale)

  • Predefinito: 2 ordini simultanei per balena
  • Configurabile: Imposta qualsiasi numero (1-10 consigliato)
  • Scopo: Previene un'eccessiva esposizione a una singola balena

Esempio: Balena #1 ha 2 posizioni attive → Rilevata nuova posizione → Il sistema verifica: limite 2/2 raggiunto → Ordine ignorato: "Limite ordini della balena raggiunto"

Modalità Demo

Testa il sistema senza rischiare capitale reale:

general: demo_mode: true # Simula gli ordini senza esecuzione

In Modalità Demo:

  • ✅ Rileva le posizioni delle balene
  • ✅ Trasmette i segnali
  • ✅ Registra i dettagli degli ordini
  • ❌ Nessun ordine reale piazzato
  • ❌ Nessuna chiamata API all'exchange

Prevenzione dei Conflitti del Bot

Prima di piazzare un trade di copia:

  • Verifica se il bot target ha ordini in corso
  • Ignora l'ordine se il bot sta già operando
  • Previene più posizioni simultanee sullo stesso simbolo

Validazione della Posizione

Ogni ordine viene validato per:

  • Simbolo Valido: Deve esistere sul tuo exchange
  • Prezzo Corrente: Deve essere recuperabile (> 0)
  • Calcolo della Quantità: Deve soddisfare i minimi dell'exchange
  • Limiti di Leva: Entro il range consentito dall'exchange

🔧 Risoluzione dei Problemi

Problemi Comuni

❌ "Nessun indirizzo di balena configurato"

Problema: La lista tracking_addresses è vuota

Soluzione:

HyperLiquidWhaleTracker: tracking_addresses: - "0xIL_TUO_INDIRIZZO_BALENA_QUI"

📎 Related Topics