Smart Data Export Indicator (MT5/MT4): руководство пользователя, файлы CSV и JSON Lines, столбцы и настройки
Smart Data Export Indicator — бесплатный индикатор для MetaTrader 5, который записывает данные графика в файлы CSV или JSON Lines с выбранными вами столбцами и карточкой данных, объясняющей каждый столбец. Он предназначен для тех, кто анализирует свои графики с помощью ИИ-ассистента, например ChatGPT или Claude, электронной таблицы или Python. Smart Data Export Indicator MT4 — бесплатная версия для MetaTrader 4; отличия отмечены ниже. Обе версии заменяют мой бесплатный SmartDataExportEa. Руководство относится к версии 1.00.
Что записывает индикатор
- Файл данных (CSV или JSON Lines): одна строка на каждый закрытый бар, от старых к новым. Новые бары дописываются по мере закрытия.
- Карточка данных (data card, .md): единицы измерения, строки прогрева, часовой пояс и качество данных, а также промпт для ИИ-ассистента.
- AI snapshot (снимок для ИИ, .md, только MT5): последние бары в виде таблицы для вставки в чат.
- Сделки (необязательно): сделки этого счёта (MT5) или закрытые ордера (MT4).
Значения старших таймфреймов берутся только из баров, которые к тому моменту уже закрылись (без заглядывания в будущее). Индикатор не выставляет ордеров, не использует DLL и не делает веб-запросов, поэтому может работать на одном графике с вашим советником.
Установка
- На странице продукта (MT5 или MT4) нажмите кнопку бесплатной загрузки (Free Download) — откроется MetaTrader. Индикатор также можно найти в MetaTrader в разделе Инструменты > Маркет. Установленные продукты перечислены в разделе Инструменты > Маркет > Покупки, где также появляются обновления (Обновить).
- Перетащите индикатор из раздела Навигатор > Индикаторы > Market на график. Значения по умолчанию рабочие, так что можно просто нажать OK.
Экспорт по шагам
- Откройте график символа. Строки используют таймфрейм графика, если вы не задали Timeframe of the rows .
- Установите индикатор на график, выберите Range (по умолчанию последние 5000 закрытых баров), столбцы и индикаторы, например RSI(14); EMA(50); ATR(14) , и нажмите OK.
- Следите за статусом на панели: сначала — чего индикатор ждёт, затем Exporting history... , затем History done - appending new bars as they close (или Export finished , если в After the history выбрана остановка).
Статус зелёный, когда работа завершена, оранжевый — во время работы или ожидания и красный — после ошибки. Предупреждения, например о неизвестном названии индикатора, показываются оранжевым после знака ! и на вкладке «Эксперты». Export again заново читает историю и перезаписывает все файлы.
Куда записываются файлы и что в них
Файлы записываются в MQL5\Files\SmartDataExport (MT4: MQL4\Files\SmartDataExport ; Файл > Открыть каталог данных) или, если включён параметр общей папки, в Terminal\Common\Files\SmartDataExport . В тестере стратегий они записываются в папку агента тестирования (MT4: tester\files ), без AI snapshot.
При каждом запуске экспорта (установка на график, изменение входного параметра, перезапуск MetaTrader, Export again) файл данных заново записывается из истории; после этого строки только добавляются. Чтобы сохранить старый файл, скопируйте его или добавьте {date} в имя файла.
Файл данных, например XAUUSD_M15.csv (или .jsonl ). Каждая строка начинается со времени открытия бара по серверу. В CSV-файлах есть строка заголовков и используется десятичная точка; отсутствующие значения пусты (null в JSON Lines). Далее идут:
- open, high, low, close, tick_volume , real_volume (MT5, если брокер его предоставляет), spread_pts .
- В пунктах: ret_pts (close - open), range_pts, body_pts, upper_wick_pts, lower_wick_pts , gap_pts (open - предыдущий close); а также log_ret = ln(close / предыдущий close).
- time_utc (смещение определяется для каждой недели, поэтому переход на летнее время учитывается), dow_utc (1 = понедельник), hour_utc , session : tokyo (9–18 JST), london (8–17 по лондонскому времени), newyork (8–17 по нью-йоркскому времени), объединённые через + или off.
- Индикаторы, названные по своим настройкам, например rsi_14 или macd_signal_12_26_9 ; буферы пользовательских индикаторов — как custom_<name>_<buffer> .
- Столбцы от h4_open до d1_close (таймфреймы по умолчанию): последние бары H4 и D1, закрывшиеся к моменту закрытия строки.
Карточка данных, XAUUSD_M15.datacard.md , записывается, когда экспорт истории завершён: набор данных, спецификация символа, часовой пояс, каждый столбец с единицей измерения, смыслом и строками прогрева, отчёт о качестве (перерывы, пропуски, повторяющиеся значения времени, бары с нулевым диапазоном, всплески диапазона и, в MT5, скачки спреда) и промпт для копирования. Карточка MT4 также перечисляет предупреждения.
Сделки: deals_last_365d.csv (MT5) с символом, типом, объёмом, ценой, прибылью, комиссией, свопом, магическим номером и причиной или closed_orders.csv (MT4) со временем, ценами, прибылью, комиссией, свопом, магическим номером и стоп-лоссом.
Работа с файлами в ИИ-ассистенте или электронной таблице
- Вопросы об истории. Приложите к чату файл данных и карточку данных, скопируйте промпт из конца карточки и напишите свой вопрос в его последней строке. Промпт просит ассистента считать каждую строку известной только на момент её закрытия, отбросить строки прогрева, разделить данные по времени и приводить доверительные интервалы.
- Текущий рынок (MT5). Вставьте XAUUSD_M15.snapshot.md : последние 120 закрытых баров (до 500) со временем UTC, bid и ask, до 8 столбцов индикаторов и идеей для промпта. Файл перезаписывается на каждом новом баре, пока индикатор дописывает данные.
- Ассистент видит только те строки, которые вы ему дали. Относитесь к его выводам как к идеям для проверки, а не как к сигналам.
- Excel и Python могут читать файл, пока в него добавляются строки. Для Excel есть опция UTF-8 BOM, а также формат с точкой с запятой. Если программа блокирует файл, новые строки ждут, пока он освободится.
- Строки прогрева перечислены в карточке данных. В MT5 значения индикаторов в них рассчитаны по короткой истории; MT4 оставляет их пустыми.
Входные параметры
Названия — это подписи на вкладке «Входные параметры».
| Параметр | По умолчанию | Назначение |
|---|---|---|
| Timeframe of the rows | current | current = таймфрейм графика. |
| Range | Last N closed bars | Или Date range (From / To) , или All available history . |
| Last N closed bars (Range = last N bars) | 5000 | Число баров для экспорта. |
| From (Range = date range) | 2024.01.01 00:00 | Начало диапазона дат. |
| To (0 = up to the last closed bar) | 0 | Конец диапазона дат. |
| After the history | Keep appending each new closed bar | Или Stop after the history export . |
| Open, High, Low, Close | true | Ценовые столбцы. |
| Tick volume (and real volume if the broker provides it) | true | Столбцы объёма. |
| Spread of the bar (points) | true | Столбец спреда. |
| Bar shape: return, range, body, wicks, gap, log return | true | Столбцы формы бара. |
| Time features: UTC time, weekday, hour, session | true | Столбцы времени. |
| Indicators, separated by ; | RSI(14); EMA(20); EMA(50); ATR(14); MACD(12,26,9); BB(20,2) | См. ниже. Пусто = без индикаторов. |
| Custom indicators: Name:buffer,buffer; Name2:0 | (пусто) | Ваши собственные индикаторы. |
| Higher-timeframe context (last CLOSED bar), separated by ; | H4; D1 | Таймфреймы, которые не старше таймфрейма строк, пропускаются. |
| File name ({symbol} {tf} {date}) | {symbol}_{tf} | {date} = серверная дата на момент запуска. |
| Format | CSV, comma separated | Или CSV, semicolon separated , или JSON Lines (one object per row) . |
| Time format of the 'time' column | ISO 8601 (2026-10-09T15:30:00) | Или Unix seconds , или MetaTrader (2026.10.09 15:30) . |
| Save in the common folder (Terminal\Common\Files) | false | Общая папка. |
| Write the data card (.md) | true | Карточка данных. |
| AI snapshot: last N rows as a paste-ready .md (0 = off) | 120 | Только MT5. До 500. |
| Add a UTF-8 BOM (for Excel) | false | Для Excel. |
| Price decimals (-1 = symbol digits) | -1 | Число десятичных знаков цены. |
| Also export this account's deals (closed trades) | false | Файл сделок. |
| Deals of the last N days | 365 | Только MT5. |
| Server GMT offset in hours (-99 = detect automatically) | -99 | Задавайте, только если определённое смещение неверно. |
| Show the status panel | true | Панель. |
| Panel X (pixels) | 12 | Только MT5. |
| Panel Y (pixels) | 28 | Только MT5. |
В MT4 переключатели столбцов называются 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 и Columns: UTC time, weekday, hour, session , а переключатель сделок — Also export this account's closed orders .
Названия индикаторов: SMA, EMA, SMMA, LWMA, DEMA, TEMA, RSI, ATR, MACD, BB, STOCH, ADX, CCI, MFI, WPR, MOM, STDDEV, OBV, AO, SAR и ICHIMOKU (без Chikou, которая использует более поздние бары). Без скобок используются значения по умолчанию, например RSI(14) или MACD(12,26,9). MyIndicator:0,1 экспортирует буферы 0 и 1 пользовательского индикатора с его входными параметрами по умолчанию; имя указывается относительно MQL5\Indicators (MT4: MQL4\Indicators). Неизвестные названия пропускаются с предупреждением.
Примечания для MT4
- Панель — это несколько строк текста с кнопкой Export again.
- Нет AI snapshot, реального объёма, DEMA и TEMA. spread_pts пуст для исторических строк, потому что MT4 не хранит спред для каждого бара; строки, дописанные в реальном времени, получают текущий спред.
- Старший таймфрейм, равный таймфрейму строк, пропускается без предупреждения, а более младший — с предупреждением. Бары старших таймфреймов следуют собственным границам брокера; у некоторых брокеров бары H4 начинаются в 01:00.
- При первом запуске H1 (для часового пояса) и старшие таймфреймы загружаются с сервера брокера; индикатор ждёт каждый из них примерно до минуты ( Waiting for higher-timeframe history... ). Если старший таймфрейм не поступит, его ячейки останутся пустыми; без H1 часовой пояс принимается равным GMT+2 (GMT+3 в период летнего времени США). Карточка данных сообщает об этом.
- На только что открытом графике часто около 2,000 баров. Прокрутите график назад или нажмите Home, чтобы загрузить больше, затем нажмите Export again. Глубину также ограничивают параметры «Макс. баров в истории» (Max bars in history) и «Макс. баров в окне» (Max bars in chart) в разделе Сервис > Настройки > Графики.
- Закрытые ордера — это ордера, показанные на вкладке «История счета»; измените её период, чтобы включить более старые ордера.
Вопросы пользователей
- Строк меньше, чем я просил? Экспортировать можно только бары, загруженные в терминал. В MT5 увеличьте «Макс. баров в окне» (Max bars in chart) в разделе Сервис > Настройки > Графики, загрузите больше истории и нажмите Export again.
- В статусе написано is it open in another program? Закройте файл в той программе и нажмите Export again.
- Старший таймфрейм пропускается с предупреждением. На графике H4 или D1 значение по умолчанию H4; D1 содержит таймфрейм, который не старше таймфрейма строк. Удалите его из входного параметра.
- Несколько символов? Установите по копии индикатора на каждый график. С именем файла по умолчанию у каждого символа и таймфрейма будет свой файл.
Страницы продуктов: Smart Data Export Indicator (MT5) и Smart Data Export Indicator MT4. Если что-то непонятно, напишите мне личное сообщение на MQL5 и приложите скриншот панели и последние строки вкладки «Эксперты».
