📌 Cosa fa l'indicatore

MarketStructureOscSignals è uno strumento di segnalazione basato esclusivamente sull'azione del prezzo.

Esso:

1. Rileva massimi e minimi oscillanti utilizzando un lookback a sinistra/destra.
2. Monitora se questi oscillamenti stanno formando:
3. • Massimi più alti + Minimi più alti → struttura rialzista
   • Massimi più bassi + Minimi più bassi → struttura ribassista
3. Quando la struttura cambia:
4. • Da ribassista → rialzista → traccia un segnale BUY
   • Da rialzista → ribassista → traccia un segnale SELL

Quindi ogni segnale rappresenta un vero cambiamento nella struttura di mercato, non solo un incrocio di medie mobili.

⚙️ Input e come impostarli

1. Swing Left / Swing Right

Questi controllano quanto “rigido” è un massimo/minimo oscillante.

• Swing Left (default 2)
  Numero di barre a sinistra dell'oscillazione che devono avere massimi più bassi (per un massimo oscillante) o minimi più alti (per un minimo oscillante).
• Swing Right (default 2)
  Numero di barre a destra che devono confermare l'oscillazione.

Come usarli:

• Valori piccoli (1–2):
• • Più oscillazioni, più segnali
  • Funziona bene su timeframe più alti (H1, H4, D1)
• Valori più grandi (3–4+):
• • Solo grandi inversioni strutturali
  • Meno segnali ma più forti
  • Buono su timeframe più bassi per evitare rumore

2. Min Bars Between Signals

Numero minimo di barre che devono passare tra due segnali.

• Evita accumuli di frecce ad ogni piccolo ritracciamento.
• Esempio:
• • Impostato a 3 → almeno 3 barre tra un segnale e l'altro.
  • Su grafici molto veloci (M1–M5) potresti voler impostare 5–10.
  • Su H1 o superiore, 2–3 di solito è sufficiente.

3. Arrow Offset (pips)

Quanto lontano la freccia e l'etichetta sono posizionate dalla candela (in pips).

• Per il Forex:
• • 5–10 pips di solito hanno un aspetto buono.
• Per gli indici (US500, US100, ecc.):
• • Usa un offset più grande (es. 20–50 “pips” a seconda della dimensione del pip del broker).

Se le frecce si sovrappongono alle candele, aumenta questo valore.
Se sono troppo lontane, diminuiscilo.

4. Mostra testo BUY/SELL

• true → mostra sia una freccia (↑/↓) sia il testo “BUY” o “SELL”.
• false → solo frecce.

Se il grafico sembra affollato, puoi nascondere il testo e mantenere solo le frecce.

🔍 Come vengono generati i segnali (logica)

Internamente l'indicatore:

1. Tiene traccia dei due massimi oscillanti più recenti e dei due minimi oscillanti più recenti:
2. • _prevHigh, _lastHigh
   • _prevLow, _lastLow
2. Da questi verifica:
3. • I massimi e i minimi sono entrambi in aumento?
   • • → Trend rialzista (StructureTrendSignal.Bullish)
   • I massimi e i minimi sono entrambi in diminuzione?
   • • → Trend ribassista (StructureTrendSignal.Bearish)
   • Se non sono allineati, si mantiene il trend precedente.
3. Ogni volta che il trend strutturale cambia:
4. • Ribassista → Rialzista → segnale BUY
   • Rialzista → Ribassista → segnale SELL
