Ver no GitHub

Estratégia de Canal Plano (2684)

Esta estratégia é uma conversão em C# do consultor especializado MetaTrader 5 Flat Channel (edição barabashkakvn). Detecta períodos de baixa volatilidade (um canal "plano") usando o indicador de Desvio Padrão e coloca ordens stop de rompimento nos limites do canal. Quando o preço rompe o intervalo plano, a ordem stop correspondente é acionada, enquanto a oposta é cancelada para evitar ficar preso em ambos os lados do mercado.

Lógica principal

  1. Filtro de volatilidade – a estratégia assina velas e calcula o Desvio Padrão do preço mediano. Uma fase plana é confirmada quando o valor continua caindo por pelo menos FlatBars velas consecutivas.
  2. Construção do canal – uma vez confirmada a fase plana, o máximo mais alto e o mínimo mais baixo do intervalo plano são rastreados. A largura do canal deve permanecer entre ChannelMinPips e ChannelMaxPips (convertidos para unidades de preço via o tamanho de tick do instrumento).
  3. Ordens de entrada – enquanto o preço opera dentro do canal, a estratégia coloca:
    • Um buy stop no máximo do canal com stop-loss 2 × largura do canal abaixo da entrada e take-profit 1 × largura do canal acima.
    • Um sell stop no mínimo do canal com as distâncias simétricas de stop-loss/take-profit.
  4. Vida útil da ordem – as ordens stop pendentes expiram após OrderLifetimeSeconds. Quando o tempo esgota, são canceladas e podem ser recriadas se as condições planas ainda se mantiverem.
  5. Gestão de posição – após uma ordem de entrada ser executada, a ordem stop oposta é cancelada e novas ordens de proteção (stop-loss e take-profit) são registradas. A lógica opcional de ponto de equilíbrio move o stop-loss para o preço de entrada assim que o preço percorre uma fração Fibonacci (FiboTrail) da distância em direção ao alvo de take-profit.
  6. Janela de trading – o filtro UseTradingHours restringe a atividade por dia da semana e por horas específicas de segunda/sexta-feira, emulando os controles de cronograma do EA original.

Indicadores

  • StandardDeviation (preço mediano, comprimento = StdDevPeriod) – detecta queda de volatilidade.
  • DonchianChannels (comprimento = FlatBars) – fornece os limites iniciais de máximo/mínimo para o canal plano.

Risco e gestão de capital

  • FixedVolume define o tamanho do lote quando UseMoneyManagement está desabilitado.
  • Quando UseMoneyManagement está habilitado, o tamanho da posição é estimado a partir de RiskPercent do valor atual do portfólio dividido pela distância do stop-loss expressa em dinheiro usando PriceStep e StepPrice.
  • Após uma operação perdedora, a próxima posição usa FixedVolume × 4, replicando o comportamento de recuperação do EA original.

Parâmetros

Parâmetro Descrição
UseTradingHours Habilitar ou desabilitar o filtro de horário por dia da semana/hora.
TradeTuesday, TradeWednesday, TradeThursday Permitir trading em dias individuais no meio da semana (segunda e sexta-feira são sempre permitidas, mas controladas pelos limites horários).
MondayStartHour, FridayStopHour Hora de início na segunda-feira e hora de corte na sexta-feira (relógio de 24h).
UseMoneyManagement, RiskPercent, FixedVolume Opções de gestão de capital descritas acima.
OrderLifetimeSeconds Tempo de expiração para ordens de entrada pendentes (0 = sem expiração).
StdDevPeriod, FlatBars Configurações do indicador que controlam a detecção da fase plana.
ChannelMinPips, ChannelMaxPips Largura de canal permitida expressa em pips (convertida usando o tamanho de tick do instrumento).
UseBreakeven, FiboTrail Habilitar a lógica de ponto de equilíbrio e definir o multiplicador Fibonacci usado para acionar o ajuste do stop.
CandleType Tipo de dados de velas ou período usado para os cálculos.

Notas

  • A estratégia espera símbolos que exponham PriceStep e StepPrice para que os limiares baseados em pips possam ser convertidos em preços reais.
  • As ordens pendentes são recriadas somente quando a volatilidade continua a cair. Se a volatilidade sobe, o estado plano é reiniciado e todas as ordens de entrada são canceladas.
  • As ordens protetoras de stop e take-profit são canceladas automaticamente quando a posição fecha.

