Rilevamento del Segnale di Picco - Guida per l’Utente

Panoramica

La funzionalità Rilevamento Spike monitora oltre 600 simboli di criptovalute per rilevare movimenti estremi e improvvisi dei prezzi. Genera due tipi di segnale:

SPIKE_PUMP: Spike rapido verso l’alto (≥ soglia %)
SPIKE_CRASH: Crollo rapido verso il basso (≥ soglia %)

Scopo Principale

Rilevamento Crisi & Cattura Opportunità

🚨 Delisting da exchange (dump improvvisi)
📰 Disastri di progetto (hack, rug pull, exploit)
⚖️ Azione regolatoria (cause SEC, divieti nazionali)
💥 Exploit maggiori (bug smart contract, hack bridge)
📈 Pump guidati da notizie (partnership, listing, scoperte)

Comportamento Predefinito

Modalità Solo Broadcast:

✅ Rileva tutti gli spike su oltre 600 simboli
✅ Trasmette segnali via Telegram, WhatsApp, Discord
❌ NON esegue ordini (sicuro per impostazione predefinita)

Per Abilitare il Trading:
Aggiungi "SPIKE_PUMP" e/o "SPIKE_CRASH" alla lista supported_volatility_action

Come Funziona

Logica di Rilevamento

Il sistema monitora il movimento del prezzo di ogni simbolo:

Confronta la candela corrente con la chiusura della candela precedente
Calcola la variazione percentuale
Verifica se la variazione supera la soglia
Controlla il colore della candela (verde per pump, rossa per crash)
Genera segnale se tutte le condizioni sono soddisfatte

Flusso del Segnale

┌─────────────────────────────────────────────────────────┐
│          Rilevamento Spike (Tutti i 600+ Simboli)       │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│     Calcola % variazione dalla chiusura candela prec.   │
└─────────────────────────────────────────────────────────┘
                            ↓
                ┌───────────┴───────────┐
                │                       │
        Pump ≥ soglia          Crash ≥ soglia
        Candela verde          Candela rossa
                │                       │
                ↓                       ↓
         SPIKE_PUMP               SPIKE_CRASH
                │                       │
                └───────────┬───────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│   Il segnale è in supported_volatility_action_broadcast?│
└─────────────────────────────────────────────────────────┘
                            ↓
                ┌───────────┴───────────┐
               NO                      SÌ
                │                       │
                ↓                       ↓
          Segnale Ignorato        Broadcast Avviso
                            (Telegram + WhatsApp + Discord)
                                        ↓
┌─────────────────────────────────────────────────────────┐
│     Il segnale è in supported_volatility_action?        │
└─────────────────────────────────────────────────────────┘
                            ↓
                ┌───────────┴───────────┐
               NO                      SÌ
                │                       │
                ↓                       ↓
        Solo Broadcast          Esegui Ordine + Broadcast
        (Modalità Sicura)       (Modalità Trading)

Parametri di Configurazione

Impostazioni Rilevamento Spike

signal_settings:
  # Abilita/disabilita il rilevamento spike globalmente
  enable_spike_detection: false
  
  # Soglia rilevamento pump (spike verso l’alto)
  spike_pump_threshold: 6.0     # Predefinito: 6% aumento minimo
  
  # Soglia rilevamento crash (spike verso il basso)
  spike_crash_threshold: 5.0    # Predefinito: 5% diminuzione minima

Impostazioni Controllo Broadcast

trading_settings:
  # Segnali che saranno TRASMESSI (Telegram/WhatsApp/Discord)
  # Questi segnali invieranno avvisi quando rilevati
  supported_volatility_action_broadcast:
    - "BUY"
    - "SELL"
    - "PUMP"
    - "CRASH"
    - "SPIKE_CRASH"   # ✅ Trasmetterà avvisi crash
    - "SPIKE_PUMP"    # ✅ Trasmetterà avvisi pump
  
  # Segnali che ESEGUIRANNO ORDINI (oltre alla trasmissione)
  # Solo i segnali in ENTRAMBE le liste saranno tradati
  supported_volatility_action:
    - "BUY"
    - "SELL"
    - "PUMP"
    - "CRASH"
    # Segnali SPIKE NON qui = solo broadcast, nessun trading
    # - "SPIKE_CRASH"  # ⚠️ Decommenta per abilitare ordine SHORT
    # - "SPIKE_PUMP"   # ⚠️ Decommenta per abilitare ordine LONG

Riferimento Parametri

Parametro	Tipo	Predefinito	Intervallo	Descrizione
`enable_spike_detection`	boolean	`false`	-	Interruttore principale per il monitoraggio spike
`spike_pump_threshold`	float	`6.0`	1.0-20.0	Aumento % minimo per attivare SPIKE_PUMP
`spike_crash_threshold`	float	`5.0`	1.0-20.0	Diminuzione % minima per attivare SPIKE_CRASH
`supported_volatility_action_broadcast`	array	Vedi sopra	-	Segnali che inviano avvisi (broadcast)
`supported_volatility_action`	array	Vedi sopra	-	Segnali che eseguono ordini (trade)

Comprendere le Due Liste

Concetto Chiave:

supported_volatility_action_broadcast = Cosa viene AVVISATO
supported_volatility_action = Cosa viene TRADATO