4. Garantisce inoltre:
5. • Il trend non era Unknown (quindi non all'inizio).
   • Sono passate abbastanza barre dall'ultimo segnale (MinBarsBetweenSignals).

Questo significa che ogni freccia segna un vero cambiamento strutturale, non rumore casuale.

📈 Come leggere i segnali BUY/SELL sul grafico

✅ Segnale BUY

Cosa vedi:

• Una freccia verso l'alto ↑ sotto la candela
• Facoltativamente il testo “BUY” vicino alla freccia

Cosa significa:

• La struttura è cambiata da ribassista → rialzista.
• I massimi e minimi oscillanti recenti sono ora entrambi in aumento.
• Il mercato probabilmente sta entrando in un nuovo trend rialzista o sta riprendendo la struttura rialzista.

Come usarlo:

• Cerca ingressi long:
• • Sulla candela del segnale o sulle successive.
  • Preferibilmente dopo un piccolo ritracciamento a un livello di supporto (minimo oscillante precedente, zona di domanda, VWAP, VA low, ecc.).
• Usa strumenti come Kalman Trend / EMA / Volume Profile per filtrare:
• • Prendi BUY solo quando il timeframe superiore o Kalman è anch'esso rialzista.

✅ Segnale SELL

Cosa vedi:

• Una freccia verso il basso ↓ sopra la candela
• Facoltativamente il testo “SELL”

Cosa significa:

• La struttura è cambiata da rialzista → ribassista.
• I massimi e minimi oscillanti sono ora entrambi in diminuzione.
• Il mercato probabilmente sta entrando in un trend ribassista o sta riprendendo la struttura ribassista.

Come usarlo:

• Cerca ingressi short:
• • Sulla candela del segnale o sulle successive vicino a una resistenza.
  • Ideale dopo un retest di un supporto rotto (ora resistenza), VAH, zona di offerta, ecc.

🎯 Usi pratici nel trading

1. Come strumento di ingresso autonomo

Regole semplici:

• Setup Buy
• • Aspetta una freccia BUY.
  • Posiziona un ordine long sulla candela del segnale o vicino ad essa.
  • Stop loss sotto il minimo oscillante recente.
  • Target al massimo oscillante precedente o a una resistenza chiave.
• Setup Sell
• • Aspetta una freccia SELL.
  • Posiziona un ordine short sulla candela del segnale o vicino ad essa.
  • Stop loss sopra il massimo oscillante recente.
  • Target al minimo oscillante precedente o a un supporto chiave.

Questo è l'uso più basilare e funziona meglio su H1, H4 e D1, dove la struttura è più pulita.

2. Come strumento di conferma con i tuoi altri indicatori

Qui diventa potente.

🔹 Con Kalman Filter Trend

• Prendi solo segnali BUY quando:
• • Il trend Kalman è in salita e il prezzo è sulla linea Kalman o sopra.
• Prendi solo segnali SELL quando:
• • Il trend Kalman è in discesa e il prezzo è sulla linea Kalman o sotto.

Effetto:
Kalman ti dà un trend fluido, MarketStructureOscSignals ti dà cambiamenti strutturali precisi. Insieme filtrano molti trade sbagliati.

🔹 Con Volume Profile / Supporto & Resistenza

• BUY forte:
• • La freccia BUY appare vicino a VA Low, minimo oscillante precedente o sweep di liquidità, con rifiuto.
• SELL forte:
• • La freccia SELL appare vicino a VA High, massimo oscillante precedente o sweep di liquidità in cima.

Qui il segnale non è solo un pattern tecnico ma è anche ancorato in zone di liquidità e flusso d'ordine.

3. Per scalare dentro/fuori

Puoi anche usare i nuovi segnali come:

• Punti di Scale-In
  Aggiungi a una posizione quando appare un nuovo segnale nella stessa direzione del tuo trade esistente e il timeframe superiore è allineato.
• Uscita anticipata / uscita parziale
  Se sei long e appare un segnale SELL contro la tua posizione (specialmente vicino a una struttura chiave), puoi:
• • Chiudere una parte della posizione
  • O stringere gli stop

🧪 Impostazioni consigliate di partenza

Per Forex H1 / H4:

• Swing Left = 2
• Swing Right = 2
• Min Bars Between Signals = 3
• Arrow Offset = 5–10 pips

Per Indici M15 / H1:

• Swing Left = 2–3
• Swing Right = 2–3
• Min Bars Between Signals = 5
• Arrow Offset adattato al simbolo (es. 20–50 “pips” a seconda del broker)

Per Crypto H1 / H4:

• Oscillazioni leggermente più alte per filtrare il rumore:
• • Swing Left = 3
  • Swing Right = 3
  • Min Bars Between Signals = 4–6

Fai sempre backtest con il tuo strumento e timeframe preferito per ottimizzare Swing e MinBarsBetweenSignals.