Ver no GitHub

Estratégia de Candle

Visão geral

A Estratégia de Candle é um port direto do clássico expert MT5 "Candle.mq5". Avalia a cor de cada candle concluído no timeframe selecionado e mantém a posição alinhada com o fechamento mais recente. Candles de alta levam a estratégia para comprado, candles de baixa para vendido, e candles planos deixam a posição inalterada. O risco é controlado por distâncias de take-profit e trailing stop em pips que são convertidas a preços absolutos através do tamanho de tick do instrumento.

A estratégia só reage após um candle estar completamente formado para evitar ruído dentro da barra. Um lookback obrigatório (MinBars * 2 candles concluídos) valida que o gráfico contém histórico suficiente, enquanto um período de esfriamento configurável aguarda entre operações. Isso produz uma implementação fiel em StockSharp da lógica MetaTrader original sem depender de acesso a séries de baixo nível.

Lógica de trading

Preparação

  • Processa candles fornecidos por CandleType; nenhuma outra fonte de dados é necessária.
  • Aguarda até que pelo menos 2 * MinBars candles concluídos tenham sido processados antes de permitir entradas.
  • Opera apenas quando a estratégia está online, formada e tem permissão para executar ordens.
  • Aplica o intervalo TradeCooldown (padrão: 10 segundos) entre quaisquer duas operações.

Regras de entrada e reversão

  1. Estado plano:
    • Entrar comprado (BuyMarket) quando um candle fecha acima de sua abertura.
    • Entrar vendido (SellMarket) quando um candle fecha abaixo de sua abertura.
  2. Posição existente:
    • Se uma posição comprada enfrenta um candle de baixa, vender |Position| + Volume para fechar e imediatamente reverter para uma posição vendida de tamanho Volume.
    • Se uma posição vendida enfrenta um candle de alta, comprar |Position| + Volume para fechar e imediatamente reverter para uma posição comprada de tamanho Volume.
  3. Candles neutros:
    • Quando o fechamento é igual à abertura, nenhuma ação manual é tomada; apenas as ordens protetoras podem sair da operação.

Gestão de risco e saídas

  • StartProtection anexa um take-profit e um trailing stop medidos em pips. A estratégia multiplica cada valor de pip por (PriceStep * 10) para corresponder ao ajuste do MetaTrader para cotações de 3 e 5 dígitos.
  • O trailing stop é ativado apenas quando TrailingStopPips é maior que zero; segue o preço automaticamente uma vez que a operação se move na direção favorável.
  • O take-profit fecha a posição quando a distância configurada é atingida. Qualquer nível protetor cancela a ordem oposta após a execução.
  • Reversões manuais causadas pela cor do candle também liquidam a exposição anterior antes de abrir a nova posição.

Parâmetros

  • CandleType – período do candle da série a analisar (padrão: candles de 15 minutos).
  • TakeProfitPips – distância ao alvo de take-profit em pips (padrão: 50).
  • TrailingStopPips – distância do trailing stop em pips (padrão: 30).
  • MinBars – contagem mínima de barras necessária antes da primeira operação (padrão: 26; a estratégia aguarda 52 candles concluídos).
  • TradeCooldown – período de espera após qualquer ação de trading (padrão: 10 segundos).

Defina a propriedade Volume da estratégia com o tamanho de ordem desejado. Quando o mercado reverte, a estratégia envia automaticamente volume suficiente tanto para sair da posição anterior quanto para estabelecer a nova.

Notas de implementação

  • Apenas candles concluídos (CandleStates.Finished) são processados. Isso reflete o expert MetaTrader, que dependia de valores de barra fechada obtidos via CopyOpen/CopyClose.
  • O código usa a API de alto nível do StockSharp: SubscribeCandles para dados, Bind para processar barras entrantes e BuyMarket/SellMarket para execução de ordens.
  • Ordens protetoras são gerenciadas por StartProtection, portanto não é necessário manter registro manual de ordens stop-limit.
  • O cálculo do tamanho do pip PriceStep * 10 reproduz a lógica "digits adjust" do MQL para símbolos cotados com 3 ou 5 casas decimais.
  • Como as entradas são acionadas pelo corpo do candle mais recente, a estratégia tende a permanecer no mercado continuamente, alternando lados sempre que a cor do candle muda.

