Открыть на GitHub

ZigZag EA

Обзор

Стратегия повторяет логику оригинального MT5 "ZigZag EA": она отслеживает три последовательных экстремума ZigZag и выставляет два стоп-ордера на пробой диапазона между предыдущими вершинами. Конвертация использует высокоуровневый API StockSharp и работает только с закрытыми свечами. Два последних завершённых экстремума формируют торговый коридор, а самый свежий экстремум ("room 0" в исходнике MQL) должен находиться внутри этого коридора, прежде чем стратегия активирует отложенные ордера. Подход симметричный: одновременно готовятся buy-stop и sell-stop заявки, позволяя рынку выбрать направление пробоя.

Индикаторы и входные данные

  • Highest / Lowest. В StockSharp нет прямого аналога ZigZag, поэтому поведение индикатора моделируется через скользящие максимум и минимум с заданной глубиной. При смене направления обновляются буферы экстремумов так же, как оригинальный советник считывает буфер ZigZag.
  • Свечи. Стратегия подписывается на настраиваемый тип свечей (по умолчанию минутные) и обрабатывает только завершённые бары, что делает её пригодной и для тестирования, и для реальной торговли.

Логика торговли

  1. Сохраняются последние три значения ZigZag. Два предыдущих экстремума определяют границы коридора (high/low), а последний экстремум должен находиться внутри диапазона с учётом минимальной дистанции от брокера (StopsLevel).
  2. Проверяются ограничения по размеру коридора (MinCorridorPips и MaxCorridorPips). Слишком узкие диапазоны фильтруются как шум, слишком широкие — чтобы избежать чрезмерных стопов.
  3. Если коридор валиден и нет открытой позиции, выставляются симметричные отложенные ордера:
    • Buy stop на уровне high + EntryOffsetPips.
    • Sell stop на уровне low - EntryOffsetPips.
  4. Стоп-лосс и тейк-профит вычисляются по тем же правилам Фибоначчи, что и в MQL: FiboStopLoss умножает высоту коридора, FiboTakeProfit берёт выбранный уровень и вычитает из него исходный диапазон. Значения округляются к шагу цены инструмента.
  5. При срабатывании одного из стоп-ордеров оставшийся отложенный ордер отменяется, а защитные stop-loss и take-profit регистрируются немедленно. Дополнительное трейлинг-сопровождение подтягивает стоп, когда цена проходит TrailingStepPips сверх базовой дистанции.
  6. После закрытия позиции стратегия автоматически переходит в режим ожидания нового коридора.

Управление риском и ордерами

  • Защитные stop-loss и take-profit выставляются как реальные стоп/лимит заявки, поэтому брокер контролирует исполнение и учёт гэпов.
  • Логика трейлинга полностью повторяет советник: он активируется после прохождения TrailingStopPips + TrailingStepPips и затем перерегистрирует стоп при каждом улучшении не менее чем на один шаг трейлинга.
  • Размер позиции определяется базовым параметром Volume класса Strategy. Блок выбора между фиксированным лотом и процентом риска из MQL опущен, так как в StockSharp расчёт объёма обычно настраивается отдельно.

Временной фильтр

  • Торговля разрешена только в интервале StartHour:StartMinuteStopHour: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-файлах.
  • Python-версия не создавалась — в каталоге находится только реализация на C#, как и требовалось.
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;
	}
}