Il rispettivo segnale deve essere nella lista BROADCAST per inviare avvisi
Il segnale deve essere in ENTRAMBE le liste per eseguire ordini

Modalità di Configurazione

Modalità 1: Solo Broadcast (Predefinita - Sicura)

enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0

# Trasmette avvisi spike
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"   # ✅ Trasmette avvisi crash
  - "SPIKE_PUMP"    # ✅ Trasmette avvisi pump

# NON tradare spike
supported_volatility_action:
  - "BUY"
  - "SELL"
  # Segnali SPIKE NON nella lista = nessun trading

Risultato:

✅ Monitora tutti i 600+ simboli
✅ Trasmette avvisi SPIKE_PUMP e SPIKE_CRASH
❌ Nessun ordine eseguito su segnali spike
🎯 Perfetto per il monitoraggio delle crisi

Modalità 2: Trading Pump Abilitato

enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0

# Trasmette entrambi i tipi
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"   # ✅ Trasmette avvisi crash
  - "SPIKE_PUMP"    # ✅ Trasmette avvisi pump

# Tradare solo pump
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"    # ✅ Esegue ordini LONG su pump
  # SPIKE_CRASH rimane solo broadcast

Risultato:

✅ Trasmette tutti gli avvisi spike (pump e crash)
✅ Esegue ordini LONG su segnali SPIKE_PUMP
❌ Nessun ordine su SPIKE_CRASH (solo broadcast)
🎯 Ideale per trading momentum/breakout

Modalità 3: Trading Crash Abilitato

enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0

# Trasmette entrambi i tipi
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"   # ✅ Trasmette avvisi crash
  - "SPIKE_PUMP"    # ✅ Trasmette avvisi pump

# Tradare solo crash
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"   # ✅ Esegue ordini SHORT su crash
  # SPIKE_PUMP rimane solo broadcast

Risultato:

✅ Trasmette tutti gli avvisi spike (pump e crash)
✅ Esegue ordini SHORT su segnali SPIKE_CRASH
❌ Nessun ordine su SPIKE_PUMP (solo broadcast)
🎯 Ideale per trading crash/delistings

Modalità 4: Trading Completo Abilitato (Entrambi)

enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0

# Trasmette entrambi i tipi
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"   # ✅ Trasmette avvisi crash
  - "SPIKE_PUMP"    # ✅ Trasmette avvisi pump

# Tradare entrambi i tipi
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"    # ✅ Esegue ordini LONG su pump
  - "SPIKE_CRASH"   # ✅ Esegue ordini SHORT su crash

Risultato:

✅ Trasmette tutti gli avvisi spike
✅ Esegue ordini LONG su pump
✅ Esegue ordini SHORT su crash
⚠️ Modalità a rischio più alto
🎯 Solo per trader esperti

Modalità 5: Nessun Broadcast, Nessun Trading (Disabilitato)

enable_spike_detection: false
# OPPURE
enable_spike_detection: true

# Non trasmettere spike
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  # Segnali SPIKE NON nella lista = nessun avviso

# Non tradare spike
supported_volatility_action:
  - "BUY"
  - "SELL"
  # Segnali SPIKE NON nella lista = nessun trading

Risultato:

❌ Nessun avviso spike inviato
❌ Nessun trading spike
🎯 Usa quando il rilevamento spike non è necessario

Tipi di Segnale

SPIKE_PUMP (Segnale Pump)

Si attiva quando:

Il prezzo aumenta di ≥ spike_pump_threshold (es. 6%)
La candela recente è verde (chiusura > apertura)
Movimento dalla chiusura candela precedente alla chiusura corrente

Esempio di Rilevamento:

Chiusura candela precedente: $100,00
Candela corrente:
  Apertura:  $101,00
  Chiusura: $106,50 (candela VERDE)
  
Calcolo:
  Variazione: ($106,50 - $100,00) / $100,00 × 100 = +6,5%
  Soglia: 6,0%
  
Risultato: ✅ SPIKE_PUMP rilevato (+6,5% ≥ 6,0%)

Cosa indica tipicamente:

📰 Annuncio di notizie importanti (partnership, listing)
🚀 Breakout da consolidamento
💰 Grande ordine di acquisto / accumulazione whale
📈 Ondata di acquisto FOMO
🎯 Breakout tecnico confermato

Avviso Broadcast:

🚀 SPIKE_PUMP RILEVATO
Simbolo: TOKEN/USDT
Variazione: +6,5%
Prezzo: $100,00 → $106,50
Fiducia: 88%
Ora: 2024-11-02 14:35:00 UTC

Azione di Trading (se abilitata):

Esegue ordine LONG (acquisto)
Ingresso: Ordine di mercato al prezzo corrente
Uscita: Gestita dal tuo sistema SL/TP intelligente
Dimensione posizione: Come configurato nelle impostazioni di trading

SPIKE_CRASH (Segnale Crash)

Si attiva quando:

Il prezzo diminuisce di ≥ spike_crash_threshold (es. 5%)
La candela recente è rossa (chiusura < apertura)
Movimento dalla chiusura candela precedente alla chiusura corrente

Esempio di Rilevamento:

Chiusura candela precedente: $100,00
Candela corrente:
  Apertura:  $99,00
  Chiusura: $94,50 (candela ROSSA)
  
Calcolo:
  Variazione: ($94,50 - $100,00) / $100,00 × 100 = -5,5%
  Soglia: -5,0%
  
