Português
Ver no GitHub

EMA Estratégia cruzada de 12/06

Esta estratégia replica o consultor especialista MetaTrader que negocia o cruzamento entre um EMA(6) rápido e um EMA(12) lento. Ele assina velas horárias por padrão, calcula ambas as médias móveis e aguarda um cruzamento confirmado no fechamento de uma vela antes de agir.

Lógica de negociação

  • Entrada:
    • Um sinal de alta aparece quando EMA(6) cruza acima de EMA(12). A estratégia abre uma posição longa se não houver posição ativa.
    • Um sinal de baixa aparece quando EMA(6) cruza abaixo de EMA(12). A estratégia abre uma posição curta se não houver posição ativa.
  • Sair:
    • Quando UseCloseSignals está habilitado (comportamento padrão), a estratégia fecha a posição atual assim que um cruzamento oposto for detectado. Ele aguarda o próximo cruzamento antes de abrir uma nova negociação, espelhando o consultor especialista original.
    • As proteções opcionais de take-profit e trailing stop são gerenciadas por meio do auxiliar StartProtection integrado do StockSharp.
  • Dimensionamento da posição:
    • Os pedidos usam o parâmetro OrderVolume (padrão 1 lote). Os volumes são alinhados às configurações de segurança antes do envio dos pedidos.

Gestão de risco

  • Trailing stop: Converte a configuração original de "pontos" em etapas de preço. Quando maior que zero, o stop segue automaticamente na direção da negociação assim que a posição se tornar lucrativa.
  • Take Profit: Expresso em etapas de preço. Defina como zero para desativar.
  • A estratégia nunca faz médias baixas ou pirâmides. Apenas uma posição por símbolo é permitida.

Parâmetros

Parâmetro Descrição
CandleType Período usado para construir velas e EMAs. O padrão é 1 hora.
OrderVolume Tamanho comercial em lotes.
ShortEmaLength Período para o EMA rápida (padrão 6).
LongEmaLength Período para o EMA lenta (padrão 12).
UseCloseSignals Fecha a posição atual em um crossover oposto (padrão: habilitado).
TrailingStopSteps Distância final em etapas de preço. Zero desativa o rastreamento.
TakeProfitSteps Calcule a distância do lucro nas etapas de preço. Zero o desativa.

Notas

  • Os sinais são processados apenas em velas acabadas para evitar ruído intrabarra.
  • Os valores anteriores das EMAs são mantidos após o fechamento para identificar somente novos cruzamentos; um cruzamento de saída não abre posição oposta no mesmo candle.
  • Todos os comentários do código são escritos em inglês e o recuo usa tabulações de acordo com as diretrizes do projeto.
namespace StockSharp.Samples.Strategies;

using System;
using System.Collections.Generic;

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

/// <summary>
/// EMA(6)/EMA(12) crossover: enter while flat and close (never reverse on the
/// same crossover) when the close-signals switch is enabled.
/// </summary>
public class Ema612Strategy : Strategy
{
	private readonly StrategyParam<int> _shortEmaLength;
	private readonly StrategyParam<int> _longEmaLength;
	private readonly StrategyParam<bool> _useCloseSignals;
	private readonly StrategyParam<decimal> _orderVolume;
	private readonly StrategyParam<decimal> _trailingStopSteps;
	private readonly StrategyParam<decimal> _takeProfitSteps;
	private readonly StrategyParam<DataType> _candleType;
	private decimal? _previousFast;
	private decimal? _previousSlow;
	private Order _pendingOrder;

