MT5 · READ ONLY · CSV · v1.20

Советник для твоего журнала

MT5 записывает в файлы открытые и закрытые позиции и состояние счёта. Журнал читает их прямо из папки терминала и сохраняет записи в твой аккаунт Supabase: открытая на демо сделка появляется в журнале сама, тебе остаётся дописать сетап, эмоцию и причину. Советник не открывает сделки, не меняет стопы и не запрашивает пароль.

Исходный код версии 1.20 для первой проверки на демо. Компиляция в MetaEditor и работа в твоём терминале ещё не подтверждены: если MetaEditor покажет ошибку, сохрани её текст. Сам советник ничего не отправляет в сеть; файлы читает журнал в твоём браузере.

Что уточнено в твоём плане

ВопросПрактический вывод
MT5, MT4 или cTrader?Для выбранного MT5-счёта удобен MQL5-репортёр. cTrader имеет официальный Open API для отдельной интеграции. Преимущество зависит от счёта и способа подключения, а не от обещаний доходности.
Советник = автоторговля?Нет. Этот файл только читает историю и записывает CSV. DLL, WebRequest и торговые разрешения ему не нужны.
Одно исполнение = одна позиция?Не всегда. Частичные исполнения агрегируются по идентификатору позиции. Открытая позиция выгружается как открытая и остаётся той же записью, когда закроется. Развороты пропускаются.
Терминал выключен?Файлы не обновляются, но стоп и тейк хранятся на сервере брокера и сработают. После запуска заново читается доступная история с HistoryFrom, и журнал догоняет пропущенное. Полнота зависит от истории, которую вернул брокер.
Стабильная прибыль?Репортёр помогает учёту, но не проверяет качество стратегии и не гарантирует прибыль или соблюдение проп-лимитов.

Установка: шаг за шагом

  1. Начни с демо / Free Trial. Открой настольный MetaTrader 5 от твоего брокера. Этот файл не подходит для MT4, мобильного приложения или веб-терминала.
  2. Скачай файл выше. В MT5 выбери File → Open Data Folder → MQL5 → Experts. Скопируй туда TK_Journal_Reporter.mq5.
  3. Скомпилируй. Нажми F4, открой файл в MetaEditor и нажми F7 / Compile. Продолжай только если внизу указано 0 errors. Если есть ошибка — сохрани её текст; файл .ex5 вручную переименовывать не нужно.
  4. Добавь на один отдельный график. В MT5 открой Navigator → Expert Advisors → Refresh. Перетащи TK_Journal_Reporter на свободный график. Достаточно одного экземпляра на счёт, любой инструмент. Не заменяй им уже работающего торгового советника.
  5. Настрой. HistoryFrom — начало нужной истории, по умолчанию 01.01.2020. RefreshSeconds — как часто переписывать файлы, по умолчанию 15 секунд, минимум 5. DayResetHour — начало торгового дня: -1 означает полночь по Праге, как у FTMO; для другой фирмы укажи час по времени сервера. ExportQuotes — записывать ли цены инструментов из «Обзора рынка», по умолчанию да. Algo Trading, DLL и WebRequest включать не нужно.
  6. Дождись выгрузки. На графике появятся счёт, число открытых и закрытых позиций, результат закрытых сделок за день и риск до текущих стопов. При переключении счёта удали и заново прикрепи репортёр.
  7. Найди файлы. File → Open Data Folder → MQL5 → Files. Там три файла CSV: MT5_Journal_НОМЕРСЧЁТА.csv со сделками, MT5_Account_НОМЕРСЧЁТА.csv с балансом и эквити и MT5_Quotes_НОМЕРСЧЁТА.csv с ценами инструментов. Рядом появляются картинки графика MT5_Shot_НОМЕРСЧЁТА_ПОЗИЦИЯ_open.png и …_close.png. Не редактируй их и не держи открытыми в Excel: пока файл открыт, советник не может его обновить.
  8. Подключи папку к журналу. В Chrome или Edge на компьютере открой «Новая сделка», войди по email и в блоке MetaTrader 5 нажми «Подключить папку MT5». Выбери папку MQL5 → Files и разреши чтение. Дальше журнал сам проверяет файлы каждые 15 секунд, пока вкладка открыта. После перезапуска браузера может понадобиться один раз нажать «Возобновить доступ». Журнал только читает папку и ничего в неё не пишет.
  9. Или импортируй вручную. В Firefox, Safari и на телефоне доступа к папке нет. Нажми «Импорт Broker CSV» и выбери оба файла сразу.
  10. Допиши своё. Новая сделка появляется в таблице «Открытые» с ценой входа, стопом, тейком, лотом и риском. В блоке MetaTrader 5 в строке «Дополнить» нажми на сделку и запиши сетап, эмоцию и причину входа. Когда позиция закроется в MT5, запись обновится сама, твои заметки останутся.
  11. Сверь одну позицию. Сравни инструмент, направление, лоты, цены, стоп, дату и Net PNL с историей MT5. Проверь валюту счёта и баланс на начало дня на странице «Система».

