Открыть на GitHub

Стратегия XPeriod Candle System TM Plus

Обзор

Стратегия представляет собой перенос эксперта MetaTrader Exp_XPeriodCandleSystem_Tm_Plus на платформу StockSharp. Исходная версия использует индикатор XPeriod Candle System, который сглаживает цены свечей и раскрашивает бары в зависимости от прорыва полос Боллинджера. Перевод воспроизводит ту же идею: экспоненциальное сглаживание OHLC-данных, поддержка всех режимов расчётных цен и работа по цветовым состояниям, дополненная временным фильтром и защитными приказами.

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

  1. Сглаженные свечи – экспоненциальные скользящие средние с настраиваемой длиной формируют синтетические значения open/high/low/close.
  2. Выбор цены – перед подачей в полосы Боллинджера можно выбрать одну из 12 формул (close, open, median, trend-following, Demark и др.).
  3. Полосы Боллинджера – длина и ширина полос задаются параметрами, сигналы формируются только на завершённых значениях индикатора.
  4. Цвета
    • Бычащий бар выше верхней полосы → цвет 0 (прорыв вверх).
    • Медвежий бар ниже нижней полосы → цвет 4 (прорыв вниз).
    • Прочие бычьи бары → цвет 1, прочие медвежьи → цвет 3.
    • Дополнительное смещение Deviation (учитывает шаг цены) помогает избежать ложных сигналов.
  5. Входы – анализируется свеча SignalBar и предыдущая:
    • Если предыдущая окрашена в 0, а текущая не 0, разрешается открывать длинную позицию (при включённом флаге BuyPosOpen).
    • Если предыдущая окрашена в 4, а текущая не 4, разрешается открывать короткую позицию (SellPosOpen).
  6. Выходы
    • Цвет > 2 закрывает длинные позиции (BuyPosClose).
    • Цвет < 2 закрывает короткие позиции (SellPosClose).
    • При активном TimeTrade позиции закрываются по истечении HoldingMinutes минут.
  7. Риск-менеджментStartProtection активирует абсолютные стоп-лосс и тейк-профит. Нулевые значения отключают защитные приказы.

Параметры

Параметр Назначение Значение по умолчанию
OrderVolume Базовый объём сделки. 0.1
BuyPosOpen / SellPosOpen Разрешение на открытие длинных/коротких позиций. true
BuyPosClose / SellPosClose Разрешение на закрытие длинных/коротких позиций. true
TimeTrade Активация тайм-аута по времени удержания. true
HoldingMinutes Максимальное время удержания позиции в минутах. 960
CandleType Тип свечей/таймфрейм для анализа. 4 часа
Period Длина экспоненциального сглаживания. 5
BollingerLength Количество баров в окне полос Боллинджера. 20
BandsDeviation Множитель ширины полос. 1.001
AppliedPriceMode Формула расчётной цены для индикатора. Close
SignalBar Индекс бара для генерации сигналов (1 = последняя завершённая свеча). 1
StopLoss / TakeProfit Абсолютные расстояния до стоп-лосса и тейк-профита. 1000 / 2000
Deviation Дополнительное смещение для проверки прорыва. 10

Рекомендации

  • Значение Period влияет на степень сглаживания: маленькие значения ближе к реальной цене, большие – подчёркивают тренд.
  • SignalBar должен укладываться в доступную историю (хранится до 14 прошлых цветов). При превышении лимита сигналы игнорируются.
  • Если у инструмента задан PriceStep, параметр Deviation автоматически переводится в денежное выражение через шаг цены.
  • StopLoss и TakeProfit измеряются в абсолютных ценовых единицах; установите 0, чтобы отключить защитные приказы.
  • 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>
/// XPeriod candle system with Bollinger Bands breakout.
/// Buys on close above upper band with bullish candle, sells on close below lower band with bearish candle.
/// </summary>
public class XPeriodCandleSystemTmPlusStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _bbPeriod;
	private readonly StrategyParam<decimal> _bbWidth;

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

	public int BbPeriod
	{
		get => _bbPeriod.Value;
		set => _bbPeriod.Value = value;
	}

	public decimal BbWidth
	{
		get => _bbWidth.Value;
		set => _bbWidth.Value = value;
	}

	public XPeriodCandleSystemTmPlusStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(5).TimeFrame())
			.SetDisplay("Candle Type", "Timeframe", "General");

		_bbPeriod = Param(nameof(BbPeriod), 20)
			.SetGreaterThanZero()
			.SetDisplay("BB Period", "Bollinger Bands period", "Indicators");

		_bbWidth = Param(nameof(BbWidth), 2m)
			.SetGreaterThanZero()
			.SetDisplay("BB Width", "Bollinger Bands width", "Indicators");
	}

	public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
	{
		return [(Security, CandleType)];
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		var bb = new BollingerBands { Length = BbPeriod, Width = BbWidth };

		var subscription = SubscribeCandles(CandleType);
		subscription
			.BindEx(bb, ProcessCandle)
			.Start();

		var area = CreateChartArea();
		if (area != null)
		{
			DrawCandles(area, subscription);
			DrawIndicator(area, bb);
			DrawOwnTrades(area);
		}
	}

	private void ProcessCandle(ICandleMessage candle, IIndicatorValue value)
	{
		if (candle.State != CandleStates.Finished)
			return;

		var bb = (BollingerBandsValue)value;
		if (bb.UpBand is not decimal upper ||
			bb.LowBand is not decimal lower ||
			bb.MovingAverage is not decimal middle)
			return;

		var close = candle.ClosePrice;
		var isBullish = candle.ClosePrice > candle.OpenPrice;
		var isBearish = candle.ClosePrice < candle.OpenPrice;

		// Buy: close above upper band with bullish candle
		if (close > upper && isBullish && Position <= 0)
		{
			if (Position < 0)
				BuyMarket();
			BuyMarket();
		}
		// Sell: close below lower band with bearish candle
		else if (close < lower && isBearish && Position >= 0)
		{
			if (Position > 0)
				SellMarket();
			SellMarket();
		}
		// Exit long at middle band
		else if (Position > 0 && close < middle)
		{
			SellMarket();
		}
		// Exit short at middle band
		else if (Position < 0 && close > middle)
		{
			BuyMarket();
		}
	}
}