Este exemplo é fornecido apenas para fins educativos. O desempenho passado da estratégia original não garante resultados futuros. Teste e ajuste os parâmetros exaustivamente antes de implantar em mercados reais.

using System;
using System.Linq;
using System.Collections.Generic;

using Ecng.Common;
using Ecng.Collections;
using Ecng.Serialization;

using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;

namespace StockSharp.Samples.Strategies;

/// <summary>
/// Flat channel breakout strategy converted from the MetaTrader 5 version.
/// Detects consolidation via falling standard deviation, then trades breakouts of the channel.
/// </summary>
public class FlatChannelStrategy : Strategy
{
	private readonly StrategyParam<int> _stdDevPeriod;
	private readonly StrategyParam<int> _flatBars;
	private readonly StrategyParam<decimal> _channelMinPips;
	private readonly StrategyParam<decimal> _channelMaxPips;
	private readonly StrategyParam<DataType> _candleType;

	private StandardDeviation _stdDev = null!;
	private DonchianChannels _donchian = null!;

	private decimal _previousStdDev;
	private int _flatBarCount;
	private decimal _channelHigh;
	private decimal _channelLow;

	private decimal? _pendingBuyPrice;
	private decimal? _pendingSellPrice;
	private decimal _entryPrice;
	private decimal _longStop;
	private decimal _longTake;
	private decimal _shortStop;
	private decimal _shortTake;

	/// <summary>
	/// Standard deviation indicator period.
	/// </summary>
	public int StdDevPeriod
	{
		get => _stdDevPeriod.Value;
		set => _stdDevPeriod.Value = value;
	}

	/// <summary>
	/// Minimum number of bars with falling volatility required to form a flat channel.
	/// </summary>
	public int FlatBars
	{
		get => _flatBars.Value;
		set => _flatBars.Value = value;
	}

	/// <summary>
	/// Minimum channel width expressed in pips.
	/// </summary>
	public decimal ChannelMinPips
	{
		get => _channelMinPips.Value;
		set => _channelMinPips.Value = value;
	}

	/// <summary>
	/// Maximum channel width expressed in pips.
	/// </summary>
	public decimal ChannelMaxPips
	{
		get => _channelMaxPips.Value;
		set => _channelMaxPips.Value = value;
	}

	/// <summary>
	/// Candle type to analyse.
	/// </summary>
	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	public FlatChannelStrategy()
	{
		_stdDevPeriod = Param(nameof(StdDevPeriod), 37)
			.SetDisplay("StdDev Period", "Standard deviation indicator period", "Indicators")
			.SetGreaterThanZero();

		_flatBars = Param(nameof(FlatBars), 2)
			.SetDisplay("Flat Bars", "Minimum bars in flat state", "Indicators")
			.SetGreaterThanZero();

		_channelMinPips = Param(nameof(ChannelMinPips), 10m)
			.SetDisplay("Channel Min Pips", "Minimum channel width in pips", "Indicators")
			.SetGreaterThanZero();

		_channelMaxPips = Param(nameof(ChannelMaxPips), 100000m)
			.SetDisplay("Channel Max Pips", "Maximum channel width in pips", "Indicators")
			.SetGreaterThanZero();

		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Primary candle type", "General");
	}

	/// <inheritdoc />
	public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
		=> [(Security, CandleType)];

	/// <inheritdoc />
	protected override void OnReseted()
	{
		base.OnReseted();

		_previousStdDev = 0m;
		_flatBarCount = 0;
		_channelHigh = 0m;
		_channelLow = 0m;
		_pendingBuyPrice = null;
		_pendingSellPrice = null;
		_entryPrice = 0m;
		_longStop = 0m;
		_longTake = 0m;
		_shortStop = 0m;
		_shortTake = 0m;
	}

	/// <inheritdoc />
	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		_stdDev = new StandardDeviation { Length = StdDevPeriod };
		_donchian = new DonchianChannels { Length = FlatBars };

		var subscription = SubscribeCandles(CandleType);

		subscription
			.BindEx(_donchian, ProcessCandle)
			.Start();

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

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

		var medianPrice = (candle.HighPrice + candle.LowPrice) / 2m;
		var stdDevValue = _stdDev.Process(new DecimalIndicatorValue(_stdDev, medianPrice, candle.CloseTime) { IsFinal = true }).ToDecimal();