Что входит в расчёт

Закрытая позиция — одна строка. Цены входа и выхода взвешены по объёму; объём — суммарные лоты входов. Net PNL = сумма DEAL_PROFIT + DEAL_COMMISSION + DEAL_SWAP + DEAL_FEE по связанным исполнениям. Балансовые корректировки и комиссии без привязки к позиции не включены: сверяй итог с отчётом брокера.

Открытая позиция — одна строка с текущей ценой и плавающим результатом. Эти две цифры журнал показывает, но не сохраняет: они меняются каждые несколько секунд.

Стоп, тейк и риск. Берётся стоп, который стоял в момент входа: по нему считаются плановый риск в деньгах и в процентах от размера счёта и плановый R:R. Если ты поставила стоп уже после входа, берётся последний известный. Журнал запоминает первый увиденный стоп и не меняет его, когда ты переносишь стоп в безубыток: иначе риск сделки задним числом стал бы нулевым.

Время. В файле время сервера брокера и его смещение от UTC на момент выгрузки. Журнал переводит его в настоящее время, дату считает по Праге и сам ставит сессию. Если сделка выгружена уже после перевода часов, её время может сместиться на час; время однажды сохранённой сделки журнал не трогает.

Счёт. Баланс, эквити, первый депозит как размер счёта, баланс на начало торгового дня, результат закрытых сделок и число сделок за день, риск от текущей цены до текущих стопов и число позиций без стопа. Проценты лимитов задаются на странице «Система»; советник правил фирмы не знает и торговлю не блокирует.

R, MAE и MFE. Риск в деньгах на входе журнал сохраняет один раз и считает по нему результат сделки в R. MAE — худший плавающий результат за время жизни позиции, MFE — лучший; оба считаются по минутным свечам и поэтому точны до минуты: в первую и последнюю минуту в расчёт попадают цены чуть раньше входа и чуть позже выхода. Для коротких позиций к свече добавляется её спред. Пока позиция открыта, эти цифры только показываются; сохраняются они после закрытия.

Картинки графика. Когда позиция открывается или закрывается, советник сохраняет картинку графика этого инструмента, а журнал при синхронизации папки прикрепляет её к сделке. Берётся уже открытый график инструмента с твоим таймфреймом и разметкой. Если такого графика нет, советник на несколько секунд откроет временный и закроет его сам; это можно выключить параметром ShotOpenChart, а все картинки — параметром ChartShots. Снимок делается при очередной выгрузке, то есть с задержкой до RefreshSeconds. Позиции, уже открытые в момент запуска советника, не фотографируются. Картинки копятся в папке MQL5 → Files; старые можно удалять, в журнале они уже сохранены. При ручном импорте CSV картинки не подхватываются — только при подключённой папке.

Цены инструментов. Bid и ask каждого символа из окна «Обзор рынка» твоего терминала. По ним журнал показывает в поле «Тикер» список инструментов твоего счёта с ценой брокера, включая индексы и сырьё, для которых нет бесплатного открытого источника. Чтобы инструмент попал в список, добавь его в «Обзор рынка».

Развороты, неподдерживаемые операции и позиции, открытые до HistoryFrom, пропускаются. Повторное чтение того же файла не создаёт дубликаты; сделки, импортированные версией 1.00, распознаются и дополняются. Не переименовывай файлы.

Если что-то не работает

Перед автоматическим подключением

Для прямой отправки потребуется отдельный отзывной ключ, привязанный к твоему пользователю и счёту, серверный приёмник, защита от дублей и повторная доставка. Общий ключ для всех пользователей использовать нельзя. Ключ репортёра должен быть и в терминале: утверждение «все ключи только на сервере» к такому подключению неприменимо. Ключ Supabase service_role нельзя помещать в советник или публичный сайт.

При сетевой версии обработчик OnTradeTransaction только отмечает изменения; отправка выполняется отдельно по таймеру. WebRequest синхронный и не работает в Strategy Tester. Версия 1.20 сеть не использует: файлы читает журнал в браузере.

Официальные источники

MetaQuotes: свойства исполнений · WebRequest · OnTradeTransaction · FTMO: допустимые стратегии

Условия FTMO и конкретного продукта проверяй перед началом: разрешение на советники не означает разрешение на любую стратегию.