FVG and Structure PRO — Manuale d'uso (MetaTrader 5, versione 2.00)

Disponibile su MQL5 Market: FVG and Structure PRO

Avviso sui rischi. Il trading comporta il rischio di perdite. Questo indicatore segna strutture di prezzo sul grafico; non prevede il mercato, non piazza operazioni e non garantisce alcun risultato. Usalo insieme alla tua analisi e alla tua gestione del rischio, ed esegui prima i test su un conto demo.

FVG and Structure PRO disegna la struttura di mercato (BOS / CHoCH), i fair value gap (FVG) con il monitoraggio del riempimento, gli order block, i massimi / minimi uguali, gli FVG di un timeframe superiore, un'area premium / discount opzionale e un pannello di struttura multi-timeframe. Ogni elemento viene confermato su una barra chiusa: nulla viene ridisegnato dopo la sua comparsa. Funziona su qualsiasi simbolo, con qualsiasi broker e su qualsiasi timeframe.

Novità della versione 2.00

• 5 nuovi buffer per Expert Advisor e dashboard: FVG rialzista aperto più vicino (top, bottom), FVG ribassista aperto più vicino (top, bottom) e un evento di zona (FVG nuovo / mitigato, order block nuovo / rotto) — sezione 14.
• FVG e order block vengono monitorati anche quando il loro disegno è disattivato, quindi i buffer funzionano anche su un grafico pulito. Disegno, avvisi e buffer esistenti sono invariati.
• Pannello: il testo "bars ago" viene nascosto finché la barra dell'ultimo evento non è ancora disponibile nello storico del grafico.

1. Installazione e primo avvio

1. Acquista o noleggia l'indicatore sul MQL5 Market e installalo dalla scheda Market del terminale (Toolbox → Market → Purchased → Install).
2. Apri un grafico e trascinaci sopra FVG and Structure PRO dal Navigatore (Indicators → Market).
3. Mantieni i parametri di input predefiniti o regolali (sezione 13) e premi OK.

L'indicatore analizza le ultime 1500 barre (parametro Bars analysed) e poi segue ogni nuova barra. Il pannello appare nell'angolo in basso a destra. Sul grafico l'indicatore si chiama FVG & Structure PRO.

Impostazioni che impediscono l'avvio dell'indicatore (la finestra dei parametri si riapre): Swing strength al di fuori di 1-50, Bars analysed inferiore a 100, o qualsiasi limite "per side" inferiore a 1.

2. Legenda del grafico

Ogni linea e ogni rettangolo ha un tooltip: passa il mouse sopra per leggerne il tipo e i prezzi. Gli oggetti sono nascosti nell'elenco degli oggetti e non sono selezionabili, quindi non vengono spostati per errore. Le zone e i livelli attivi si estendono di 10 barre a destra della barra corrente (parametro Active zones extend right).

3. Struttura di mercato: BOS e CHoCH

Uno swing high è una barra il cui massimo è superiore ai massimi delle Swing strength barre su ciascun lato (5 per impostazione predefinita); uno swing low è il suo speculare. Uno swing viene quindi confermato Swing strength barre dopo la sua formazione.

• Quando una barra chiude sopra l'ultimo swing high, viene disegnata una rottura rialzista dallo swing alla barra di rottura; una chiusura sotto l'ultimo swing low disegna una rottura ribassista.
• La rottura è un BOS (linea continua) quando segue il trend attuale e un CHoCH (linea tratteggiata) quando lo inverte. La prima rottura dopo il caricamento è un BOS.
• Ogni swing può essere rotto una sola volta. Le ombre oltre uno swing non contano — solo le chiusure.
• Sul grafico restano solo le ultime Structure breaks kept on chart (20 per impostazione predefinita) rotture; quelle più vecchie vengono rimosse. Le etichette degli swing ne conservano il doppio.

Le etichette degli swing (parametro HH / HL / LH / LL labels, disattivato per impostazione predefinita) contrassegnano ogni swing confermato rispetto al precedente dello stesso lato.

Una Swing strength più grande produce swing meno numerosi e più significativi (struttura swing / esterna); una più piccola reagisce più rapidamente (struttura interna).

