Smart Data Export Indicator (MT5/MT4): manuale utente, file CSV e JSON Lines, colonne e impostazioni

Smart Data Export Indicator è un indicatore gratuito per MetaTrader 5 che scrive i dati del grafico in file CSV o JSON Lines, con le colonne che scegli e una scheda dati (data card) che spiega ogni colonna. È pensato per chi analizza i propri grafici con un assistente IA come ChatGPT o Claude, con un foglio di calcolo o con Python. Smart Data Export Indicator MT4 è la versione gratuita per MetaTrader 4; le differenze sono indicate più avanti. Entrambi sostituiscono il mio SmartDataExportEa gratuito. Questo manuale vale per la versione 1.00.

Cosa esporta

• File dati (CSV o JSON Lines): una riga per barra chiusa, dalla più vecchia alla più recente. Le nuove barre vengono aggiunte man mano che si chiudono.
• Scheda dati (.md): unità, righe di warm-up, fuso orario e qualità dei dati, più un prompt per un assistente IA.
• Snapshot IA (.md, solo MT5): le ultime barre come tabella da incollare in una chat.
• Deals (facoltativo): i deal di questo conto (MT5) o gli ordini chiusi (MT4).

I valori dei timeframe superiori provengono solo da barre già chiuse (nessun look-ahead). L'indicatore non invia ordini, non usa DLL e non fa richieste web, quindi può stare sullo stesso grafico del tuo Expert Advisor.

Installazione

1. Nella pagina del prodotto (MT5 o MT4) fai clic su Free Download; si apre MetaTrader. Puoi trovarlo anche in MetaTrader in Toolbox > Market. I prodotti installati sono elencati in Toolbox > Market > Purchased, dove compaiono gli aggiornamenti (Update).
2. Trascina l'indicatore da Navigator > Indicators > Market su un grafico. I valori predefiniti funzionano, quindi puoi semplicemente fare clic su OK.

Esportazione passo per passo

1. Apri un grafico del simbolo. Le righe usano il timeframe del grafico, a meno che tu non imposti Timeframe of the rows .
2. Applica l'indicatore, scegli il Range (per impostazione predefinita le ultime 5000 barre chiuse), le colonne e gli indicatori, ad esempio RSI(14); EMA(50); ATR(14) , e fai clic su OK.
3. Osserva lo stato sul pannello: cosa sta aspettando, poi Exporting history... , poi History done - appending new bars as they close (oppure Export finished se After the history è impostato per fermarsi).

Lo stato è verde a lavoro finito, arancione durante l'elaborazione o l'attesa e rosso dopo un errore. Gli avvisi, come un nome di indicatore sconosciuto, compaiono in arancione dopo un ! e nella scheda Experts. Export again rilegge lo storico e riscrive tutti i file.

Dove vanno i file e cosa contengono

I file vengono scritti in MQL5\Files\SmartDataExport (MT4: MQL4\Files\SmartDataExport ; File > Open Data Folder), oppure in Terminal\Common\Files\SmartDataExport con il parametro della cartella comune. Nello Strategy Tester vengono scritti nella cartella dell'agente di test (MT4: tester\files ), senza snapshot IA.

Ogni avvio dell'esportazione (applicazione al grafico, modifica di un parametro, riavvio di MetaTrader, Export again) riscrive il file dati a partire dallo storico; dopodiché le righe vengono solo aggiunte. Per conservare un file precedente, copialo oppure aggiungi {date} al nome del file.

File dati, ad esempio XAUUSD_M15.csv (oppure .jsonl ). Ogni riga inizia con l'ora di apertura della barra in ora del server. I file CSV hanno una riga di intestazione e usano il punto come separatore decimale; i valori mancanti sono vuoti (null in JSON Lines). Seguono:

• open, high, low, close, tick_volume , real_volume (MT5, se il broker lo fornisce), spread_pts .
• In punti: ret_pts (close - open), range_pts, body_pts, upper_wick_pts, lower_wick_pts , gap_pts (open - close precedente); e log_ret = ln(close / close precedente).
• time_utc (offset rilevato per ogni settimana, quindi l'ora legale viene gestita), dow_utc (1 = lunedì), hour_utc , session : tokyo (9–18 JST), london (8–17 ora di Londra), newyork (8–17 ora di New York), uniti con +, oppure off.
• Gli indicatori prendono il nome dalle loro impostazioni, come rsi_14 o macd_signal_12_26_9 ; i buffer personalizzati diventano custom_<name>_<buffer> .
• Da h4_open a d1_close (timeframe predefiniti): le ultime barre H4 e D1 già chiuse alla chiusura della riga.

Scheda dati, XAUUSD_M15.datacard.md , scritta al termine dell'esportazione dello storico: dataset, specifiche del simbolo, fuso orario, ogni colonna con unità, significato e righe di warm-up, un report di qualità (pause, gap, orari duplicati, barre con range zero, picchi di range e, in MT5, salti di spread) e un prompt da copiare. La scheda dati di MT4 elenca anche gli avvisi.

Deals: deals_last_365d.csv (MT5) con simbolo, tipo, volume, prezzo, profitto, commissione, swap, magic number e motivo, oppure closed_orders.csv (MT4) con orari, prezzi, profitto, commissione, swap, magic number e stop loss.

Usare i file con un assistente IA o un foglio di calcolo

• Domande sullo storico. Allega alla chat il file dati e la scheda dati, copia il prompt dalla fine della scheda dati e scrivi la tua domanda nella sua ultima riga. Il prompt chiede all'assistente di considerare ogni riga nota solo alla sua chiusura, di scartare le righe di warm-up, di dividere i dati nel tempo e di fornire intervalli di confidenza.
• Il mercato attuale (MT5). Incolla XAUUSD_M15.snapshot.md : le ultime 120 barre chiuse (fino a 500) con orari UTC, bid e ask, fino a 8 colonne di indicatori e uno spunto di prompt. Viene riscritto a ogni nuova barra mentre l'indicatore aggiunge righe.
• L'assistente vede solo le righe che gli dai. Considera le sue conclusioni come idee da verificare, non come segnali.
• Excel e Python possono leggere il file mentre le righe vengono aggiunte. C'è un'opzione UTF-8 BOM per Excel e un formato con punto e virgola. Se un programma blocca il file, le nuove righe attendono finché non è libero.
• Le righe di warm-up sono elencate nella scheda dati. In MT5 i loro valori degli indicatori derivano da poco storico; MT4 le lascia vuote.

Parametri di input

I nomi sono le etichette mostrate nella scheda Inputs.

In MT4 gli interruttori delle colonne sono Columns: open, high, low, close , Columns: tick volume , Columns: spread (only rows appended live; MT4 bars have no spread) , Columns: return, range, body, wicks, gap, log return e Columns: UTC time, weekday, hour, session , e l'interruttore dei deal è Also export this account's closed orders .

Nomi degli indicatori: SMA, EMA, SMMA, LWMA, DEMA, TEMA, RSI, ATR, MACD, BB, STOCH, ADX, CCI, MFI, WPR, MOM, STDDEV, OBV, AO, SAR e ICHIMOKU (senza Chikou, che usa barre successive). Senza parentesi vengono usati i valori predefiniti, ad esempio RSI(14) o MACD(12,26,9). MyIndicator:0,1 esporta i buffer 0 e 1 di un indicatore personalizzato con i suoi parametri predefiniti; il nome è relativo a MQL5\Indicators (MT4: MQL4\Indicators). I nomi sconosciuti vengono saltati con un avviso.

Note su MT4

• Il pannello è composto da poche righe di testo con un pulsante Export again.
• Niente snapshot IA, niente volume reale, niente DEMA o TEMA. spread_pts è vuoto per le righe dello storico, perché MT4 non memorizza uno spread per ogni barra; le righe aggiunte in tempo reale ricevono lo spread attuale.
• Un timeframe superiore uguale a quello delle righe viene saltato senza avviso, uno inferiore con un avviso. Le barre dei timeframe superiori seguono i confini del broker; alcuni broker iniziano le barre H4 alle 01:00.
• La prima volta, H1 (per il fuso orario) e i timeframe superiori vengono scaricati dal broker; l'indicatore attende fino a circa un minuto per ciascuno ( Waiting for higher-timeframe history... ). Se un timeframe superiore non arriva, le sue celle restano vuote; senza H1 il fuso orario ripiega su GMT+2 (GMT+3 durante l'ora legale USA). La scheda dati lo segnala.
• Un grafico appena aperto ha spesso circa 2,000 barre. Scorri all'indietro o premi Home per caricarne altre, poi fai clic su Export again. Anche "Max bars in history" e "Max bars in chart" (Tools > Options > Charts) limitano la profondità.
• Gli ordini chiusi sono quelli mostrati nella scheda Account History; modificane il periodo per includere ordini più vecchi.

Domande degli utenti

• Meno righe di quelle richieste? Si possono esportare solo le barre caricate nel terminale. In MT5 aumenta "Max bars in chart" (Tools > Options > Charts), carica più storico e fai clic su Export again.
• Lo stato dice is it open in another program? Chiudi il file in quel programma e fai clic su Export again.
• Un timeframe superiore viene saltato con un avviso. Su un grafico H4 o D1 il valore predefinito H4; D1 contiene un timeframe che non è superiore a quello delle righe. Rimuovilo dal parametro.
• Più simboli? Applica una copia a ogni grafico. Con il nome di file predefinito ogni simbolo e timeframe ha il proprio file.

Pagine del prodotto: Smart Data Export Indicator (MT5) e Smart Data Export Indicator MT4. Se qualcosa non è chiaro, inviami un messaggio privato su MQL5 con uno screenshot del pannello e le ultime righe della scheda Experts.