SAR MANAGER РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ / USER GUIDE Версии для MetaTrader 4 и MetaTrader 5 / Versions for MetaTrader 4 and MetaTrader 5 Версия продукта / Product version: 1.01 ====================================================================== РУССКАЯ ВЕРСИЯ ====================================================================== 1. НАЗНАЧЕНИЕ ИНДИКАТОРА SAR Manager — информационно-сигнальный индикатор на основе стандартного Parabolic SAR. Он показывает направление SAR, формирует сигналы BUY и SELL, рассчитывает виртуальные уровни Entry, Stop Loss и Take Profit, отмечает входы и выходы на графике, отправляет уведомления и отображает статистику сигналов. Индикатор не открывает, не изменяет и не закрывает реальные торговые ордера. Все позиции, уровни и результаты в таблице являются виртуальными. 2. УСТАНОВКА В METATRADER 5 1) Откройте MetaTrader 5. 2) Выберите File -> Open Data Folder. 3) Откройте папку MQL5 -> Indicators. 4) Скопируйте файл SAR_Signal_Manager_MT5.mq5 в эту папку. 5) Откройте файл в MetaEditor и нажмите F7 для компиляции. 6) Вернитесь в MetaTrader 5. 7) В окне Navigator нажмите правой кнопкой мыши на Indicators и выберите Refresh. При необходимости перезапустите терминал. 8) Перетащите SAR Signal Manager на нужный график. 3. УСТАНОВКА В METATRADER 4 1) Откройте MetaTrader 4. 2) Выберите File -> Open Data Folder. 3) Откройте папку MQL4 -> Indicators. 4) Скопируйте файл SAR_Signal_Manager_MT4.mq4 в эту папку. 5) Откройте файл в MetaEditor и нажмите F7 для компиляции. 6) Вернитесь в MetaTrader 4. 7) В окне Navigator нажмите правой кнопкой мыши на Indicators и выберите Refresh. При необходимости перезапустите терминал. 8) Перетащите SAR Signal Manager на нужный график. 4. ЛОГИКА СИГНАЛОВ BUY: Сигнал формируется, когда Parabolic SAR переходит из положения над ценой под цену. Разворот подтверждается после закрытия свечи. Виртуальный вход рассчитывается по цене открытия следующей свечи. SELL: Сигнал формируется, когда Parabolic SAR переходит из положения под ценой над цену. Разворот подтверждается после закрытия свечи. Виртуальный вход рассчитывается по цене открытия следующей свечи. Подтверждённые сигналы используют только закрытые свечи. Текущая незавершённая свеча не используется для подтверждения нового направления. Одновременно индикатор учитывает не более одной виртуальной позиции. При появлении противоположного подтверждённого сигнала активная виртуальная позиция закрывается по причине SAR reversal, после чего рассчитывается вход в новом направлении. 5. ЛОГИКА STOP LOSS И TAKE PROFIT Расстояния Stop Loss и Take Profit задаются в пунктах MetaTrader (points). Для BUY: - Stop Loss располагается ниже Entry; - Take Profit располагается выше Entry. Для SELL: - Stop Loss располагается выше Entry; - Take Profit располагается ниже Entry. На пятизначной валютной котировке 100 points соответствуют 10 стандартным пипсам. Учитывайте количество знаков конкретного инструмента при настройке уровней. Возможные причины выхода: - Stop Loss; - Take Profit; - SAR reversal; - Stop Loss gap; - Take Profit gap. Если новая свеча открылась за уровнем Stop Loss или Take Profit, индикатор учитывает гэп и использует фактическую цену открытия свечи. Если внутри одной исторической свечи были достигнуты одновременно Stop Loss и Take Profit, порядок движения цены невозможно установить по данным OHLC. Параметр InpSameBarPolicy определяет правило расчёта: - SAME_BAR_SL_FIRST — первым считается Stop Loss. Это консервативный режим, установленный по умолчанию; - SAME_BAR_TP_FIRST — первым считается Take Profit. 6. ЭЛЕМЕНТЫ НА ГРАФИКЕ - Точки Parabolic SAR показывают текущее положение стандартного SAR. - Зелёная стрелка обозначает виртуальный вход BUY. - Красная стрелка обозначает виртуальный вход SELL. - Оранжевый маркер обозначает выход из виртуальной позиции. - Синяя линия Entry показывает расчётную цену входа. - Красная линия Stop Loss показывает защитный уровень. - Зелёная линия Take Profit показывает целевой уровень. - Возле линий отображаются названия и цены уровней. Если InpKeepLastLevels = true, последние уровни Entry, Stop Loss и Take Profit сохраняются на графике после выхода. Если установлено false, линии удаляются после закрытия виртуальной позиции. 7. ИНФОРМАЦИОННАЯ ТАБЛИЦА SAR SIGNAL MANAGER — название индикатора. Symbol / Timeframe — текущий инструмент и таймфрейм. Signal — текущее состояние: - BUY / ACTIVE; - SELL / ACTIVE; - BUY / WAIT; - SELL / WAIT. SAR trend — текущее направление Parabolic SAR: BULLISH или BEARISH. Entry — цена последнего или активного виртуального входа. Stop Loss — рассчитанный Stop Loss и его расстояние в пунктах. Take Profit — рассчитанный Take Profit и его расстояние в пунктах. Risk / Reward — отношение расстояния до Stop Loss к расстоянию до Take Profit. Entries BUY / SELL — количество рассчитанных входов каждого направления. Closed — количество закрытых виртуальных позиций. W / L / BE: - W — виртуальные позиции с положительным результатом; - L — виртуальные позиции с отрицательным результатом; - BE — безубыточные результаты. Net points — суммарный результат закрытых виртуальных позиций в пунктах. Last exit — направление, причина и цена последнего выхода. Статистика рассчитывается только в пределах количества свечей, заданного в InpHistoryBars. Открытая виртуальная позиция не включается в число Closed до момента выхода. 8. ВХОДНЫЕ ПАРАМЕТРЫ PARABOLIC SAR InpSarStep = 0.02 Шаг ускорения Parabolic SAR. Меньшее значение делает SAR менее чувствительным, а большее — более чувствительным к изменению цены. InpSarMaximum = 0.20 Максимальное значение ускорения Parabolic SAR. INFORMATION InpMyProfile Ссылка My profile на профиль разработчика MQL5. SIGNALS AND LEVELS InpStopLossPoints = 300 Расстояние от Entry до Stop Loss в пунктах. InpTakeProfitPoints = 600 Расстояние от Entry до Take Profit в пунктах. InpArrowOffsetPoints = 30 Визуальный отступ стрелок входа от цены. InpHistoryBars = 3000 Количество свечей, используемых для сигналов и виртуальной статистики. Минимально допустимое значение — 10. InpSameBarPolicy = SAME_BAR_SL_FIRST Правило расчёта, если одна историческая свеча достигла одновременно SL и TP. InpShowLevelLines = true Показывать линии Entry, Stop Loss и Take Profit. InpKeepLastLevels = true Оставлять последние уровни на графике после выхода. NOTIFICATIONS InpEntryAlerts = true Разрешить уведомления о виртуальных входах. InpExitAlerts = true Разрешить уведомления о виртуальных выходах. InpAlertPopup = true Показывать всплывающие сообщения MetaTrader. InpAlertPush = false Отправлять Push-уведомления на мобильное устройство. InpAlertEmail = false Отправлять уведомления по электронной почте. InpAlertSound = false Воспроизводить звуковой файл при событии. InpAlertSoundFile = alert.wav Название звукового файла из папки Sounds терминала. APPEARANCE InpSarColor — цвет точек SAR. InpBuyColor — цвет стрелок BUY. InpSellColor — цвет стрелок SELL. InpExitColor — цвет маркеров выхода. InpEntryLineColor — цвет линии Entry. InpStopLineColor — цвет линии Stop Loss. InpTakeLineColor — цвет линии Take Profit. InpShowPanel — показать или скрыть информационную таблицу. InpPanelX — горизонтальное положение таблицы в пикселях. InpPanelY — вертикальное положение таблицы в пикселях. InpPanelBackground — цвет фона таблицы. InpPanelBorder — цвет рамки таблицы. InpPanelText — основной цвет текста. 9. НАСТРОЙКА УВЕДОМЛЕНИЙ Popup: Достаточно установить InpAlertPopup = true. Push: 1) Откройте Tools -> Options -> Notifications. 2) Включите Push notifications. 3) Укажите MetaQuotes ID мобильного приложения MetaTrader. 4) Выполните тестовую отправку. 5) Установите InpAlertPush = true. Email: 1) Откройте Tools -> Options -> Email. 2) Настройте SMTP-сервер, логин, пароль, адрес отправителя и получателя. 3) Выполните тестовую отправку. 4) Установите InpAlertEmail = true. Sound: 1) Убедитесь, что файл находится в папке Sounds терминала. 2) Укажите его имя в InpAlertSoundFile. 3) Установите InpAlertSound = true. После первого подключения индикатор не отправляет уведомления по старым историческим событиям. Одинаковое новое событие не должно повторяться на каждом тике. 10. РЕКОМЕНДАЦИИ ПО ИСПОЛЬЗОВАНИЮ 1) Сначала протестируйте стандартные значения SAR Step 0.02 и Maximum 0.20. 2) Настройте SL и TP с учётом волатильности инструмента и таймфрейма. 3) Не переносите одно значение SL/TP на все символы без проверки. 4) Используйте InpHistoryBars для сравнения настроек на одинаковом участке истории. 5) Учитывайте, что Parabolic SAR является трендовым инструментом и во флэте может формировать частые развороты. 6) Перед применением на реальном счёте проверьте настройки на истории и демонстрационном счёте. 11. УСТРАНЕНИЕ ПРОБЛЕМ Индикатор не появляется на графике: - убедитесь, что файл помещён в правильную папку Indicators; - скомпилируйте файл в MetaEditor; - проверьте вкладки Errors и Journal; - обновите Navigator или перезапустите терминал. Нет стрелок: - увеличьте InpHistoryBars; - убедитесь, что терминал загрузил достаточную историю; - проверьте, были ли реальные развороты SAR на выбранном участке; - помните, что сигнал подтверждается только после закрытия свечи. Нет Push или Email: - проверьте настройки терминала; - выполните тестовую отправку в Tools -> Options; - включите соответствующий параметр индикатора. Не отображаются линии: - установите InpShowLevelLines = true; - дождитесь первого подтверждённого сигнала; - для сохранения линий после выхода установите InpKeepLastLevels = true. 12. ВАЖНЫЕ ОГРАНИЧЕНИЯ SAR Manager не является торговым советником и не совершает сделки. Виртуальная статистика рассчитывается по ценовым данным графика. Она не учитывает точный исторический спред, комиссию, своп, задержку исполнения и проскальзывание. Поэтому результаты в таблице нельзя считать полноценным бэктестом или гарантией будущих результатов. ====================================================================== ENGLISH VERSION ====================================================================== 1. INDICATOR PURPOSE SAR Manager is an information and signal indicator based on the standard Parabolic SAR. It displays the SAR direction, generates BUY and SELL signals, calculates virtual Entry, Stop Loss, and Take Profit levels, marks entries and exits on the chart, sends notifications, and displays signal statistics. The indicator does not open, modify, or close real trading orders. All positions, levels, and results displayed in the panel are virtual. 2. INSTALLATION IN METATRADER 5 1) Open MetaTrader 5. 2) Select File -> Open Data Folder. 3) Open MQL5 -> Indicators. 4) Copy SAR_Signal_Manager_MT5.mq5 into this folder. 5) Open the file in MetaEditor and press F7 to compile it. 6) Return to MetaTrader 5. 7) In Navigator, right-click Indicators and select Refresh. Restart the terminal if necessary. 8) Drag SAR Signal Manager onto the required chart. 3. INSTALLATION IN METATRADER 4 1) Open MetaTrader 4. 2) Select File -> Open Data Folder. 3) Open MQL4 -> Indicators. 4) Copy SAR_Signal_Manager_MT4.mq4 into this folder. 5) Open the file in MetaEditor and press F7 to compile it. 6) Return to MetaTrader 4. 7) In Navigator, right-click Indicators and select Refresh. Restart the terminal if necessary. 8) Drag SAR Signal Manager onto the required chart. 4. SIGNAL LOGIC BUY: A signal is generated when Parabolic SAR moves from above the price to below the price. The reversal is confirmed after the candle closes. The virtual entry is calculated at the opening price of the next candle. SELL: A signal is generated when Parabolic SAR moves from below the price to above the price. The reversal is confirmed after the candle closes. The virtual entry is calculated at the opening price of the next candle. Confirmed signals use closed candles only. The unfinished current candle is not used to confirm a new direction. The indicator tracks no more than one virtual position at a time. When an opposite confirmed signal appears, the active virtual position is closed with the SAR reversal reason, and a new entry is calculated in the opposite direction. 5. STOP LOSS AND TAKE PROFIT LOGIC Stop Loss and Take Profit distances are specified in MetaTrader points. For BUY: - Stop Loss is placed below Entry; - Take Profit is placed above Entry. For SELL: - Stop Loss is placed above Entry; - Take Profit is placed below Entry. On a five-digit Forex symbol, 100 points are equal to 10 standard pips. Always consider the number of digits used by the selected instrument. Possible exit reasons: - Stop Loss; - Take Profit; - SAR reversal; - Stop Loss gap; - Take Profit gap. If a new candle opens beyond the Stop Loss or Take Profit level, the indicator processes the gap using the actual candle opening price. If one historical candle reaches both Stop Loss and Take Profit, the exact intrabar price sequence cannot be determined from OHLC data. InpSameBarPolicy defines the calculation rule: - SAME_BAR_SL_FIRST — Stop Loss is counted first. This conservative mode is used by default; - SAME_BAR_TP_FIRST — Take Profit is counted first. 6. CHART ELEMENTS - Parabolic SAR dots display the current standard SAR position. - A green arrow marks a virtual BUY entry. - A red arrow marks a virtual SELL entry. - An orange marker identifies a virtual exit. - The blue Entry line shows the calculated entry price. - The red Stop Loss line shows the protective level. - The green Take Profit line shows the target level. - Level names and prices are displayed next to the lines. If InpKeepLastLevels = true, the latest Entry, Stop Loss, and Take Profit levels remain visible after an exit. If it is set to false, the lines are removed when the virtual position closes. 7. INFORMATION PANEL SAR SIGNAL MANAGER — indicator name. Symbol / Timeframe — current instrument and timeframe. Signal — current state: - BUY / ACTIVE; - SELL / ACTIVE; - BUY / WAIT; - SELL / WAIT. SAR trend — current Parabolic SAR direction: BULLISH or BEARISH. Entry — price of the latest or active virtual entry. Stop Loss — calculated Stop Loss and its distance in points. Take Profit — calculated Take Profit and its distance in points. Risk / Reward — ratio between the Stop Loss and Take Profit distances. Entries BUY / SELL — number of calculated entries in each direction. Closed — number of closed virtual positions. W / L / BE: - W — virtual positions with a positive result; - L — virtual positions with a negative result; - BE — breakeven results. Net points — combined result of closed virtual positions in points. Last exit — direction, reason, and price of the latest exit. Statistics are calculated only within the number of candles selected in InpHistoryBars. An active virtual position is not included in Closed until an exit occurs. 8. INPUT PARAMETERS PARABOLIC SAR InpSarStep = 0.02 Parabolic SAR acceleration step. A lower value makes SAR less sensitive, while a higher value makes it react more quickly to price changes. InpSarMaximum = 0.20 Maximum Parabolic SAR acceleration value. INFORMATION InpMyProfile My profile link to the developer's MQL5 profile. SIGNALS AND LEVELS InpStopLossPoints = 300 Distance from Entry to Stop Loss in points. InpTakeProfitPoints = 600 Distance from Entry to Take Profit in points. InpArrowOffsetPoints = 30 Visual distance between entry arrows and the price. InpHistoryBars = 3000 Number of candles used for signals and virtual statistics. The minimum allowed value is 10. InpSameBarPolicy = SAME_BAR_SL_FIRST Calculation rule when one historical candle reaches both SL and TP. InpShowLevelLines = true Displays the Entry, Stop Loss, and Take Profit lines. InpKeepLastLevels = true Keeps the latest levels visible after an exit. NOTIFICATIONS InpEntryAlerts = true Enables virtual entry notifications. InpExitAlerts = true Enables virtual exit notifications. InpAlertPopup = true Displays MetaTrader popup alerts. InpAlertPush = false Sends Push notifications to a mobile device. InpAlertEmail = false Sends email notifications. InpAlertSound = false Plays a sound file when an event occurs. InpAlertSoundFile = alert.wav Sound filename located in the terminal's Sounds folder. APPEARANCE InpSarColor — SAR dot color. InpBuyColor — BUY arrow color. InpSellColor — SELL arrow color. InpExitColor — exit marker color. InpEntryLineColor — Entry line color. InpStopLineColor — Stop Loss line color. InpTakeLineColor — Take Profit line color. InpShowPanel — shows or hides the information panel. InpPanelX — horizontal panel position in pixels. InpPanelY — vertical panel position in pixels. InpPanelBackground — panel background color. InpPanelBorder — panel border color. InpPanelText — main panel text color. 9. NOTIFICATION SETUP Popup: Set InpAlertPopup = true. Push: 1) Open Tools -> Options -> Notifications. 2) Enable Push notifications. 3) Enter the MetaQuotes ID from the MetaTrader mobile application. 4) Send a test notification. 5) Set InpAlertPush = true. Email: 1) Open Tools -> Options -> Email. 2) Configure the SMTP server, login, password, sender, and recipient. 3) Send a test email. 4) Set InpAlertEmail = true. Sound: 1) Make sure the sound file is located in the terminal's Sounds folder. 2) Enter its filename in InpAlertSoundFile. 3) Set InpAlertSound = true. When the indicator is attached for the first time, it does not send alerts for old historical events. The same new event should not be repeated on every tick. 10. USAGE RECOMMENDATIONS 1) Start by testing the standard SAR Step 0.02 and Maximum 0.20 settings. 2) Adjust SL and TP according to the volatility of the instrument and timeframe. 3) Do not apply one SL/TP value to every symbol without testing it. 4) Use InpHistoryBars to compare settings over the same historical period. 5) Remember that Parabolic SAR is a trend-following tool and may produce frequent reversals in a sideways market. 6) Test the selected settings on historical data and a demo account before using them in live trading. 11. TROUBLESHOOTING The indicator does not appear on the chart: - make sure the file is located in the correct Indicators folder; - compile the file in MetaEditor; - check the Errors and Journal tabs; - refresh Navigator or restart the terminal. No arrows are displayed: - increase InpHistoryBars; - make sure sufficient historical data has been downloaded; - check whether actual SAR reversals occurred during the selected period; - remember that a signal is confirmed only after the candle closes. Push or Email notifications are not received: - check the terminal settings; - send a test message from Tools -> Options; - enable the corresponding indicator parameter. Level lines are not displayed: - set InpShowLevelLines = true; - wait for the first confirmed signal; - set InpKeepLastLevels = true to keep the lines visible after an exit. 12. IMPORTANT LIMITATIONS SAR Manager is not an Expert Advisor and does not execute trades. Virtual statistics are calculated using chart price data. They do not include the exact historical spread, commissions, swaps, execution delays, or slippage. Therefore, the panel results must not be treated as a complete backtest or a guarantee of future performance.