Risultato: ✅ SPIKE_CRASH rilevato (-5,5% ≤ -5,0%)

Cosa indica tipicamente:

🚨 Annuncio di delisting da exchange
💥 Hack o exploit di progetto
⚖️ Azione regolatoria (causa SEC)
😱 FUD maggiore / notizie negative
🏃 Dump whale / exit scam
⚠️ Flash crash / cascata di liquidazioni

Avviso Broadcast:

🚨 SPIKE_CRASH RILEVATO
Simbolo: TOKEN/USDT
Variazione: -5,5%
Prezzo: $100,00 → $94,50
Fiducia: 83%
Ora: 2024-11-02 14:35:00 UTC
⚠️ CONTROLLA ANNUNCI EXCHANGE

Azione di Trading (se abilitata):

Esegue ordine SHORT (vendita/short)
Ingresso: Ordine di mercato al prezzo corrente
Uscita: Gestita dal tuo sistema SL/TP intelligente
Dimensione posizione: Come configurato nelle impostazioni di trading

Impostazioni Consigliate per Timeframe

Tabella di Riferimento Rapido

Timeframe	Soglia Pump	Soglia Crash	Segnali/Giorno Attesi	Rischio	Caso d’Uso
1m	2,5-3,5%	2,5-3,5%	40-80	Molto Alto	Scalping (alto rumore)
3m	3,0-4,0%	3,0-4,0%	25-50	Alto	Scalping veloce
5m	3,5-5,0%	3,5-5,0%	15-35	Medio-Alto	⭐ Scalping (consigliato)
15m	4,5-6,0%	4,5-6,0%	8-20	Medio	Trading intraday
30m	5,0-7,0%	5,0-7,0%	5-12	Medio	Swing trading
1h	6,0-8,0%	6,0-8,0%	3-8	Basso-Medio	⭐ Monitoraggio (consigliato)
4h	8,0-12,0%	8,0-12,0%	1-4	Basso	Position trading
1d	10,0-15,0%	10,0-15,0%	0-2	Molto Basso	Solo eventi maggiori

Impostazioni Ottimizzate per Caso d’Uso

Caso d’Uso 1: Monitoraggio Crisi (600+ Simboli)

Obiettivo: Rilevare delisting, hack, crash maggiori

enable_spike_detection: true
spike_pump_threshold: 8.0     # Più alto per ridurre rumore
spike_crash_threshold: 7.0    # Focus su crash maggiori

# Trasmettere avvisi spike
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

# Non tradare spike - solo broadcast
supported_volatility_action:
  - "BUY"
  - "SELL"
  # Segnali spike NON nella lista

# Timeframe consigliato: 5m o 15m

Atteso:

8-15 avvisi al giorno su 600 simboli
Segnali crisi di alta qualità
Tasso falsi positivi basso (~20%)
Tempo per indagare e rispondere

Caso d’Uso 2: Scalping (Alta Frequenza)

Obiettivo: Catturare rapidi movimenti momentum per profitto

enable_spike_detection: true
spike_pump_threshold: 3.5     # Più basso per più segnali
spike_crash_threshold: 3.5

# Trasmettere entrambi
supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

# Tradare entrambe le direzioni
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"    # Tradare pump
  - "SPIKE_CRASH"   # Tradare crash

# Timeframe consigliato: 5m

Atteso:

20-40 avvisi al giorno
10-20 trade al giorno
Tasso falsi positivi più alto (~30-40%)
Richiede monitoraggio attivo
Buono solo per simboli ad alta liquidità

Caso d’Uso 3: Swing Trading (Selettivo)

Obiettivo: Catturare movimenti maggiori, tenere per ore/giorni

enable_spike_detection: true
spike_pump_threshold: 6.0     # Soglia moderata
spike_crash_threshold: 5.5

# Trasmettere entrambi
supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

# Tradare solo pump (cavalcare momentum)
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"    # Tradare pump
  # Nessun SPIKE_CRASH (non shortare)

# Timeframe consigliato: 15m o 1h

Atteso:

8-15 avvisi al giorno
3-8 trade al giorno
Focus su momentum verso l’alto
Lascia che SL/TP intelligente gestisca uscite
Buon win rate (~60-70%)

Caso d’Uso 4: Trading Notizie (Breakout)

Obiettivo: Catturare breakout guidati da notizie rapidamente

enable_spike_detection: true
spike_pump_threshold: 5.0     # Cattura breakout precoci
spike_crash_threshold: 8.0    # Ignora crash (focus su pump)

# Solo trasmettere pump
supported_volatility_action_broadcast:
  - "SPIKE_PUMP"    # Solo avviso su pump

# Solo tradare pump
supported_volatility_action:
  - "SPIKE_PUMP"    # Solo tradare pump

# Timeframe consigliato: 3m o 5m

Atteso:

Focus solo su spike verso l’alto
Ingresso rapido su breakout
Ignora crash (riduci rischio)
5-15 trade al giorno

Ottimizzazione per Asset Specifici

Asset Alta Volatilità (Maggioranza Altcoin)

# Più conservativo (riduci rumore)
spike_pump_threshold: 7.0
spike_crash_threshold: 6.0

Asset: Maggioranza altcoin, meme coin, token low-cap

