Открыть на GitHub

Стратегия The 20s Breakout

Общее описание

Данная стратегия — портированная на C# версия эксперта MetaTrader Exp_The_20s_v020. Она повторяет логику индикатора «The 20s», который отслеживает пробои после фазы сжатия волатильности. Алгоритм анализирует завершённые свечи выбранного таймфрейма и реагирует, когда цена пробивает 20%-е диапазоны вокруг предыдущей свечи. Реализация использует высокоуровневый API StockSharp и позволяет отдельно включать или отключать длинные и короткие операции.

Логика сигналов

Индикатор наблюдает за последними барами и вычисляет опорные уровни на основе предыдущей свечи:

  1. Определяется диапазон предыдущей свечи: range = high[1] - low[1].
  2. Строятся два пороговых уровня:
    • top = high[1] - range * Ratio
    • bottom = low[1] + range * Ratio
  3. Текущая свеча сравнивается с этими уровнями и дистанцией LevelPoints, пересчитанной в цену через PriceStep инструмента.

Исходный код предусматривает два варианта расчёта:

  • Mode1 (по умолчанию) – ищет ложный пробой внутри 20%-го диапазона на предыдущей свече и резкий откат на текущей. В зависимости от IsDirect стратегия либо покупает провал (Direct = true), либо продаёт его (Direct = false).
  • Mode2 – требует последовательность из трёх расширяющихся свечей перед сигналом. Если импульс идёт вниз и цена открывается ниже нижнего уровня, активируется один сценарий; если выше верхнего уровня — противоположный. Параметр IsDirect снова инвертирует направления, как и в оригинальном советнике.

Параметр SignalBar откладывает исполнение на заданное число баров (0 = текущая свеча, 1 = предыдущая и т. д.), что полностью соответствует механизму отложенных сигналов в MQL-версии.

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

  • Входы: параметры AllowLongEntry и AllowShortEntry определяют, можно ли открывать новые позиции. Размер позиции задаётся через OrderVolume.
  • Развороты: при появлении бычьего сигнала стратегия сначала закрывает короткую позицию (AllowShortExit), после чего при необходимости открывает длинную. Медвежий сигнал выполняет зеркальную последовательность для длинных позиций.
  • Стопы и цели: StopLossPoints и TakeProfitPoints задаются в пунктах инструмента. Они переводятся в цену с помощью PriceStep и проверяются на каждой завершённой свече. При достижении любого уровня позиция закрывается.
  • Инверсия направлений: значение IsDirect = true воспроизводит исходное направление сигналов. false меняет buy/sell местами, что полезно на инструментах с иной реакцией.

Параметры

  • OrderVolume – по умолчанию 1. Объём новой позиции.
  • StopLossPoints – по умолчанию 1000. Размер защитного стопа в пунктах (0 — отключен).
  • TakeProfitPoints – по умолчанию 2000. Размер цели в пунктах (0 — отключена).
  • AllowLongEntry / AllowShortEntry – разрешение на открытие длинных/коротких позиций.
  • AllowLongExit / AllowShortExit – разрешение на закрытие позиций при противоположных сигналах.
  • SignalBar – по умолчанию 1. Задержка исполнения сигнала в барах.
  • LevelPoints – по умолчанию 100. Подтверждающее расстояние за пределами экстремумов предыдущей свечи.
  • Ratio – по умолчанию 0.2. Ширина 20%-го диапазона относительно предыдущей свечи.
  • IsDirect – по умолчанию false. При true сохраняет исходное направление, при false инвертирует его.
  • Mode – по умолчанию Mode1. Выбор одного из двух алгоритмов расчёта.
  • CandleType – по умолчанию таймфрейм H1. Определяет поток свечей для анализа.

Дополнительные замечания

  • Расчёт выполняется только по завершённым свечам, что исключает преждевременные входы.
  • Журнальные сообщения и комментарии в коде записаны на английском языке в соответствии со стилем примеров StockSharp.
  • Стопы и тейк-профиты реализованы внутри стратегии, без создания отдельных заявок, поэтому логика одинаково работает в тестах и на реальном рынке.
  • Стратегию можно применять на любом инструменте, главное — наличие корректного PriceStep для пересчёта пунктов в цену.
  • Для более консервативной торговли можно комбинировать Mode2 с увеличенным SignalBar на старших таймфреймах, как это делается в оригинальном советнике.
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>
/// The 20s Breakout strategy. Trades channel breakouts using Highest/Lowest.
/// </summary>
public class The20sBreakoutStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _period;

	private decimal? _prevHigh;
	private decimal? _prevLow;

	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	public int Period
	{
		get => _period.Value;
		set => _period.Value = value;
	}

	public The20sBreakoutStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Timeframe", "General");

		_period = Param(nameof(Period), 20)
			.SetGreaterThanZero()
			.SetDisplay("Period", "Channel 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 = Period };
		var lowest = new Lowest { Length = Period };

		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;

		if (close > _prevHigh.Value && Position <= 0)
		{
			if (Position < 0)
				BuyMarket();
			BuyMarket();
		}
		else if (close < _prevLow.Value && Position >= 0)
		{
			if (Position > 0)
				SellMarket();
			SellMarket();
		}

		_prevHigh = high;
		_prevLow = low;
	}
}