Ajuste as distâncias em pips, o período de esfriamento e o timeframe para corresponder ao instrumento sendo negociado. A configuração padrão reflete a amostra MT5 original, mas pode ser otimizada através do framework de parâmetros do StockSharp.

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>
/// Candle color reversal strategy with pip-based protection and trade cooldown.
/// </summary>
public class CandleStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<decimal> _takeProfitPips;
	private readonly StrategyParam<decimal> _trailingStopPips;
	private readonly StrategyParam<int> _minBars;
	private readonly StrategyParam<TimeSpan> _tradeCooldown;

	private decimal _pipSize;
	private int _finishedCandles;
	private DateTimeOffset _nextAllowedTime;

	/// <summary>
	/// Initializes a new instance of the <see cref="CandleStrategy"/>.
	/// </summary>
	public CandleStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Timeframe used for candle evaluation", "General");

		_takeProfitPips = Param(nameof(TakeProfitPips), 50m)
			.SetDisplay("Take Profit (pips)", "Distance to take profit in pips", "Risk")
			.SetGreaterThanZero();

		_trailingStopPips = Param(nameof(TrailingStopPips), 30m)
			.SetDisplay("Trailing Stop (pips)", "Trailing stop distance in pips", "Risk")
			.SetGreaterThanZero();

		_minBars = Param(nameof(MinBars), 26)
			.SetDisplay("Minimum Bars", "History length required before trading", "General")
			.SetGreaterThanZero();

		_tradeCooldown = Param(nameof(TradeCooldown), TimeSpan.FromSeconds(10))
			.SetDisplay("Trade Cooldown", "Waiting time after each trade", "Risk");
	}

	/// <summary>
	/// Candle type and timeframe used by the strategy.
	/// </summary>
	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	/// <summary>
	/// Take profit distance expressed in pips.
	/// </summary>
	public decimal TakeProfitPips
	{
		get => _takeProfitPips.Value;
		set => _takeProfitPips.Value = value;
	}

	/// <summary>
	/// Trailing stop distance expressed in pips.
	/// </summary>
	public decimal TrailingStopPips
	{
		get => _trailingStopPips.Value;
		set => _trailingStopPips.Value = value;
	}

	/// <summary>
	/// Minimum number of bars required on the chart.
	/// </summary>
	public int MinBars
	{
		get => _minBars.Value;
		set => _minBars.Value = value;
	}

	/// <summary>
	/// Cooldown between consecutive trading operations.
	/// </summary>
	public TimeSpan TradeCooldown
	{
		get => _tradeCooldown.Value;
		set => _tradeCooldown.Value = value;
	}

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

		_pipSize = 0m;
		_finishedCandles = 0;
		_nextAllowedTime = DateTimeOffset.MinValue;
	}

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

		_pipSize = (Security?.PriceStep ?? 1m) * 10m;

		Unit takeProfit = TakeProfitPips > 0m && _pipSize > 0m
			? new Unit(TakeProfitPips * _pipSize, UnitTypes.Absolute)
			: null;

		Unit trailingStop = TrailingStopPips > 0m && _pipSize > 0m
			? new Unit(TrailingStopPips * _pipSize, UnitTypes.Absolute)
			: null;

		// Enable automatic protective orders and trailing stop handling.
		if (trailingStop != null || takeProfit != null)
			StartProtection(takeProfit, trailingStop);

		// Subscribe to candle data for the configured timeframe.
		var subscription = SubscribeCandles(CandleType);
		subscription
			.Bind(ProcessCandle)
			.Start();

		// Draw candles and executions on the chart if visualization is available.
		var area = CreateChartArea();
		if (area != null)
		{
			DrawCandles(area, subscription);
			DrawOwnTrades(area);
		}
	}

	private void ProcessCandle(ICandleMessage candle)
	{
		// Skip unfinished candles to work only with final prices.
		if (candle.State != CandleStates.Finished)
			return;

		_finishedCandles++;

		// Wait until the chart has enough historical data.
		if (_finishedCandles < MinBars * 2)
			return;

		var time = candle.CloseTime;

		// Enforce cooldown between trading operations.
		if (time < _nextAllowedTime)
			return;

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

		var tradeExecuted = false;

		if (Position > 0 && isBearish)
		{
			// Reverse from long to short when a bearish candle appears.
			var volume = Math.Abs(Position) + Volume;
			if (volume > 0m)
			{
				SellMarket();
				tradeExecuted = true;
			}
		}
		else if (Position < 0 && isBullish)
		{
			// Reverse from short to long when a bullish candle appears.
			var volume = Math.Abs(Position) + Volume;
			if (volume > 0m)
			{
				BuyMarket();
				tradeExecuted = true;
			}
		}
		else if (Position == 0)
		{
			if (isBullish)
			{
				// Enter long on bullish close.
				if (Volume > 0m)
				{
					BuyMarket();
					tradeExecuted = true;
				}
			}
			else if (isBearish)
			{
				// Enter short on bearish close.
				if (Volume > 0m)
				{
					SellMarket();
					tradeExecuted = true;
				}
			}
		}

		if (tradeExecuted)
		{
			_nextAllowedTime = time + TradeCooldown;
		}
	}
}