Asset Media Volatilità (Principali Altcoin)

# Approccio bilanciato
spike_pump_threshold: 5.0
spike_crash_threshold: 5.0

Asset: ETH, BNB, SOL, ADA, XRP, MATIC, ecc.

Asset Bassa Volatilità (BTC, Stablecoin)

# Più sensibile (cattura movimenti minori)
spike_pump_threshold: 3.0
spike_crash_threshold: 3.0

Asset: BTC, token large-cap

Scenari di Crisi Reali

Scenario 1: Delisting da Exchange

Evento: Binance annuncia delisting di TOKEN_X effettivo in 7 giorni

Cronologia:

14:00:00 - Annuncio Binance pubblicato
14:00:30 - Notizia si diffonde su Twitter/Telegram
14:01:00 - Inizia vendita panico
14:02:00 - Prezzo scende da $1,50 a $1,28 (-14,7%)
14:02:05 - 🚨 SPIKE_CRASH rilevato
14:02:06 - Avviso trasmesso: Telegram + WhatsApp + Discord
14:02:30 - Verifichi annuncio su Binance
14:03:00 - Uscita manuale (se in posizione)
14:10:00 - Prezzo continua a $0,95 (-36,7%)

Risultato: Rilevamento precoce ha permesso uscita a -15% vs tenere a -37%

Risposta Solo Broadcast:

🚨 SPIKE_CRASH: TOKEN_X/USDT
Variazione: -14,7%
Prezzo: $1,50 → $1,28

Azione: Revisione manuale richiesta
1. Controlla annunci Binance
2. Verifica delisting
3. Esci dalla posizione se confermato

Risposta Trading Abilitato (se SPIKE_CRASH in entrambe le liste):

🚨 SPIKE_CRASH: TOKEN_X/USDT
Variazione: -14,7%
Prezzo: $1,50 → $1,28

✅ Ordine SHORT eseguito a $1,28
Sistema SL/TP intelligente attivo
Obiettivo: ulteriore movimento -10% a -20%

Scenario 2: Exploit/Hack di Progetto

Evento: Bridge protocollo DeFi hackerato per $100M

Cronologia:

02:30:00 - Exploit eseguito on-chain
02:31:00 - Hacker dumpa token progetto su DEX
02:32:00 - Prezzo crolla da $5,00 a $3,25 (-35%)
02:32:05 - 🚨 SPIKE_CRASH rilevato
02:32:06 - Avviso ti sveglia (2:32 AM)
02:33:00 - Controlla Twitter - “Bridge hackerato” in tendenza
02:34:00 - Uscita emergenza (se in possesso)
02:40:00 - Prezzo continua a $1,20 (-76%)

Risultato: Azione entro 2 minuti, uscito a -35% vs -76%

Lezione Chiave:

Crash estremi (>20%) sono quasi sempre crisi reali
Orari insoliti (2 AM) = probabile exploit
Agire velocemente, indagare dopo
Rilevamento SPIKE_CRASH è stato salvavita

Scenario 3: Pump Notizia Maggiore

Evento: Annuncio partnership importante

Cronologia:

10:00:00 - Azienda twitta partnership con Fortune 500
10:00:30 - Notizia diventa virale
10:01:00 - Inizia ondata acquisto FOMO
10:02:00 - Prezzo pompa da $0,50 a $0,58 (+16%)
10:02:05 - 🚀 SPIKE_PUMP rilevato
10:02:06 - Avviso trasmesso
10:02:30 - Verifica notizia (annuncio ufficiale)
10:03:00 - Ingresso posizione (se trading abilitato)
10:15:00 - Prezzo raggiunge picco a $0,72 (+44%)
10:30:00 - SL/TP intelligente traccia ed esce a $0,68 (+36%)

Risultato: Catturato momentum precoce, uscita intelligente ha preservato guadagni

Risposta Solo Broadcast:

🚀 SPIKE_PUMP: TOKEN_Y/USDT
Variazione: +16%
Prezzo: $0,50 → $0,58

Azione: Verifica notizia
- Controlla canali ufficiali
- Considera ingresso se notizia confermata
- Imposta stop loss sotto ingresso

Risposta Trading Abilitato:

🚀 SPIKE_PUMP: TOKEN_Y/USDT
Variazione: +16%
Prezzo: $0,50 → $0,58

✅ Ordine LONG eseguito a $0,58
SL/TP intelligente attivo
Stop trailing attivato
Monitoraggio per condizioni uscita

Scenario 4: Falso Allarme - Recupero Flash Crash

Evento: Evento liquidità causa spike temporaneo, recupero immediato

Cronologia:

10:30:00 - Grande ordine vendita colpisce order book sottile
10:31:00 - Prezzo scende da $10,00 a $8,80 (-12%)
10:31:05 - 🚨 SPIKE_CRASH rilevato
10:31:06 - Avviso trasmesso
10:32:00 - Controlla notizie: Nessuna trovata
10:33:00 - Prezzo in recupero: $8,80 → $9,40
10:35:00 - Completamente recuperato: $9,40 → $10,20 (+2%)

Risultato: Avviso ricevuto, indagine ha mostrato falso allarme, nessuna azione

Come Identificare Falsi Allarmi:

✅ Nessuna notizia - Twitter, Telegram, annunci exchange silenziosi
✅ Recupero rapido - Prezzo rimbalza entro 3-5 minuti
✅ Evento isolato - Solo un exchange colpito
✅ Pattern volume - Singolo grande ordine, non vendita sostenuta

Protocollo di Risposta:

SPIKE rilevato
    ↓
Controlla notizie (30 secondi)
    ↓
Notizie trovate?
    ↓
SÌ → Agisci (esci/entra)
NO → Aspetta 2-3 candele
    ↓
Ancora in movimento?
    ↓
SÌ → Agisci (probabilmente reale)
NO → Falso allarme, ignora

Trading vs Broadcasting

Comprendere il Sistema a Due Liste

Il tuo bot utilizza due liste di controllo separate:

Lista 1: Controllo Broadcast

supported_volatility_action_broadcast

Controlla quali segnali inviano avvisi
Deve includere il segnale per inviare qualsiasi avviso
Può includere segnali solo broadcast (es. SPIKE_CRASH, SPIKE_PUMP)

Lista 2: Controllo Trading

supported_volatility_action

Controlla quali segnali eseguono ordini
Deve includere il segnale per qualsiasi trading
Tipicamente sottoinsieme della lista broadcast

Flusso Elaborazione Segnale

1. Segnale Rilevato (es. SPIKE_CRASH)
        ↓
2. Controllo: Il segnale è in supported_volatility_action_broadcast?
        ↓
    ┌───┴───┐
   NO      SÌ
    ↓       ↓
 Salta   Trasmetti Avviso
        (Telegram/WhatsApp/Discord)
            ↓
3. Controllo: Il segnale è in supported_volatility_action?
        ↓
    ┌───┴───┐
   NO      SÌ
    ↓       ↓
 Fine   Esegui Ordine

Esempi di Configurazione

Esempio 1: Monitora Tutto, Non Tradare Nulla

# Ricevi avvisi per tutti i segnali, non eseguire ordini

supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "PUMP"
  - "CRASH"
  - "SPIKE_CRASH"  # ✅ Avviserà
  - "SPIKE_PUMP"   # ✅ Avviserà

supported_volatility_action:
  # Lista vuota o minima = nessun trading
  []

Risultato:

✅ Avvisi per tutto
❌ Nessun ordine eseguito
🎯 Modalità puro monitoraggio

Esempio 2: Monitora Tutto, Tradare Solo Segnali Tradizionali

# Ricevi avvisi per tutti i segnali, ma tradare solo BUY/SELL

supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "PUMP"
  - "CRASH"
  - "SPIKE_CRASH"  # ✅ Avviserà
  - "SPIKE_PUMP"   # ✅ Avviserà

supported_volatility_action:
  - "BUY"          # ✅ Avviserà E tradarà
  - "SELL"         # ✅ Avviserà E tradarà
  # Segnali spike NON qui = solo avviso

Risultato:

✅ Avvisi per tutti i segnali
✅ Trading solo su BUY/SELL
❌ Nessun trading su spike (solo avvisi)
🎯 Approccio conservativo

Esempio 3: Monitora e Tradare Solo Crash

# Avvisa su entrambi, ma tradare solo crash

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"  # ✅ Avviserà
  - "SPIKE_PUMP"   # ✅ Avviserà

supported_volatility_action:
  - "SPIKE_CRASH"  # ✅ Avviserà E tradarà
  # SPIKE_PUMP non qui = solo avviso

Risultato:

✅ Avvisi per pump e crash
✅ Trading solo su crash
❌ Nessun trading su pump
🎯 Strategia trading crash

Esempio 4: Modalità Trading Completo

# Avvisa e tradare su tutto

supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "PUMP"
  - "CRASH"
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

supported_volatility_action:
  - "BUY"
  - "SELL"
  - "PUMP"
  - "CRASH"
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

Risultato:

✅ Avvisi per tutto
✅ Trading su tutto
⚠️ Rischio più alto
🎯 Approccio aggressivo

Perché Questo Design?

Separazione delle Responsabilità:

Monitoraggio ≠ Trading
Potresti voler sapere TUTTI gli spike (600 simboli)
Ma tradare solo in CONDIZIONI SELEZIONATE
Broadcast ti tiene informato
Lista trading controlla il rischio

Esempio Caso d’Uso:

Monitoraggio 600 simboli:
- 590 altcoin low-cap, alto rischio → Solo broadcast
- 10 monete principali alta liquidità → Trading abilitato

Configurazione:
supported_volatility_action_broadcast: [tutti i segnali inclusi SPIKE]
supported_volatility_action: [solo per 10 monete principali]

Risultato:
- Ricevi avvisi per tutti i 600 (rilevamento crisi)
- Tradare solo 10 (gestione rischio)

Migliori Pratiche

1. Inizia con Solo Broadcast

# Settimana 1-4: Impara i pattern
enable_spike_detection: true

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

supported_volatility_action:
  - "BUY"
  - "SELL"
  # Nessun segnale SPIKE = solo broadcast

# Traccia:
- Quanti avvisi al giorno?
- Quanti erano crisi reali?
- Quanti erano falsi allarmi?
- Quali erano i risultati?

Benefici:

Rischio trading zero
Impara qualità segnale
Comprendi tasso falsi positivi
Costruisci fiducia

2. Abilita Trading Gradualmente