4. Fair value gap (FVG)

Un FVG è uno squilibrio su tre candele: il minimo della terza candela è sopra il massimo della prima (rialzista) oppure il massimo della terza candela è sotto il minimo della prima (ribassista). Il rettangolo viene disegnato a partire dalla candela centrale e copre il gap tra le due ombre.

• Minimum gap size (0.2 × ATR 14 per impostazione predefinita): i gap più piccoli vengono ignorati. Aumentalo per vedere solo gli squilibri maggiori.
• FVG is mitigated at: Full fill (predefinito — il prezzo raggiunge il bordo lontano del gap), 50% fill (consequent encroachment) (il prezzo raggiunge il centro) o First touch (il prezzo raggiunge il bordo vicino).
• Shrink to the unfilled part (attivo per impostazione predefinita): mentre il prezzo entra nel gap senza mitigarlo, il rettangolo si riduce alla parte ancora aperta.
• Active FVGs per side (8 per impostazione predefinita): quando appare un nuovo FVG e il limite viene superato, il FVG attivo più vecchio di quel lato viene scartato.

I riempimenti vengono valutati sulle barre chiuse. Un FVG mitigato viene rimosso dal grafico, oppure mantenuto nel colore delle zone mitigate (sezione 8).

5. FVG del timeframe superiore

Con Show higher timeframe FVGs attivo, gli FVG aperti del Higher timeframe selezionato (H1 per impostazione predefinita) vengono disegnati come rettangoli con contorno (goldenrod per impostazione predefinita) con un'etichetta come H1 FVG, sopra gli FVG del timeframe del grafico.

• Usano la stessa dimensione minima e la stessa regola di mitigazione degli FVG del grafico (senza riduzione) e vengono letti dalle ultime 400 barre di quel timeframe.
• Solo le barre chiuse del timeframe superiore creano gap; la barra in formazione del timeframe superiore può già riempirne uno.
• Active HTF FVGs per side (4 per impostazione predefinita) limita il numero mostrato.
• Vengono disegnati solo quando il timeframe selezionato è superiore al timeframe del grafico (ad esempio gap H1 su un grafico M5 o M15).
• Il filtro killzone non si applica a essi. Sono solo oggetti grafici (nessun buffer).

6. Filtro killzone (ICT)

Con Only FVGs formed inside killzones attivo, gli FVG del timeframe del grafico vengono mantenuti solo quando la loro candela centrale si è aperta all'interno di una delle killzone selezionate, in ora di New York con gestione automatica dell'ora legale:

Il filtro è pensato per i grafici intraday (da M1 a H1). Si applica anche ai buffer FVG e agli avvisi FVG.

Broker time zone — necessario per convertire l'ora del server del grafico in ora di New York:

• Auto (live) / GMT+2/+3 in tester (predefinito): l'offset viene misurato dall'orologio del terminale. I broker su GMT+2 / GMT+3 (chiusura di New York) vengono seguiti lungo tutto lo storico con l'ora legale statunitense. Nello Strategy Tester si assume GMT+2 / GMT+3.
• GMT+2 / GMT+3 (New York close brokers): impone questa regola.
• Fixed GMT offset: usa Broker GMT offset (2 per impostazione predefinita) tutto l'anno. Usalo nel tester per un broker che non è su GMT+2 / GMT+3.

7. Order block

Ogni rottura di struttura (BOS o CHoCH) crea un order block: la candela estrema del movimento che ha prodotto la rottura — la candela con il minimo più basso tra lo swing e la rottura per una rottura rialzista, la candela con il massimo più alto per una ribassista. Il rettangolo copre l'intera escursione (dal massimo al minimo) di quella candela e porta l'etichetta OB.

• Un order block è rotto quando una barra chiude attraverso di esso (sotto un OB rialzista, sopra un OB ribassista).
• Active order blocks per side (3 per impostazione predefinita): il più vecchio viene scartato quando il limite viene superato.
• Con Show order blocks disattivato, gli order block vengono comunque calcolati per i buffer (sezione 14) ma non vengono disegnati e non vengono inviati avvisi OB.

