Smart Data Export Indicator (MT5/MT4): Kullanım Kılavuzu, CSV ve JSON Lines Dosyaları, Sütunlar ve Ayarlar
Smart Data Export Indicator, grafik verilerini seçtiğiniz sütunlarla CSV veya JSON Lines dosyalarına yazan ve her sütunu açıklayan bir veri kartı (data card) oluşturan, ücretsiz bir MetaTrader 5 göstergesidir. Grafiklerini ChatGPT veya Claude gibi bir yapay zekâ asistanıyla, bir elektronik tabloyla ya da Python ile analiz eden kişiler içindir. Smart Data Export Indicator MT4 ücretsiz MetaTrader 4 sürümüdür; farklar aşağıda belirtilmiştir. İkisi de benim ücretsiz SmartDataExportEa ürünümün yerini alır. Kılavuz 1.00 sürümü için geçerlidir.
Neleri dışa aktarır
- Veri dosyası (CSV veya JSON Lines): kapanmış her bar için bir satır, en eskisi önce. Yeni barlar kapandıkça eklenir.
- Veri kartı (.md): birimler, ısınma satırları (warm-up rows), saat dilimi ve veri kalitesi; ayrıca bir yapay zekâ asistanı için bir istem (prompt).
- AI snapshot (.md, yalnızca MT5): bir sohbete yapıştırmak için tablo hâlinde son barlar.
- İşlemler (isteğe bağlı): bu hesabın işlemleri (deals, MT5) veya kapanmış emirleri (MT4).
Üst zaman dilimi değerleri yalnızca o anda zaten kapanmış barlardan gelir (ileriye bakma yok). Gösterge emir vermez, DLL kullanmaz ve web isteği yapmaz; bu yüzden Uzman Danışmanınızla aynı grafiği paylaşabilir.
Kurulum
- Ürün sayfasında (MT5 veya MT4) Ücretsiz İndir (Free Download) düğmesine tıklayın; MetaTrader açılır. Ürünü MetaTrader'da Araç kutusu > Mağaza (Toolbox > Market) altında da bulabilirsiniz. Kurulu ürünler Araç kutusu > Mağaza > Satın Alınanlar (Toolbox > Market > Purchased) içinde listelenir; güncellemeler de orada görünür (Güncelle).
- Göstergeyi Kılavuz > Göstergeler > Market içinden bir grafiğin üzerine sürükleyin (İngilizce arayüzde: Navigator > Indicators > Market). Varsayılan ayarlar çalışır; bu yüzden doğrudan Tamam (OK) düğmesine tıklayabilirsiniz.
Adım adım dışa aktarma
- Sembolün grafiğini açın. Timeframe of the rows girdisini ayarlamadığınız sürece satırlar grafiğin zaman dilimini kullanır.
- Göstergeyi ekleyin; Range değerini (varsayılan olarak son 5000 kapanmış bar), sütunları ve göstergeleri, örneğin RSI(14); EMA(50); ATR(14) , seçin ve Tamam (OK) düğmesine tıklayın.
- Paneldeki durumu izleyin: önce neyi beklediği, sonra Exporting history... , ardından History done - appending new bars as they close (ya da After the history durmaya ayarlıysa Export finished ).
Durum, iş bittiğinde yeşil, çalışırken veya beklerken turuncu, bir hatadan sonra kırmızıdır. Bilinmeyen bir gösterge adı gibi uyarılar turuncu renkte bir ! işaretinden sonra ve Uzmanlar (Experts) sekmesinde görünür. Export again (yeniden dışa aktar) geçmişi yeniden okur ve tüm dosyaları yeniden yazar.
Dosyalar nereye yazılır, içlerinde ne var
Dosyalar MQL5\Files\SmartDataExport klasörüne (MT4: MQL4\Files\SmartDataExport ; Dosya > Veri Klasörünü Aç, İngilizce arayüzde File > Open Data Folder), ortak klasör girdisi açıksa Terminal\Common\Files\SmartDataExport klasörüne yazılır. Strateji Sınayıcı'da sınayıcı ajanının klasörüne (MT4: tester\files ) yazılır; AI snapshot oluşturulmaz.
Dışa aktarmanın her başlangıcı (göstergeyi eklemek, bir girdiyi değiştirmek, MetaTrader'ı yeniden başlatmak, Export again) veri dosyasını geçmişten yeniden yazar; bundan sonra yalnızca satır eklenir. Eski bir dosyayı saklamak için kopyalayın veya dosya adına {date} ekleyin.
Veri dosyası, örneğin XAUUSD_M15.csv (veya .jsonl ). Her satır, sunucu saatiyle barın açılış zamanıyla başlar. CSV dosyalarında bir başlık satırı vardır ve ondalık ayırıcı olarak nokta kullanılır; eksik değerler boştur (JSON Lines'ta null). Ardından şunlar gelir:
- open, high, low, close, tick_volume , real_volume (MT5, aracı kurum sağlıyorsa), spread_pts .
- Puan cinsinden: ret_pts (kapanış - açılış), range_pts, body_pts, upper_wick_pts, lower_wick_pts , gap_pts (açılış - önceki kapanış); ayrıca log_ret = ln(kapanış / önceki kapanış).
- time_utc (fark her hafta için ayrı tespit edilir; böylece yaz saati ele alınır), dow_utc (1 = pazartesi), hour_utc , session : tokyo (9–18 JST), london (8–17 Londra saati), newyork (8–17 New York saati); + ile birleştirilir ya da off.
- Ayarlarına göre adlandırılan göstergeler, örneğin rsi_14 veya macd_signal_12_26_9 ; özel gösterge tamponları custom_<name>_<buffer> şeklinde.
- h4_open ile d1_close arası (varsayılan zaman dilimleri): satırın kapanışı itibarıyla kapanmış son H4 ve D1 barları.
Veri kartı, XAUUSD_M15.datacard.md , geçmişin dışa aktarımı bittiğinde yazılır: veri kümesi, sembol özellikleri, saat dilimi, birimi, anlamı ve ısınma satırlarıyla her sütun, bir kalite raporu (kesintiler, boşluklar, yinelenen zamanlar, sıfır aralıklı barlar, aralık sıçramaları ve MT5'te spread sıçramaları) ve kopyalanacak bir istem. MT4 kartı ayrıca uyarıları da listeler.
İşlemler: sembol, tür, hacim, fiyat, kâr, komisyon, swap, magic number ve neden bilgileriyle deals_last_365d.csv (MT5) veya zamanlar, fiyatlar, kâr, komisyon, swap, magic number ve zarar durdur bilgileriyle closed_orders.csv (MT4).
Dosyaları bir yapay zekâ asistanıyla veya elektronik tabloyla kullanma
- Geçmişle ilgili sorular. Veri dosyasını ve veri kartını sohbete ekleyin, kartın sonundaki istemi kopyalayın ve sorunuzu istemin son satırına yazın. İstem, asistandan her satırı yalnızca kapanışında bilinmiş saymasını, ısınma satırlarını çıkarmasını, verileri zamana göre bölmesini ve güven aralıkları vermesini ister.
- Güncel piyasa (MT5). XAUUSD_M15.snapshot.md dosyasını yapıştırın: UTC saatleriyle son 120 kapanmış bar (en fazla 500), bid ve ask fiyatları, en fazla 8 gösterge sütunu ve bir istem fikri. Gösterge satır eklemeye devam ettiği sürece dosya her yeni barda yeniden yazılır.
- Asistan yalnızca ona verdiğiniz satırları görür. Bulgularını sinyal olarak değil, kontrol edilecek fikirler olarak değerlendirin.
- Excel ve Python, satırlar eklenirken dosyayı okuyabilir. Excel için bir UTF-8 BOM seçeneği ve noktalı virgülle ayrılmış bir biçim vardır. Bir program dosyayı kilitlerse yeni satırlar dosya serbest kalana kadar bekler.
- Isınma satırları veri kartında listelenir. MT5'te bu satırların gösterge değerleri az bir geçmişten hesaplanır; MT4 bunları boş bırakır.
Girdiler
Adlar, Girdiler (Inputs) sekmesinde gösterilen etiketlerdir.
| Girdi | Varsayılan | Ne işe yarar |
|---|---|---|
| Timeframe of the rows | current | current = grafiğin zaman dilimi. |
| Range | Last N closed bars | Ya da Date range (From / To) veya All available history . |
| Last N closed bars (Range = last N bars) | 5000 | Dışa aktarılacak bar sayısı. |
| From (Range = date range) | 2024.01.01 00:00 | Tarih aralığının başlangıcı. |
| To (0 = up to the last closed bar) | 0 | Tarih aralığının sonu. |
| After the history | Keep appending each new closed bar | Ya da Stop after the history export . |
| Open, High, Low, Close | true | Fiyat sütunları. |
| Tick volume (and real volume if the broker provides it) | true | Hacim sütunları. |
| Spread of the bar (points) | true | Spread sütunu. |
| Bar shape: return, range, body, wicks, gap, log return | true | Bar şekli sütunları. |
| Time features: UTC time, weekday, hour, session | true | Zaman sütunları. |
| Indicators, separated by ; | RSI(14); EMA(20); EMA(50); ATR(14); MACD(12,26,9); BB(20,2) | Aşağıya bakın. Boş = hiçbiri. |
| Custom indicators: Name:buffer,buffer; Name2:0 | (boş) | Kendi göstergeleriniz. |
| Higher-timeframe context (last CLOSED bar), separated by ; | H4; D1 | Satırlardan yüksek olmayan zaman dilimleri atlanır. |
| File name ({symbol} {tf} {date}) | {symbol}_{tf} | {date} = başlangıçtaki sunucu tarihi. |
| Format | CSV, comma separated | Ya da CSV, semicolon separated veya JSON Lines (one object per row) . |
| Time format of the 'time' column | ISO 8601 (2026-10-09T15:30:00) | Ya da Unix seconds veya MetaTrader (2026.10.09 15:30) . |
| Save in the common folder (Terminal\Common\Files) | false | Ortak klasör. |
| Write the data card (.md) | true | Veri kartı. |
| AI snapshot: last N rows as a paste-ready .md (0 = off) | 120 | Yalnızca MT5. En fazla 500. |
| Add a UTF-8 BOM (for Excel) | false | Excel için. |
| Price decimals (-1 = symbol digits) | -1 | Fiyatların ondalık basamak sayısı. |
| Also export this account's deals (closed trades) | false | İşlemler dosyası. |
| Deals of the last N days | 365 | Yalnızca MT5. |
| Server GMT offset in hours (-99 = detect automatically) | -99 | Yalnızca tespit edilen fark yanlışsa ayarlayın. |
| Show the status panel | true | Panel. |
| Panel X (pixels) | 12 | Yalnızca MT5. |
| Panel Y (pixels) | 28 | Yalnızca MT5. |
MT4'te sütun anahtarları 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 ve Columns: UTC time, weekday, hour, session adlarını, işlemler anahtarı ise Also export this account's closed orders adını taşır.
Gösterge adları: SMA, EMA, SMMA, LWMA, DEMA, TEMA, RSI, ATR, MACD, BB, STOCH, ADX, CCI, MFI, WPR, MOM, STDDEV, OBV, AO, SAR ve ICHIMOKU (sonraki barları kullanan Chikou hariç). Parantez olmadan varsayılan değerler kullanılır, örneğin RSI(14) veya MACD(12,26,9). MyIndicator:0,1 , özel bir göstergenin 0 ve 1 numaralı tamponlarını o göstergenin varsayılan girdileriyle dışa aktarır; ad MQL5\Indicators klasörüne göredir (MT4: MQL4\Indicators). Bilinmeyen adlar bir uyarıyla atlanır.
MT4 notları
- Panel, bir Export again düğmesi bulunan birkaç satırlık metinden oluşur.
- AI snapshot yok, gerçek hacim yok, DEMA veya TEMA yok. Geçmiş satırlarında spread_pts boştur, çünkü MT4 her bar için spread saklamaz; canlı eklenen satırlar güncel spread'i alır.
- Satırlarla aynı olan bir üst zaman dilimi sessizce, daha düşük olanı ise bir uyarıyla atlanır. Üst zaman dilimi barları aracı kurumun kendi sınırlarını izler; bazı aracı kurumlar H4 barlarını 01:00'de başlatır.
- İlk seferde H1 (saat dilimi için) ve üst zaman dilimleri aracı kurumdan indirilir; gösterge her biri için yaklaşık bir dakikaya kadar bekler ( Waiting for higher-timeframe history... ). Bir üst zaman dilimi gelmezse hücreleri boş kalır; H1 yoksa saat dilimi için GMT+2 (ABD yaz saatinde GMT+3) kullanılır. Veri kartı bunu belirtir.
- Yeni açılmış bir grafikte çoğu zaman yaklaşık 2,000 bar bulunur. Daha fazlasını yüklemek için geriye kaydırın veya Home tuşuna basın, ardından Export again düğmesine tıklayın. "Max bars in history" ve "Max bars in chart" ayarları (Araçlar > Seçenekler > Grafikler; İngilizce arayüzde: Tools > Options > Charts) da derinliği sınırlar.
- Kapanmış emirler, Hesap Geçmişi (Account History) sekmesinde gösterilenlerdir; daha eski emirleri dâhil etmek için bu sekmenin dönemini değiştirin.
Kullanıcıların sorduğu sorular
- İstediğimden daha az satır mı var? Yalnızca terminalde yüklü olan barlar dışa aktarılabilir. MT5'te "Max bars in chart" değerini artırın (Araçlar > Seçenekler > Grafikler), daha fazla geçmiş yükleyin ve Export again düğmesine tıklayın.
- Durumda is it open in another program? yazıyor. Dosyayı o programda kapatın ve Export again düğmesine tıklayın.
- Bir üst zaman dilimi uyarıyla atlanıyor. H4 veya D1 grafikte varsayılan H4; D1 değeri, satırlardan yüksek olmayan bir zaman dilimi içerir. Onu girdiden çıkarın.
- Birden fazla sembol mü? Her grafiğe bir kopya ekleyin. Varsayılan dosya adıyla her sembol ve zaman dilimi kendi dosyasını alır.
Ürün sayfaları: Smart Data Export Indicator (MT5) ve Smart Data Export Indicator MT4. Anlaşılmayan bir şey olursa lütfen panelin ekran görüntüsünü ve Uzmanlar (Experts) sekmesinin son satırlarını ekleyerek MQL5 üzerinden bana özel mesaj gönderin.