# Mese 2: Abilita prima una direzione
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"   # Inizia con pump (meno rischioso)

# Mese 3+: Aggiungi crash se desiderato
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"
  - "SPIKE_CRASH"  # Aggiungi dopo esperienza

3. Regola Soglie per Condizioni di Mercato

Periodo Alta Volatilità (es. mercato toro):

spike_pump_threshold: 8.0   # Aumenta per ridurre rumore
spike_crash_threshold: 7.0

Periodo Bassa Volatilità (es. consolidamento mercato orso):

spike_pump_threshold: 4.0   # Diminuisci per catturare movimenti
spike_crash_threshold: 4.0

Volatilità Estrema (es. evento notizie maggiore):

spike_pump_threshold: 10.0  # Molto più alto per evitare caos
spike_crash_threshold: 10.0

4. Monitora Metriche Qualità Avvisi

Traccia settimanalmente:

Avvisi Totali: 150
Crisi Reali: 8
Falsi Allarmi: 45
Eventi Persi: 2

Tasso Falsi Positivi: 30%
Tasso Rilevamento: 80%

Se troppi falsi allarmi:
  → Aumenta soglie di 0,5-1,0%
  
Se manchi eventi reali:
  → Diminuisci soglie di 0,5-1,0%

5. Usa Timeframe Appropriati

Per Monitoraggio Crisi:

Usa candele 5m o 15m
Timeframe più alti = segnali più puliti
Tasso falsi positivi più basso

Per Scalping:

Usa candele 3m o 5m
Rilevamento più veloce
Accetta tasso falsi positivi più alto

Per Swing Trading:

Usa candele 15m o 1h
Migliore qualità segnale
Meno ma più forti segnali

6. Combina con Altri Segnali

Non affidarti solo a segnali spike:

Esempio Strategia di Conferma:

SPIKE_PUMP rilevato
    +
RSI < 70 (non ipercomprato)
    +
Volume > 2× media
    +
Exchange maggiore (Binance)
    =
ALTA FIDUCIA → Considera ingresso

SPIKE_PUMP rilevato
    +
RSI > 80 (ipercomprato)
    =
BASSA FIDUCIA → Solo avviso, non tradare

7. Comprendi Requisiti Colore Candela

Logica Attuale:

SPIKE_PUMP richiede candela verde (chiusura > apertura)
SPIKE_CRASH richiede candela rossa (chiusura < apertura)

Perché: Conferma direzione e controllo acquirenti/venditori

Ciò significa:

Un movimento +10% in candela rossa non attiverà SPIKE_PUMP
Un movimento -10% in candela verde non attiverà SPIKE_CRASH

Beneficio: Riduce falsi segnali da spike wick

Scenari Comuni

Scenario 1: Troppi Avvisi (Affaticamento Avvisi)

Problema: 50+ avvisi al giorno, travolgente

Soluzioni:

Aumenta soglie:

# Prima
spike_pump_threshold: 4.0
spike_crash_threshold: 4.0

# Dopo
spike_pump_threshold: 6.5
spike_crash_threshold: 6.0

Passa a timeframe più lungo:

3m → 5m
5m → 15m

Filtra simboli:

Rimuovi simboli basso volume
Rimuovi meme coin altamente volatili
Focus su top 100-200 per capitalizzazione

Rimuovi temporaneamente dalla lista broadcast:

supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  # Rimuovi segnali SPIKE temporaneamente

Scenario 2: Mancano Eventi Importanti

Problema: Crash reali accadono ma nessun avviso

Possibili Cause:

Soglia troppo alta
Rilevamento spike disabilitato
Segnale non nella lista broadcast
Discrepanza colore candela
Problema feed dati

Soluzioni:

Abbassa soglie:

spike_pump_threshold: 8.0 → 6.0
spike_crash_threshold: 7.0 → 5.0

Verifica abilitato:

enable_spike_detection: true  # Deve essere true

Verifica nella lista broadcast:

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"  # Deve essere nella lista
  - "SPIKE_PUMP"   # Deve essere nella lista

Controlla log bot per errori

Scenario 3: Trade Eseguiti su Falsi Allarmi

Problema: SPIKE_CRASH attivato, ordine eseguito, poi prezzo recuperato

Soluzioni:

Rimuovi dalla lista trading:

# Interrompi trading su spike temporaneamente
supported_volatility_action:
  - "BUY"
  - "SELL"
  # Rimuovi SPIKE_CRASH e SPIKE_PUMP

# Ma mantieni nella lista broadcast per avvisi
supported_volatility_action_broadcast:
  - "SPIKE_CRASH"  # Ricevi ancora avvisi
  - "SPIKE_PUMP"   # Ricevi ancora avvisi

Aumenta soglie (segnali qualità più alta):

# Più conservativo = meno falsi allarmi
spike_pump_threshold: 6.0 → 8.0
spike_crash_threshold: 5.0 → 7.0

Fidati del tuo SL/TP intelligente:

Anche su falsi allarmi, il tuo stop-loss intelligente dovrebbe limitare danni
Rivedi impostazioni SL/TP se perdite eccessive

Scenario 4: Vuoi Avvisi Ma Non Trading

Problema: Vuoi sapere degli spike ma non vuoi ordini automatici

Soluzione: Caso d’uso perfetto per il sistema a due liste