	public int ShortEmaLength { get => _shortEmaLength.Value; set => _shortEmaLength.Value = value; }
	public int LongEmaLength { get => _longEmaLength.Value; set => _longEmaLength.Value = value; }
	public bool UseCloseSignals { get => _useCloseSignals.Value; set => _useCloseSignals.Value = value; }
	public decimal OrderVolume { get => _orderVolume.Value; set => _orderVolume.Value = value; }
	public decimal TrailingStopSteps { get => _trailingStopSteps.Value; set => _trailingStopSteps.Value = value; }
	public decimal TakeProfitSteps { get => _takeProfitSteps.Value; set => _takeProfitSteps.Value = value; }
	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }

	public Ema612Strategy()
	{
		_shortEmaLength = Param(nameof(ShortEmaLength), 6).SetGreaterThanZero()
			.SetDisplay("Short EMA", "Period of the fast EMA", "Indicators");
		_longEmaLength = Param(nameof(LongEmaLength), 12).SetGreaterThanZero()
			.SetDisplay("Long EMA", "Period of the slow EMA", "Indicators");
		_useCloseSignals = Param(nameof(UseCloseSignals), true)
			.SetDisplay("Close Signals", "Close on an opposite cross instead of reversing", "Trading");
		_orderVolume = Param(nameof(OrderVolume), 1m).SetGreaterThanZero()
			.SetDisplay("Order Volume", "Entry size in lots", "Trading");
		_trailingStopSteps = Param(nameof(TrailingStopSteps), 0m).SetNotNegative()
			.SetDisplay("Trailing Stop Steps", "Zero disables trailing", "Protection");
		_takeProfitSteps = Param(nameof(TakeProfitSteps), 0m).SetNotNegative()
			.SetDisplay("Take Profit Steps", "Zero disables take profit", "Protection");
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(1).TimeFrame())
			.SetDisplay("Candle Type", "Input candle timeframe", "General");
	}

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

	protected override void OnReseted()
	{
		base.OnReseted();
		_previousFast = null;
		_previousSlow = null;
		_pendingOrder = null;
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);
		_previousFast = null;
		_previousSlow = null;
		_pendingOrder = null;
		Volume = NormalizeVolume(OrderVolume);
		var step = Security?.PriceStep ?? 0m;
		if (step <= 0m)
			throw new InvalidOperationException("EMA6/12 requires a valid positive PriceStep.");

		if (TakeProfitSteps > 0m || TrailingStopSteps > 0m)
			StartProtection(
				takeProfit: TakeProfitSteps > 0m ? new Unit(TakeProfitSteps * step, UnitTypes.Absolute) : new Unit(),
				stopLoss: TrailingStopSteps > 0m ? new Unit(TrailingStopSteps * step, UnitTypes.Absolute) : new Unit(),
				isStopTrailing: TrailingStopSteps > 0m,
				useMarketOrders: true, isLocalStop: true);

		var fast = new ExponentialMovingAverage { Length = ShortEmaLength };
		var slow = new ExponentialMovingAverage { Length = LongEmaLength };
		SubscribeCandles(CandleType).Bind(fast, slow, ProcessCandle).Start();
	}

	private decimal NormalizeVolume(decimal requested)
	{
		if (Security?.VolumeStep is decimal step && step > 0m)
			requested = decimal.Floor(requested / step) * step;
		if (Security?.MinVolume is decimal min && min > 0m)
			requested = Math.Max(requested, min);
		if (Security?.MaxVolume is decimal max && max > 0m)
			requested = Math.Min(requested, max);
		return requested;
	}

	private void ProcessCandle(ICandleMessage candle, decimal fast, decimal slow)
	{
		if (candle.State != CandleStates.Finished)
			return;

		var previousFast = _previousFast;
		var previousSlow = _previousSlow;
		_previousFast = fast;
		_previousSlow = slow;
		if (previousFast is null || previousSlow is null)
			return;

		var up = previousFast.Value <= previousSlow.Value && fast > slow;
		var down = previousFast.Value >= previousSlow.Value && fast < slow;
		if (!up && !down || _pendingOrder is not null &&
			_pendingOrder.State is not (OrderStates.Done or OrderStates.Failed))
			return;

		var side = up ? Sides.Buy : Sides.Sell;
		if (Position == 0m)
		{
			var volume = NormalizeVolume(OrderVolume);
			if (volume > 0m)
				Submit(side, volume);
		}
		else if (UseCloseSignals && (side == Sides.Buy && Position < 0m ||
			side == Sides.Sell && Position > 0m))
		{
			Submit(side, Math.Abs(Position));
		}
	}

	private void Submit(Sides side, decimal volume)
	{
		_pendingOrder = new Order
		{
			Security = Security,
			Portfolio = Portfolio,
			Type = OrderTypes.Market,
			Side = side,
			Volume = volume,
		};
		RegisterOrder(_pendingOrder);
	}
}