Ver no GitHub

Estratégia Exp XHullTrend Digit

Visão geral

  • Conversão do especialista MQL5 Exp_XHullTrend_Digit.mq5 localizado em MQL/22117.
  • Usa a API de alto nível do StockSharp com o XHullTrendDigitIndicator personalizado que replica a lógica original do XHullTrend Digit.
  • Focado no seguidor de tendência de médio prazo no período configurado do indicador (padrão de 8 horas).

Lógica do indicador

  1. O preço é obtido da fonte de vela selecionada (fechamento por padrão).
  2. Duas médias móveis são calculadas com comprimentos BaseLength e BaseLength / 2 usando o método de suavização escolhido (simples, exponencial, suavizado ou ponderado).
  3. Uma projeção estilo Hull 2 * shortMA - longMA é suavizada duas vezes: primeiro por SignalLength, depois por sqrt(BaseLength).
  4. Ambas as linhas resultantes são arredondadas para o múltiplo mais próximo do passo do instrumento escalonado por 10^RoundingDigits para imitar o arredondamento de dígitos da versão MQL5.
  5. Quando o arredondamento produz valores iguais enquanto os valores brutos diferem, a linha mais rápida é deslocada um passo na direção da diferença para que o cruzamento permaneça detectável.

Regras de negociação

  • Os sinais são avaliados apenas em velas fechadas.
  • SignalBar define quantas barras atrás são usadas para a detecção do cruzamento (1 = usar a barra completada anterior contra a barra anterior a ela).
  • Entrada comprada: linha rápida anterior acima da lenta e a linha rápida da barra selecionada em ou abaixo da lenta (cruzamento para cima). As posições vendidas são opcionalmente fechadas ao mesmo tempo.
  • Entrada vendida: linha rápida anterior abaixo da lenta e a linha rápida da barra selecionada em ou acima da lenta (cruzamento para baixo). As posições compradas são fechadas simultaneamente de forma opcional.
  • Saída comprada: quando a linha rápida anterior cai abaixo da lenta.
  • Saída vendida: quando a linha rápida anterior sobe acima da lenta.
  • Se um sinal de reversão aparecer enquanto mantém a posição oposta, a estratégia envia a ordem de fechamento seguida por uma ordem dimensionada para inverter a posição à nova direção.

Parâmetros

  • OrderVolume – volume para entradas de mercado.
  • StopLoss / TakeProfit – distâncias de proteção opcionais em passos de preço (convertidas para UnitTypes.Step do StockSharp).
  • EnableBuyEntry, EnableSellEntry – permitir ou bloquear novas posições em cada direção.
  • EnableBuyExit, EnableSellExit – controlar saídas automáticas para lados comprado e vendido.
  • CandleType – período usado para cálculos do indicador (período padrão de 8 horas).
  • BaseLength – comprimento de suavização base para o indicador (equivale a XLength no MQL5).
  • SignalLength – comprimento da suavização Hull intermediária (HLength no MQL5).
  • PriceSource – preço de vela usado para cálculos (fechamento/abertura/máximo/mínimo/típico/ponderado/mediano/médio).
  • SmoothMethod – tipo de média móvel para todas as etapas de suavização (simples, exponencial, suavizado, ponderado).
  • Phase – mantido para compatibilidade; sem efeito com os tipos de suavização suportados.
  • RoundingDigits – número de ajustes de dígitos adicionais aplicados durante o arredondamento.
  • SignalBar – deslocamento de barra para avaliação de sinais (0 = barra fechada atual, 1 = barra anterior, etc.).

Gestão de risco

  • Stop loss e take profit opcionais gerenciados pelo helper StartProtection incorporado usando distâncias baseadas em passos.
  • O volume pode ser ajustado via OrderVolume para corresponder ao tamanho do instrumento alvo.

Notas

  • O indicador personalizado reproduz o comportamento de arredondamento do script original; certifique-se de que Security.PriceStep esteja configurado para arredondamento preciso.
  • Apenas os suavizamentos SMA, EMA, SMMA (RMA) e LWMA são implementados porque a biblioteca padrão do StockSharp os fornece de série. Outros modos de suavização exóticos da fonte MQL5 podem ser adicionados posteriormente se necessário.
  • Funciona em qualquer instrumento que forneça velas para o período selecionado. Ajuste dígitos de arredondamento e comprimento base ao alternar entre ativos com diferentes tamanhos de tick.
using System;
using System.Collections.Generic;

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

namespace StockSharp.Samples.Strategies;

public class ExpXHullTrendDigitStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _fastPeriod;
	private readonly StrategyParam<int> _slowPeriod;
	private decimal? _prevFast, _prevSlow;

	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }
	public int FastPeriod { get => _fastPeriod.Value; set => _fastPeriod.Value = value; }
	public int SlowPeriod { get => _slowPeriod.Value; set => _slowPeriod.Value = value; }

	public ExpXHullTrendDigitStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(1).TimeFrame()).SetDisplay("Candle Type", "Timeframe", "General");
		_fastPeriod = Param(nameof(FastPeriod), 9).SetGreaterThanZero().SetDisplay("Fast WMA", "Fast period", "Indicators");
		_slowPeriod = Param(nameof(SlowPeriod), 25).SetGreaterThanZero().SetDisplay("Slow WMA", "Slow period", "Indicators");
	}

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

	/// <inheritdoc />
	protected override void OnReseted()
	{
		base.OnReseted();
		_prevFast = null;
		_prevSlow = null;
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);
		_prevFast = null; _prevSlow = null;
		var fast = new WeightedMovingAverage { Length = FastPeriod };
		var slow = new WeightedMovingAverage { Length = SlowPeriod };
		var subscription = SubscribeCandles(CandleType);
		subscription.Bind(fast, slow, ProcessCandle).Start();
		var area = CreateChartArea();
		if (area != null) { DrawCandles(area, subscription); DrawIndicator(area, fast); DrawIndicator(area, slow); DrawOwnTrades(area); }
	}

	private void ProcessCandle(ICandleMessage candle, decimal fast, decimal slow)
	{
		if (candle.State != CandleStates.Finished) return;
		if (!IsFormedAndOnlineAndAllowTrading()) { _prevFast = fast; _prevSlow = slow; return; }
		if (_prevFast == null || _prevSlow == null) { _prevFast = fast; _prevSlow = slow; return; }
		var prevAbove = _prevFast.Value > _prevSlow.Value;
		var currAbove = fast > slow;
		_prevFast = fast; _prevSlow = slow;
		if (!prevAbove && currAbove && Position <= 0) { if (Position < 0) BuyMarket(); BuyMarket(); }
		else if (prevAbove && !currAbove && Position >= 0) { if (Position > 0) SellMarket(); SellMarket(); }
	}
}