8. Zone mitigate

Per impostazione predefinita (Hide mitigated FVGs and order blocks = true) un FVG mitigato o un order block rotto scompare dal grafico. Disattiva il parametro per mantenerli come storico: il rettangolo torna alla sua dimensione originale, termina alla barra che lo ha mitigato e viene colorato con il Mitigated zone color (grigio scuro per impostazione predefinita); l'etichetta OB diventa grigia. Il tooltip termina allora con "(mitigated)".

9. Liquidità: massimi e minimi uguali

Quando due swing high (o low) consecutivi distano tra loro meno della Equal tolerance (0.1 × ATR 14 per impostazione predefinita), viene disegnata una linea dorata punteggiata dal primo swing al secondo, con l'etichetta EQH (massimi uguali) o EQL (minimi uguali). Questi livelli spesso contengono liquidità in attesa (ordini stop).

• La linea si estende verso destra finché il livello resta intatto.
• Quando una barra successiva va oltre il livello (ombra o chiusura), il livello viene spazzato (swept): la linea si ferma a quella barra e diventa grigia.
• Levels kept on chart (6 per impostazione predefinita): i livelli più vecchi vengono rimossi.

Aumenta la tolleranza per trovare più livelli; riducila per corrispondenze più rigorose.

10. Premium / discount

Con Equilibrium of the current swing range attivo, vengono disegnate tre linee dal più vecchio dei due swing più recenti fino al bordo destro delle zone:

• Premium (rossa punteggiata) all'ultimo swing high;
• Equilibrium (argentata tratteggiata) al punto medio;
• Discount (verde acqua punteggiata) all'ultimo swing low.

Un prezzo sopra l'equilibrio si trova nella metà premium dell'intervallo, sotto di esso nella metà discount. Le linee si spostano con ogni nuovo swing confermato.

11. Il pannello

Il pannello (angolo in basso a destra per impostazione predefinita, parametro Panel corner) mostra:

Un FVG che contiene il prezzo corrente non viene elencato né sopra né sotto. Con Show FVGs disattivato le due righe FVG mostrano "none". Il pannello viene aggiornato a ogni nuova barra ed è sempre mantenuto sopra le zone.

12. Avvisi

Ogni avviso può essere Off, Popup, Sound, Smartphone notification, Popup + Sound, Notification + Sound, Popup + Notification o Popup + Sound + Notification. Tutti gli avvisi sono disattivati per impostazione predefinita. Sound seleziona uno dei suoni del terminale ("alert" per impostazione predefinita); Also send e-mail aggiunge un'e-mail a ogni avviso attivato.

Il testo include prodotto, simbolo e timeframe, ad es. FVG & Structure PRO: EURUSD | M15 | Bullish BOS above 1.08520 . Ogni tipo di avviso si attiva al massimo una volta per barra. Quando l'indicatore viene collegato, le zone già toccate dalla barra corrente vengono contrassegnate in silenzio, quindi non si verifica una raffica di vecchi avvisi. Le notifiche push richiedono il MetaQuotes ID in Tools → Options → Notifications; l'e-mail richiede le impostazioni e-mail del terminale. Lo Strategy Tester non mostra pop-up, suoni o notifiche.

13. Parametri di input

MARKET STRUCTURE

FAIR VALUE GAPS

HIGHER TIMEFRAME FVGs

KILLZONE FILTER (ICT)

ORDER BLOCKS

MITIGATED ZONES

LIQUIDITY

PREMIUM / DISCOUNT

HISTORY AND PANEL

ALERTS

14. Buffer per Expert Advisor / dashboard

L'indicatore espone 7 buffer che possono essere letti con iCustom + CopyBuffer . Tutti i valori sono definitivi sulle barre chiuse: leggi shift 1 per l'ultimo valore definitivo.

"Aperto" dipende dai parametri FVG is mitigated at, Minimum gap size, Active FVGs per side e dal filtro killzone. FVG e order block vengono monitorati anche con Show FVGs / Show order blocks disattivati. Massimi / minimi uguali e FVG del timeframe superiore sono solo oggetti grafici.