# Ricevi avvisi per spike
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"  # ✅ Avviserà
  - "SPIKE_PUMP"   # ✅ Avviserà

# Ma non tradarli
supported_volatility_action:
  - "BUY"
  - "SELL"
  # Segnali SPIKE NON qui = nessun trading

Risultato:

✅ Ricevi avvisi per tutti gli spike
✅ Puoi rivedere manualmente e decidere
❌ Nessun ordine automatico su spike
🎯 Approccio sicuro e informato

Scenario 5: Vuoi Tradare Solo in Orari Specifici

Problema: Non vuoi trade spike alle 3 AM

Soluzione:

Usa i filtri di orario esistenti del bot (se disponibili):

trading_hours:
  enabled: true
  start_hour: 8    # 8 AM
  end_hour: 22     # 10 PM
  timezone: "UTC"

# Segnali spike fuori orario:
# - Trasmettono comunque avvisi
# - Non eseguono ordini (filtro orario blocca)

Alternativa: Rimuovi dalla lista trading durante ore sonno:

Prima di dormire: Rimuovi segnali SPIKE da supported_volatility_action
Al risveglio: Aggiungili se desiderato

Risoluzione dei Problemi

Problema: Nessun Segnale Generato

Checklist:

[ ] enable_spike_detection: true
[ ] Soglie non troppo alte (prova 5,0% temporaneamente per test)
[ ] Sufficiente movimento prezzo nel mercato
[ ] Almeno 2 candele di dati disponibili
[ ] WebSocket/feed dati connesso

Passi Debug:

Controlla log bot per attività rilevamento spike

Abbassa temporaneamente soglie:

spike_pump_threshold: 2.0  # Molto sensibile per test
spike_crash_threshold: 2.0

Verifica flusso dati (controlla aggiornamenti candele recenti nei log)

Test con simbolo volatile noto

Problema: Segnali Generati Ma Nessun Broadcast

Possibili Cause:

Segnale non nella lista supported_volatility_action_broadcast
Canali avviso non configurati
Chiavi API mancanti
Problemi connettività rete
Cooldown segnale attivo

Soluzioni:

Verifica segnale nella lista broadcast:

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"  # Deve essere presente
  - "SPIKE_PUMP"   # Deve essere presente

Verifica configurazione avviso:

alert_settings:
  enable_telegram: true
  telegram_bot_token: "tuo_token"
  telegram_chat_id: "tuo_chat_id"
  
  enable_whatsapp: true
  whatsapp_config: { ... }
  
  enable_discord: true
  discord_webhook_url: "tuo_webhook"

Controlla log per errori avviso

Controlla se simbolo in periodo cooldown (30 minuti predefinito)

Problema: Ordini Non Eseguiti Nonostante Segnale nella Lista

Problema: SPIKE_PUMP in entrambe le liste ma nessun ordine eseguito

Checklist:

[ ] Segnale nella lista supported_volatility_action_broadcast
[ ] Segnale nella lista supported_volatility_action
[ ] Trading non in pausa globale
[ ] Saldo sufficiente in conto
[ ] Permessi API exchange (trading abilitato)
[ ] Simbolo non filtrato da altre impostazioni
[ ] Limiti posizione non superati

Passi Debug:

Verifica segnale in ENTRAMBE le liste:

supported_volatility_action_broadcast:
  - "SPIKE_PUMP"  # ✅ Deve essere qui

supported_volatility_action:
  - "SPIKE_PUMP"  # ✅ E qui

Controlla log trading per tentativi ordine

Verifica permessi API su exchange

Controlla saldo conto

Rivedi altri filtri trading (volume, limiti rischio, ecc.)

Problema: Ricevi Avvisi per Segnali Sbagliati

Problema: Ricevi avvisi PUMP/CRASH quando vuoi solo segnali SPIKE

Soluzione: Controlla esattamente cosa viene trasmesso

# Trasmetti solo segnali spike
supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"
  # Rimuovi altri segnali che non vuoi avvisi per

# Tradare altri segnali senza avvisi
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "PUMP"
  - "CRASH"
  # Questi tradaranno ma non trasmetteranno (non nella lista broadcast)

Problema: Fiducia Sempre lo Stesso Valore

Spiegazione: È per design

La fiducia è calcolata in base a quanto lo spike supera la soglia:

Formula:

Fiducia base: 80%
Bonus: Fino a +30% basato su forza spike
Massimo: 100%

Esempi:

Spike 6%, soglia 6% → 80% fiducia (appena soddisfatta soglia)
Spike 9%, soglia 6% → 95% fiducia (50% sopra soglia)
Spike 12%, soglia 6% → 100% fiducia (100% sopra soglia)

Sta funzionando correttamente. Spike più forti ottengono fiducia più alta.

Esempi Configurazione Avanzata

Esempio 1: Ultra-Conservativo (Solo Rilevamento Crisi)

# Obiettivo: Rilevare solo pump/crash maggiori (delisting, hack)
# Trading: Nessuno (solo avvisi)

signal_settings:
  enable_spike_detection: true
  spike_pump_threshold: 12.0   # Soglia molto alta
  spike_crash_threshold: 10.0  # Soglia molto alta

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

supported_volatility_action:
  - "BUY"
  - "SELL"
  # Nessun segnale SPIKE

