Стратегия повторяет логику оригинального MT5 "ZigZag EA": она отслеживает три последовательных экстремума ZigZag и выставляет два стоп-ордера на пробой диапазона между предыдущими вершинами. Конвертация использует высокоуровневый API StockSharp и работает только с закрытыми свечами. Два последних завершённых экстремума формируют торговый коридор, а самый свежий экстремум ("room 0" в исходнике MQL) должен находиться внутри этого коридора, прежде чем стратегия активирует отложенные ордера. Подход симметричный: одновременно готовятся buy-stop и sell-stop заявки, позволяя рынку выбрать направление пробоя.
Индикаторы и входные данные
Highest / Lowest. В StockSharp нет прямого аналога ZigZag, поэтому поведение индикатора моделируется через скользящие максимум и минимум с заданной глубиной. При смене направления обновляются буферы экстремумов так же, как оригинальный советник считывает буфер ZigZag.
Свечи. Стратегия подписывается на настраиваемый тип свечей (по умолчанию минутные) и обрабатывает только завершённые бары, что делает её пригодной и для тестирования, и для реальной торговли.
Логика торговли
Сохраняются последние три значения ZigZag. Два предыдущих экстремума определяют границы коридора (high/low), а последний экстремум должен находиться внутри диапазона с учётом минимальной дистанции от брокера (StopsLevel).
Проверяются ограничения по размеру коридора (MinCorridorPips и MaxCorridorPips). Слишком узкие диапазоны фильтруются как шум, слишком широкие — чтобы избежать чрезмерных стопов.
Если коридор валиден и нет открытой позиции, выставляются симметричные отложенные ордера:
Buy stop на уровне high + EntryOffsetPips.
Sell stop на уровне low - EntryOffsetPips.
Стоп-лосс и тейк-профит вычисляются по тем же правилам Фибоначчи, что и в MQL: FiboStopLoss умножает высоту коридора, FiboTakeProfit берёт выбранный уровень и вычитает из него исходный диапазон. Значения округляются к шагу цены инструмента.
При срабатывании одного из стоп-ордеров оставшийся отложенный ордер отменяется, а защитные stop-loss и take-profit регистрируются немедленно. Дополнительное трейлинг-сопровождение подтягивает стоп, когда цена проходит TrailingStepPips сверх базовой дистанции.
После закрытия позиции стратегия автоматически переходит в режим ожидания нового коридора.
Управление риском и ордерами
Защитные stop-loss и take-profit выставляются как реальные стоп/лимит заявки, поэтому брокер контролирует исполнение и учёт гэпов.
Логика трейлинга полностью повторяет советник: он активируется после прохождения TrailingStopPips + TrailingStepPips и затем перерегистрирует стоп при каждом улучшении не менее чем на один шаг трейлинга.
Размер позиции определяется базовым параметром Volume класса Strategy. Блок выбора между фиксированным лотом и процентом риска из MQL опущен, так как в StockSharp расчёт объёма обычно настраивается отдельно.
Временной фильтр
Торговля разрешена только в интервале StartHour:StartMinute – StopHour:StopMinute. Если время окончания меньше времени начала, диапазон считается «ночным» и распространяется на следующую дату.
Все отложенные ордера отменяются при выходе за торговый интервал, что повторяет поведение MQL-версии.
Параметры
Имя
Описание
Значение по умолчанию
CandleType
Тип свечей для анализа.
Минутные свечи
ZigZagDepth
Глубина поиска экстремумов.
12
EntryOffsetPips
Смещение ордеров от границ коридора.
5
MinCorridorPips
Минимальная высота допустимого коридора.
20
MaxCorridorPips
Максимальная высота коридора.
100
FiboStopLoss
Уровень Фибоначчи для расчёта стоп-лосса.
61,8%
FiboTakeProfit
Уровень Фибоначчи для тейк-профита.
161,8%
StartHour / StartMinute
Начало торгового окна.
00:01
StopHour / StopMinute
Конец торгового окна.
23:59
TrailingStopPips
Базовое расстояние трейлинг-стопа.
5
TrailingStepPips
Минимальное улучшение для переноса трейлинга.
5
DrawCorridorLevels
Отрисовывать маркер коридора на графике.
false
Замечания по реализации
Значения в пунктах вычисляются из шага цены. Для инструментов с 3 или 5 знаками после запятой шаг умножается на 10, что повторяет логику adjusted_point оригинального советника.
Используются высокоуровневые методы (BuyStop, SellStop, SellLimit, BuyLimit), соответствующие рекомендациям репозитория.
Комментарии в коде оставлены на английском, а подробные описания подготовлены на трёх языках в README-файлах.
Реализации доступны на C# и Python.
using System;
using System.Collections.Generic;
using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;
namespace StockSharp.Samples.Strategies;
/// <summary>
/// ZigZag breakout strategy using highest/lowest channels.
/// Buys on breakout above recent high, sells on breakdown below recent low.
/// </summary>
public class ZigZagEAStrategy : Strategy
{
private readonly StrategyParam<DataType> _candleType;
private readonly StrategyParam<int> _depth;
private decimal? _prevHigh;
private decimal? _prevLow;
public DataType CandleType
{
get => _candleType.Value;
set => _candleType.Value = value;
}
public int Depth
{
get => _depth.Value;
set => _depth.Value = value;
}
public ZigZagEAStrategy()
{
_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
.SetDisplay("Candle Type", "Timeframe", "General");
_depth = Param(nameof(Depth), 20)
.SetGreaterThanZero()
.SetDisplay("Depth", "Channel lookback period", "Indicators");
}
public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
{
return [(Security, CandleType)];
}
/// <inheritdoc />
protected override void OnReseted()
{
base.OnReseted();
_prevHigh = null;
_prevLow = null;
}
protected override void OnStarted2(DateTime time)
{
base.OnStarted2(time);
_prevHigh = null;
_prevLow = null;
var highest = new Highest { Length = Depth };
var lowest = new Lowest { Length = Depth };
var subscription = SubscribeCandles(CandleType);
subscription
.Bind(highest, lowest, ProcessCandle)
.Start();
var area = CreateChartArea();
if (area != null)
{
DrawCandles(area, subscription);
DrawIndicator(area, highest);
DrawIndicator(area, lowest);
DrawOwnTrades(area);
}
}
private void ProcessCandle(ICandleMessage candle, decimal high, decimal low)
{
if (candle.State != CandleStates.Finished)
return;
if (!IsFormedAndOnlineAndAllowTrading())
{
_prevHigh = high;
_prevLow = low;
return;
}
if (_prevHigh == null || _prevLow == null)
{
_prevHigh = high;
_prevLow = low;
return;
}
var close = candle.ClosePrice;
// Breakout above channel high
if (close > _prevHigh.Value && Position <= 0)
{
if (Position < 0)
BuyMarket();
BuyMarket();
}
// Breakdown below channel low
else if (close < _prevLow.Value && Position >= 0)
{
if (Position > 0)
SellMarket();
SellMarket();
}
_prevHigh = high;
_prevLow = low;
}
}
import clr
clr.AddReference("StockSharp.Messages")
clr.AddReference("StockSharp.Algo")
clr.AddReference("StockSharp.Algo.Indicators")
clr.AddReference("StockSharp.Algo.Strategies")
from System import TimeSpan
from StockSharp.Messages import DataType, CandleStates
from StockSharp.Algo.Indicators import Highest, Lowest
from StockSharp.Algo.Strategies import Strategy
class zig_zag_ea_strategy(Strategy):
def __init__(self):
super(zig_zag_ea_strategy, self).__init__()
self._candle_type = self.Param("CandleType", DataType.TimeFrame(TimeSpan.FromHours(4))) \
.SetDisplay("Candle Type", "Timeframe", "General")
self._depth = self.Param("Depth", 20) \
.SetDisplay("Depth", "Channel lookback period", "Indicators")
self._prev_high = None
self._prev_low = None
@property
def CandleType(self):
return self._candle_type.Value
@property
def Depth(self):
return self._depth.Value
def OnReseted(self):
super(zig_zag_ea_strategy, self).OnReseted()
self._prev_high = None
self._prev_low = None
def OnStarted2(self, time):
super(zig_zag_ea_strategy, self).OnStarted2(time)
self._prev_high = None
self._prev_low = None
highest = Highest()
highest.Length = self.Depth
lowest = Lowest()
lowest.Length = self.Depth
subscription = self.SubscribeCandles(self.CandleType)
subscription.Bind(highest, lowest, self._on_process).Start()
area = self.CreateChartArea()
if area is not None:
self.DrawCandles(area, subscription)
self.DrawIndicator(area, highest)
self.DrawIndicator(area, lowest)
self.DrawOwnTrades(area)
def _on_process(self, candle, high_value, low_value):
if candle.State != CandleStates.Finished:
return
hv = float(high_value)
lv = float(low_value)
if self._prev_high is None or self._prev_low is None:
self._prev_high = hv
self._prev_low = lv
return
close = float(candle.ClosePrice)
# Breakout above channel high
if close > self._prev_high and self.Position <= 0:
if self.Position < 0:
self.BuyMarket()
self.BuyMarket()
# Breakdown below channel low
elif close < self._prev_low and self.Position >= 0:
if self.Position > 0:
self.SellMarket()
self.SellMarket()
self._prev_high = hv
self._prev_low = lv
def CreateClone(self):
return zig_zag_ea_strategy()