Trade Journal with Excursion Stats and Screenshots
- Утилиты
-
Kazuma Uezono
MQL5 / MQL4 / Pine Script v6 developer and active trader.
Seller on the MQL5 Market (indicators for MT4/MT5).
Services:
- TradingView Pine Script to MT5/MT4 conversion (bar-by-bar matching, with tester report)
- MT4 to MT5 migration - Версия: 1.2
- Активации: 5
Trade Journal with Excursion Stats and Screenshots — служебный советник (утилита) для MetaTrader 5, который ведёт журнал ваших закрытых сделок. Для каждой закрытой позиции он записывает одну строку в CSV-файл: открытие и закрытие, прибыль, комиссию и своп, MAE и MFE (Maximum Adverse Excursion — насколько цена ушла против сделки; Maximum Favorable Excursion — насколько она ушла в её пользу), R-мультипликатор и время удержания. Он также создаёт HTML-сводку и, если открыт график этого символа, сохраняет скриншот графика при входе и при выходе. Записываются ваши ручные сделки и сделки других ваших советников; можно фильтровать по символу и магическому номеру.
Это запись прошлых сделок, а не торговая стратегия. Советник не даёт сигналов на покупку или продажу, не оценивает, хороша ли сделка или метод, и не обещает и не улучшает никакой результат. На реальном и демо-счёте он никогда не открывает, не закрывает и не изменяет позиции и ордера. (Только в тестере стратегий он открывает небольшие демонстрационные сделки; см. «Примечания и ограничения».)
Конфиденциальность: советник не записывает номер счёта, имя сервера и баланс ни в файлы, ни на скриншоты, и панель их не показывает. Папка называется по имени журнала, которое вы выбираете (по умолчанию "MyJournal"). Чтобы два счёта не смешивались в одном журнале, owner.txt хранит только короткий хеш, а не номер счёта или имя сервера. Скриншоты показывают только график; всё, что другие индикаторы, советники или комментарии рисуют на том же графике, попадает на снимок как есть.
Возможности
- CSV-журнал (journal.csv), одна строка на закрытую позицию, 32 столбца: ID позиции, символ, направление, лоты, время и цена открытия и закрытия, начальные SL и TP и их источник, прибыль, комиссия, своп, итог (net), пипсы, время удержания, MAE и MFE (ценовое расстояние, пипсы, деньги), источник данных MAE/MFE, сумма риска, R-мультипликатор, изображения входа и выхода, магический номер, комментарий и заметка (например close: SL, close: TP, частичные закрытия).
- HTML-сводка (journal.html): количество сделок, общий итог, средний R, средние MAE и MFE (в пипсах для FX и в R) для всех сделок, прибыльных и убыточных; таблицы распределения MAE и MFE в R и в пипсах; последние сделки со ссылками на их изображения. Все цифры рассчитываются только по сделкам из вашего журнала.
- Скриншоты графика (PNG) при входе и при выходе, сохраняются в папке images журнала, со ссылками из HTML.
- MAE и MFE обновляются на каждом тике, пока сделка открыта. Периоды, когда советник не работал, заполняются из тиковой истории, если она доступна, иначе по барам M1.
- При запуске добавляются закрытые сделки за последние N дней, которых ещё нет в журнале (по умолчанию 7 дней).
- Без дубликатов: записанные сделки запоминаются, поэтому перезапуск, смена таймфрейма или второй график с тем же именем журнала не записывают сделку дважды.
- Фильтры: символы, магические номера, ручные сделки вкл./выкл.
- Панель: имя журнала, записанные сделки, отслеживаемые сделки, последняя записанная сделка и сообщения о состоянии. Английский или японский (автоматически по языку терминала); HTML использует тот же язык.
- Разделитель CSV: запятая или точка с запятой (для Excel в регионах, где десятичный разделитель — запятая).
Основные параметры
- Trades to record: символы (пусто = все), магические номера (пусто = все советники), включать ручные сделки (по умолчанию ВКЛ), при запуске добавлять незаписанные закрытые сделки за последние N дней (по умолчанию 7, 0 = нет).
- Files: имя журнала = имя папки (по умолчанию "MyJournal"; это не номер вашего счёта), разделитель CSV (только для нового файла), HTML-сводка ВКЛ/ВЫКЛ, число последних сделок в HTML (по умолчанию 1000).
- MAE / MFE: используемая цена (сторона закрытия = Bid для покупок и Ask для продаж, по умолчанию; или цена графика Bid для обеих), заполнять пропущенные периоды из тиковой истории (по умолчанию ВКЛ) для периодов до N часов (по умолчанию 24; более длинные периоды — по барам M1).
- Screenshots: ВКЛ/ВЫКЛ (по умолчанию ВКЛ), ширина и высота изображения (по умолчанию 1280 x 720).
- Панель (показ, язык, угол, смещения, размер шрифта) и демонстрационные сделки в тестере стратегий ВКЛ/ВЫКЛ.
- 21 параметр в 6 группах.
Как это работает
- Файлы записываются в MQL5\Files\TradeJournal\<имя журнала>\ : journal.csv, journal.html, папка images и небольшие служебные файлы (written_ids.txt, open_state.txt, owner.txt). Откройте её через Файл > Открыть каталог данных.
- MAE и MFE — расстояния от цены открытия, записываются как положительные значения в цене, пипсах и деньгах. По умолчанию покупки измеряются по Bid, продажи по Ask (цене, по которой сделка закрылась бы). Параметр переключает на цену графика (Bid) для обеих.
- Пока советник работает, MAE и MFE считаются по тиковой истории каждого символа, поэтому ни один тик не пропускается.
- Периоды, когда советник не был прикреплён или был остановлен, заполняются из тиковой истории (до заданного числа часов) или по максимумам и минимумам баров M1. Столбец mae_mfe_source показывает tick, bar или tick+bar, а также "(incomplete)", если данных не хватало.
- Бар входа и бар выхода: используется только часть после входа и до выхода. При наличии тиковой истории эта часть измеряется по тикам. Без тиковой истории используются только закрытие бара входа и открытие бара выхода; максимум и минимум этих двух баров не учитываются, так как они могут лежать до входа или после выхода. Поэтому движения внутри этих двух баров могут быть пропущены. Период короче одной минуты использует только цены открытия и закрытия.
- Если продажи измеряются по Ask и используются бары M1, к значениям бара добавляется спред этого бара, поэтому такие значения являются оценочными.
- Чтобы читать бары и тики символа, советник может добавить этот символ в Обзор рынка (SymbolSelect).
- Пипсы показываются только для символов с 3 или 5 знаками после запятой (обычно валютные пары FX); 10 пунктов = 1 пипс. Для других символов (золото, индексы, криптовалюты и т. д.) столбцы пипсов пустые; используйте столбцы цены и денег. Таблицы и средние значения в пипсах в HTML строятся только по сделкам FX. Если ваш брокер котирует символ, не относящийся к FX, с 3 или 5 знаками, он тоже получает значение в пипсах.
- R-мультипликатор = итог (прибыль + комиссия + своп) / начальный риск. Начальный риск = расстояние от цены открытия до первого стоп-лосса x лоты, пересчитанное в валюту счёта по курсу на момент записи сделки. Первый стоп-лосс берётся из ордера, открывшего позицию. У сделок без стоп-лосса R пустой.
- Неттинговые счета: добавленный объём использует среднюю цену открытия. Для развёрнутой позиции MAE/MFE = n/a и R не рассчитывается.
- Скриншоты делаются только тогда, когда график символа сделки уже открыт в терминале. Если такого нет, журнал показывает "no chart"; советник никогда не открывает новый график. Если сохранить не удалось, журнал показывает "failed", панель выводит сообщение, и запись продолжается. Другие значения: "off" (скриншоты ВЫКЛ) и "EA off" (советник в этот момент не работал).
Примечания и ограничения
- Это не сигнал и не оценка. Цифры описывают ваши прошлые сделки. Как вы их понимаете и как торгуете — ваше решение. Прошлые результаты не показывают будущих результатов.
- MAE/MFE, заполненные по барам M1, приблизительны, а движения внутри баров входа и выхода могут быть пропущены, если тиковая история недоступна.
- Используйте одно имя журнала на один счёт. Если другой счёт использует то же имя журнала, советник прекращает запись и просит другое имя. Если вы войдёте в другой счёт во время работы, запись останавливается, пока вы снова не прикрепите советник с другим именем.
- Если одно и то же имя журнала работает на двух графиках, пишет только один график. Другой ждёт и берёт работу на себя, если первый остановится (примерно в течение 15 секунд).
- Пока journal.csv открыт в Excel, в него нельзя записывать. Советник повторяет попытку каждые 5 секунд и показывает это на панели; сделки сохраняются и записываются, когда файл освободится. Чтобы смотреть данные во время записи, откройте копию.
- Советник записывает только пока MetaTrader 5 запущен. Сделки, закрытые, пока он был выключен, добавляются при следующем запуске, если они попадают в последние N дней.
- Тестер стратегий: при включённом параметре "Tester only: small demo trades to show the journal" (по умолчанию) советник открывает небольшие демонстрационные сделки, чтобы журнал можно было увидеть: минимальный лот, magic 73250, не более одной в день, покупка и продажа по очереди, каждая со стоп-лоссом и тейк-профитом и закрытием примерно через 3 часа. Они нужны только для показа записи; это не торговый метод, не сигнал и не привязка к какому-либо рыночному времени (около смены дня, когда спреды широкие, они не открываются). Отчёт тестера показывает только эти сделки и не является торговым результатом; он может быть убыточным. В тестере скриншоты не делаются. Эти сделки никогда не выполняются на реальном или демо-счёте.
Совместимость и поддержка
- MetaTrader 5 (счета с хеджированием и неттингом). Версия для MetaTrader 4 продаётся отдельно.
- Прикрепите его к одному графику. Для скриншотов держите открытым график каждого торгуемого символа.
- Без DLL, без интернета, без внешнего сервера. Все файлы остаются на вашем компьютере.
- Сначала попробуйте на демо-счёте.
- Поддержка через сообщения MQL5, ответ в течение 3 рабочих дней: установка, настройки, файлы и сообщения об ошибках. Мы не можем проверять или оценивать ваши сделки, предлагать уровни стопа или цели, давать взгляды на рынок или торговые решения.
- Никакой результат вашей торговли не обещается и не подразумевается.