# Risultati attesi:
# - 2-8 avvisi al giorno (solo eventi estremi)
# - Tasso falsi positivi molto basso (~10%)
# - Potrebbe mancare alcuni eventi medio-gravi
# - Perfetto per protezione portafoglio con rumore minimo

Esempio 2: Scalping Aggressivo (Alta Frequenza)

# Obiettivo: Catturare molti movimenti rapidi per scalping
# Trading: Abilitato su entrambe le direzioni

signal_settings:
  enable_spike_detection: true
  spike_pump_threshold: 3.5    # Sensibile
  spike_crash_threshold: 3.5   # Sensibile

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"
  - "SPIKE_CRASH"

# Risultati attesi:
# - 30-60 avvisi al giorno
# - 15-30 trade al giorno
# - Tasso falsi positivi più alto (~40%)
# - Richiede monitoraggio attivo
# - SL/TP intelligente cruciale per gestione rischio

Esempio 3: Momentum Solo Long (Mercato Toro)

# Obiettivo: Cavalcare pump momentum, ignorare crash
# Trading: Solo SPIKE_PUMP

signal_settings:
  enable_spike_detection: true
  spike_pump_threshold: 5.0    # Moderato
  spike_crash_threshold: 7.0   # Avvisa comunque su crash

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"  # Avvisa su crash
  - "SPIKE_PUMP"   # Avvisa su pump

supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"   # Tradare solo pump
  # Nessun SPIKE_CRASH

# Risultati attesi:
# - Ricevi avvisi per pump e crash
# - Tradare solo pump (posizioni long)
# - Evita rischio short
# - 8-15 avvisi al giorno
# - 3-8 trade al giorno (solo long)

Esempio 4: Trader Crash (Solo Short)

# Obiettivo: Tradare crash/delistings (short)
# Trading: Solo SPIKE_CRASH

signal_settings:
  enable_spike_detection: true
  spike_pump_threshold: 8.0    # Alto (solo avviso)
  spike_crash_threshold: 5.0   # Sensibile a crash

supported_volatility_action_broadcast:
  - "SPIKE_CRASH"  # Avvisa su crash
  - "SPIKE_PUMP"   # Avvisa su pump

supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"  # Tradare solo crash
  # Nessun SPIKE_PUMP

# Risultati attesi:
# - Ricevi avvisi per pump e crash
# - Tradare solo crash (posizioni short)
# - Cattura delisting, hack, cattive notizie
# - 5-12 avvisi al giorno
# - 2-5 trade al giorno (solo short)
# - Alto rischio (shortare può essere pericoloso)

Esempio 5: Broadcast Selettivo

# Obiettivo: Trasmettere solo segnali spike, tradare tutto

signal_settings:
  enable_spike_detection: true
  spike_pump_threshold: 6.0
  spike_crash_threshold: 6.0

# Trasmettere solo spike
supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"
  # Altri segnali non qui = nessun avviso

# Tradare tutto
supported_volatility_action:
  - "BUY"
  - "SELL"
  - "PUMP"
  - "CRASH"
  - "SPIKE_PUMP"
  - "SPIKE_CRASH"

# Risultato:
# - Ricevi avvisi solo per segnali spike
# - Tutti i segnali (inclusi BUY/SELL/PUMP/CRASH) tradano ancora
# - Riduce rumore avvisi
# - Focus su eventi crisi

Guida Rapida all’Avvio

Passo 1: Abilita Rilevamento (Solo Broadcast)

# config.yaml
signal_settings:
  enable_spike_detection: true
  spike_pump_threshold: 7.0
  spike_crash_threshold: 7.0

# Trasmetti segnali spike
supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

# Non tradare ancora segnali spike
supported_volatility_action:
  - "BUY"
  - "SELL"
  # Nessun segnale SPIKE

Avvia bot e monitora per 1-2 settimane:

Quanti avvisi?
Qual è il tasso falsi positivi?
Gli eventi reali vengono catturati?

Passo 2: Regola Soglie

Basato sui risultati Settimana 1-2:

Troppi avvisi (>30/giorno)?

spike_pump_threshold: 7.0 → 9.0
spike_crash_threshold: 7.0 → 8.0

Pochi avvisi (<5/giorno)?

spike_pump_threshold: 7.0 → 5.0
spike_crash_threshold: 7.0 → 5.0

Passo 3: Abilita Trading (Opzionale)

Dopo essere a tuo agio con qualità avvisi:

supported_volatility_action_broadcast:
  - "BUY"
  - "SELL"
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"   # ← Aggiungi per abilitare trading
  # Lascia SPIKE_CRASH fuori per ora

Passo 4: Monitora Prestazioni Trading

Traccia per 2-4 settimane:

- Tasso vincita
- P&L medio per trade
- Max drawdown
- Tasso esecuzione falsi segnali

Se performa bene, considera aggiungere SPIKE_CRASH.

Passo 5: Ottimizza e Scala

# Regola fine basata su risultati
spike_pump_threshold: X  # Il tuo valore ottimizzato
spike_crash_threshold: Y  # Il tuo valore ottimizzato

# Abilita entrambe le direzioni se desiderato
supported_volatility_action_broadcast:
  - "SPIKE_CRASH"
  - "SPIKE_PUMP"

supported_volatility_action:
  - "BUY"
  - "SELL"
  - "SPIKE_PUMP"
  - "SPIKE_CRASH"