Caricamento. La versione Market viene installata in MQL5\Indicators\Market\ ; verifica il nome esatto del file nel Navigatore. Senza parametri dopo il nome vengono usati i parametri di input predefiniti. Per modificare i parametri, passali nell'ordine della sezione 13. Ogni intestazione input group è anch'essa un parametro: passa una stringa vuota "" al suo posto, altrimenti tutti i valori successivi si spostano. I parametri omessi alla fine mantengono i valori predefiniti.

```mql5 // "" = group MARKET STRUCTURE, 5 = swing strength, false = no BOS / CHoCH lines int h = iCustom(_Symbol, PERIOD_H1, "Market\FVG and Structure PRO", "", 5, false);

double trend[1], bt[1], bb[1], ze[1]; if (BarsCalculated(h) > 0) { if (CopyBuffer(h, 0, 1, 1, trend) == 1) Print("structure ", (int)trend[0]); // +1 / -1 if (CopyBuffer(h, 2, 1, 1, bt) == 1 && CopyBuffer(h, 3, 1, 1, bb) == 1 && bt[0] != EMPTY_VALUE) Print("nearest bullish FVG ", bb[0], " - ", bt[0]); if (CopyBuffer(h, 6, 1, 1, ze) == 1 && ze[0] != 0.0) Print("zone event ", (int)ze[0]); } ```

Note: un indicatore creato da iCustom disegna il suo pannello e i suoi oggetti sul grafico del programma chiamante — disattiva i parametri di disegno e il pannello per una dashboard pulita. Attendi che BarsCalculated(h) > 0 prima della prima lettura (lo storico potrebbe essere ancora in caricamento). Per una dashboard multi-simbolo bastano 1000 Bars analysed.

15. Suggerimenti

• Intraday: M5 o M15 con Show higher timeframe FVGs attivo e Higher timeframe = H1 mostra i gap del grafico all'interno di quelli più grandi.
• Meno confusione: aumenta Minimum gap size, riduci Active FVGs per side / Active order blocks per side, oppure attiva il filtro killzone.
• Profondità della struttura:Swing strength 3 segue la struttura interna; 8-10 segue solo gli swing principali. Il bias degli altri timeframe nel pannello usa lo stesso valore.
• Storico delle reazioni: disattiva Hide mitigated per studiare come il prezzo ha reagito alle zone passate.
• Un'istanza per grafico: due copie sullo stesso grafico condividono i nomi degli oggetti e si cancellano a vicenda i disegni. Per confrontare impostazioni diverse, apri un secondo grafico dello stesso simbolo.

16. Domande e risoluzione dei problemi

• Ridisegna (repaint)? No. Swing, rotture, FVG e order block vengono creati su barre chiuse e non vengono mai spostati in seguito. Per definizione uno swing viene disegnato Swing strength barre dopo la sua barra (ha bisogno delle barre alla sua destra).
• Il pannello mostra "–" per un timeframe. Quel timeframe non ha ancora una rottura di struttura nelle sue ultime 500 barre, oppure il suo storico è ancora in download; si aggiorna alla sua barra successiva.
• Non compaiono FVG HTF. Il timeframe del grafico deve essere inferiore a Higher timeframe, e al momento potrebbero non esserci gap aperti di quella dimensione.
• Il filtro killzone rimuove tutti gli FVG. Controlla Broker time zone. Sui grafici da H4 in su poche candele si aprono all'interno di una killzone.
• Nessun avviso. Tutti gli avvisi sono Off per impostazione predefinita. Gli avvisi FVG e OB richiedono anche che il relativo disegno sia attivo. Gli avvisi di contatto si attivano una volta per zona.
• Un FVG resta aperto anche se il prezzo vi è entrato. Con Full fill il gap si chiude solo quando il prezzo raggiunge il suo bordo lontano; con Shrink attivo il rettangolo mostra la parte ancora aperta.
• Strategy Tester. Funziona in modalità visuale e non visuale; pop-up, suoni e notifiche non vengono inviati nel tester.

Supporto: invia un messaggio privato all'autore su MQL5.