		if (!_stdDev.IsFormed || channelValue is not DonchianChannelsValue donchianValue)
		{
			_previousStdDev = stdDevValue;
			return;
		}

		if (donchianValue.UpperBand is not decimal upper || donchianValue.LowerBand is not decimal lower)
		{
			_previousStdDev = stdDevValue;
			return;
		}

		// Update flat state based on StdDev direction.
		UpdateStdDevState(stdDevValue, upper, lower, candle);

		// Check simulated pending entries.
		CheckPendingEntries(candle);

		// Manage existing positions with SL/TP.
		ManagePosition(candle);

		// If flat and no position, set up pending breakout entries.
		if (Position == 0 && _flatBarCount >= FlatBars && _channelHigh > _channelLow)
		{
			var channelWidth = _channelHigh - _channelLow;
			var priceStep = Security?.PriceStep ?? 0.01m;
			if (priceStep <= 0m) priceStep = 0.01m;
			var minWidth = ChannelMinPips * priceStep;
			var maxWidth = ChannelMaxPips * priceStep;

			if (channelWidth >= minWidth && channelWidth <= maxWidth)
			{
				// Set pending breakout entries at channel boundaries.
				_pendingBuyPrice = _channelHigh;
				_pendingSellPrice = _channelLow;
				_longStop = _channelHigh - channelWidth * 2m;
				_longTake = _channelHigh + channelWidth;
				_shortStop = _channelLow + channelWidth * 2m;
				_shortTake = _channelLow - channelWidth;
			}
		}

		_previousStdDev = stdDevValue;
	}

	private void UpdateStdDevState(decimal stdDevValue, decimal upper, decimal lower, ICandleMessage candle)
	{
		if (_previousStdDev == 0m)
		{
			_previousStdDev = stdDevValue;
			return;
		}

		if (stdDevValue < _previousStdDev)
		{
			_flatBarCount++;

			if (_flatBarCount == FlatBars)
			{
				_channelHigh = upper;
				_channelLow = lower;
			}
			else if (_flatBarCount > FlatBars)
			{
				if (candle.HighPrice > _channelHigh)
					_channelHigh = candle.HighPrice;
				if (candle.LowPrice < _channelLow)
					_channelLow = candle.LowPrice;
			}
		}
		else if (stdDevValue > _previousStdDev)
		{
			_flatBarCount = 0;
			_channelHigh = 0m;
			_channelLow = 0m;
			_pendingBuyPrice = null;
			_pendingSellPrice = null;
		}
		else if (_flatBarCount >= FlatBars && _channelHigh <= _channelLow)
		{
			_channelHigh = upper;
			_channelLow = lower;
		}
	}

	private void CheckPendingEntries(ICandleMessage candle)
	{
		if (Position != 0)
			return;

		if (_pendingBuyPrice is decimal buyPrice && candle.HighPrice >= buyPrice)
		{
			BuyMarket();
			_entryPrice = buyPrice;
			_pendingBuyPrice = null;
			_pendingSellPrice = null;
			return;
		}

		if (_pendingSellPrice is decimal sellPrice && candle.LowPrice <= sellPrice)
		{
			SellMarket();
			_entryPrice = sellPrice;
			_pendingBuyPrice = null;
			_pendingSellPrice = null;
		}
	}

	private void ManagePosition(ICandleMessage candle)
	{
		if (Position > 0)
		{
			if (_longStop > 0m && candle.LowPrice <= _longStop)
			{
				SellMarket();
				ResetPositionState();
				return;
			}
			if (_longTake > 0m && candle.HighPrice >= _longTake)
			{
				SellMarket();
				ResetPositionState();
			}
		}
		else if (Position < 0)
		{
			if (_shortStop > 0m && candle.HighPrice >= _shortStop)
			{
				BuyMarket();
				ResetPositionState();
				return;
			}
			if (_shortTake > 0m && candle.LowPrice <= _shortTake)
			{
				BuyMarket();
				ResetPositionState();
			}
		}
	}

	private void ResetPositionState()
	{
		_entryPrice = 0m;
		_longStop = 0m;
		_longTake = 0m;
		_shortStop = 0m;
		_shortTake = 0m;
		_pendingBuyPrice = null;
		_pendingSellPrice = null;
	}
}