A estratégia de Troca de Intervalo XD recria o expert advisor do MetaTrader 5 Exp_XD-RangeSwitch usando a API de alto nível do StockSharp. Ela se baseia no indicador de canal personalizado XD-RangeSwitch, que traça bandas superiores e inferiores alternadas junto com setas sempre que a banda dominante muda. A estratégia pode tanto desvanecer essas setas (comportamento contra-tendência) quanto operar na direção do rompimento dependendo do parâmetro TradeDirection. O dimensionamento de ordens segue a configuração base Strategy.Volume, enquanto as fórmulas originais de gestão de dinheiro são substituídas pelos helpers de gestão de posição do StockSharp.
Recriação do indicador XD-RangeSwitch
O indicador rastreia as últimas Peaks velas completas para determinar os intervalos de máximas e mínimas mais altos.
Um canal de alta (banda inferior) é impresso quando o fechamento atual está acima da máxima mais alta das Peaks barras anteriores. Seu valor equivale à mínima mais baixa na mesma janela mais a barra atual.
Um canal de baixa (banda superior) é impresso quando o fechamento atual está abaixo da mínima mais baixa das Peaks barras anteriores. Seu valor equivale à máxima mais alta na mesma janela mais a barra atual.
Se nenhum rompimento ocorrer, os valores anteriores do canal são propagados adiante.
Sempre que um canal reaparece depois de estar vazio, a estratégia registra um sinal de seta no preço do canal. Isso reflete o comportamento dos buffers 2 e 3 do MT5 usados pelo expert original.
Apenas velas completamente terminadas são processadas, garantindo valores consistentes em execuções ao vivo e históricas.
Lógica de trading
A estratégia processa velas do período selecionado por CandleType e armazena os buffers de indicadores reconstruídos.
Para cada nova vela, ela inspeciona o valor do indicador que tem SignalBar velas de antiguidade (o código MT5 usa o mesmo deslocamento ao chamar CopyBuffer).
O mapeamento de sinais depende da opção TradeDirection:
AgainstSignal replica o comportamento padrão do MT5 — setas de alta ativam posições compradas e também solicitam fechar trades vendidos; setas de baixa ativam posições vendidas e solicitam fechar as compradas.
WithSignal inverte a interpretação, de modo que setas de alta são tratadas como pontos de saída para posições compradas e pontos de entrada para vendidas, operando efetivamente na mesma direção que o rompimento do canal.
Buffers de tendência sem setas ainda são respeitados como sinais de saída, correspondendo aos indicadores originais SELL_Close e BUY_Close.
Fechamentos sempre se executam antes das aberturas, permitindo que a estratégia zere uma posição oposta antes de entrar na nova direção.
As ordens são enviadas com helpers de execução a mercado (BuyMarket/SellMarket). Quando uma mudança ocorre enquanto uma posição oposta está aberta, a quantidade solicitada é automaticamente aumentada para compensar completamente a exposição antes de estabelecer a nova posição.
Gestão de risco
A lógica opcional de stop-loss e take-profit é fornecida através dos parâmetros UseStopLoss/StopLossPoints e UseTakeProfit/TakeProfitPoints.
As distâncias são medidas em unidades de preço absolutas, refletindo as entradas de "pontos" no script MT5.
Stops e alvos são avaliados a cada vela terminada usando os valores máximo/mínimo da vela para emular a ativação dentro da barra.
Se tanto um stop quanto um alvo estiverem ativos, o stop tem prioridade — a posição é fechada assim que qualquer nível for atingido.
Parâmetros
Nome
Padrão
Descrição
CandleType
Velas H4
Período utilizado para os cálculos do XD-RangeSwitch.
Peaks
4
Número de picos (comprimento de lookback) analisados pelo indicador.
SignalBar
1
Número de barras completas para trás ao ler os buffers do indicador.
TradeDirection
AgainstSignal
Escolher entre interpretação contra-tendência ou seguimento de tendência dos sinais.
AllowBuyEntry / AllowSellEntry
true
Habilitar ou desabilitar a abertura de novas posições na direção correspondente.
AllowBuyExit / AllowSellExit
true
Permitir que a estratégia feche posições existentes quando o indicador solicita.
UseStopLoss / StopLossPoints
true / 1000
Ativar o tratamento de stop-loss e definir sua distância em unidades de preço.
UseTakeProfit / TakeProfitPoints
true / 2000
Ativar o tratamento de take-profit e definir sua distância em unidades de preço.
Notas
Os buffers de máximas/mínimas são mantidos internamente dentro da estratégia em vez de depender de coleções do StockSharp, mantendo-se fiel à implementação do MT5 e aderindo às diretrizes de conversão.
Os sinais são avaliados apenas em velas terminadas. Se SignalBar for maior que zero, a ordem é colocada na próxima vela após a que produziu o sinal, como no expert do MT5.
Os valores do indicador são mantidos em um histórico rolante curto que se estende um pouco além do maior entre Peaks e SignalBar, garantindo uso determinístico de memória mesmo durante simulações longas.
A configuração padrão reflete os padrões do MT5: velas H4, Peaks = 4, SignalBar = 1, trading contra-tendência e um envelope de risco de 1.000/2.000 pontos.
using System;
using System.Collections.Generic;
using Ecng.Common;
using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;
namespace StockSharp.Samples.Strategies;
/// <summary>
/// XD-RangeSwitch strategy using Highest/Lowest channel breakouts.
/// Buys on breakout above channel high, sells on breakout below channel low.
/// Uses stop-loss and take-profit for risk management.
/// </summary>
public class XdRangeSwitchStrategy : Strategy
{
private readonly StrategyParam<int> _channelPeriod;
private readonly StrategyParam<int> _stopLossPoints;
private readonly StrategyParam<int> _takeProfitPoints;
private Highest _highest;
private Lowest _lowest;
private decimal _prevHigh;
private decimal _prevLow;
private decimal _entryPrice;
private int _cooldown;
/// <summary>
/// Channel lookback period.
/// </summary>
public int ChannelPeriod
{
get => _channelPeriod.Value;
set => _channelPeriod.Value = value;
}
/// <summary>
/// Stop-loss distance in price steps.
/// </summary>
public int StopLossPoints
{
get => _stopLossPoints.Value;
set => _stopLossPoints.Value = value;
}
/// <summary>
/// Take-profit distance in price steps.
/// </summary>
public int TakeProfitPoints
{
get => _takeProfitPoints.Value;
set => _takeProfitPoints.Value = value;
}
/// <summary>
/// Initializes strategy parameters.
/// </summary>
public XdRangeSwitchStrategy()
{
_channelPeriod = Param(nameof(ChannelPeriod), 200)
.SetGreaterThanZero()
.SetDisplay("Channel Period", "Lookback for highest/lowest channel", "Indicator");
_stopLossPoints = Param(nameof(StopLossPoints), 200)
.SetNotNegative()
.SetDisplay("Stop Loss", "Stop-loss distance in price steps", "Risk");
_takeProfitPoints = Param(nameof(TakeProfitPoints), 400)
.SetNotNegative()
.SetDisplay("Take Profit", "Take-profit distance in price steps", "Risk");
}
/// <inheritdoc />
public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
{
yield return (Security, TimeSpan.FromMinutes(5).TimeFrame());
}
/// <inheritdoc />
protected override void OnReseted()
{
base.OnReseted();
_highest = null;
_lowest = null;
_prevHigh = 0;
_prevLow = 0;
_entryPrice = 0;
_cooldown = 0;
}
/// <inheritdoc />
protected override void OnStarted2(DateTime time)
{
base.OnStarted2(time);
_highest = new Highest { Length = ChannelPeriod };
_lowest = new Lowest { Length = ChannelPeriod };
var subscription = SubscribeCandles(TimeSpan.FromMinutes(5).TimeFrame());
subscription.Bind(_highest, _lowest, ProcessCandle);
subscription.Start();
}
private void ProcessCandle(ICandleMessage candle, decimal highValue, decimal lowValue)
{
if (candle.State != CandleStates.Finished)
return;
if (!_highest.IsFormed || !_lowest.IsFormed)
{
_prevHigh = highValue;
_prevLow = lowValue;
return;
}
if (_cooldown > 0)
{
_cooldown--;
_prevHigh = highValue;
_prevLow = lowValue;
return;
}
var close = candle.ClosePrice;
var step = Security?.PriceStep ?? 1m;
// Check SL/TP
if (Position > 0 && _entryPrice > 0)
{
if (StopLossPoints > 0 && close <= _entryPrice - StopLossPoints * step)
{
SellMarket();
_entryPrice = 0;
_cooldown = 30;
_prevHigh = highValue;
_prevLow = lowValue;
return;
}
if (TakeProfitPoints > 0 && close >= _entryPrice + TakeProfitPoints * step)
{
SellMarket();
_entryPrice = 0;
_cooldown = 30;
_prevHigh = highValue;
_prevLow = lowValue;
return;
}
}
else if (Position < 0 && _entryPrice > 0)
{
if (StopLossPoints > 0 && close >= _entryPrice + StopLossPoints * step)
{
BuyMarket();
_entryPrice = 0;
_cooldown = 30;
_prevHigh = highValue;
_prevLow = lowValue;
return;
}
if (TakeProfitPoints > 0 && close <= _entryPrice - TakeProfitPoints * step)
{
BuyMarket();
_entryPrice = 0;
_cooldown = 30;
_prevHigh = highValue;
_prevLow = lowValue;
return;
}
}
// Breakout above previous channel high
if (close > _prevHigh && _prevHigh > 0 && Position <= 0)
{
if (Position < 0)
BuyMarket();
BuyMarket();
_entryPrice = close;
_cooldown = 30;
}
// Breakout below previous channel low
else if (close < _prevLow && _prevLow > 0 && Position >= 0)
{
if (Position > 0)
SellMarket();
SellMarket();
_entryPrice = close;
_cooldown = 30;
}
_prevHigh = highValue;
_prevLow = lowValue;
}
}
import clr
clr.AddReference("StockSharp.Messages")
clr.AddReference("StockSharp.Algo")
clr.AddReference("StockSharp.Algo.Indicators")
clr.AddReference("StockSharp.Algo.Strategies")
from System import TimeSpan
from StockSharp.Messages import DataType, CandleStates
from StockSharp.Algo.Indicators import Highest, Lowest
from StockSharp.Algo.Strategies import Strategy
class xd_range_switch_strategy(Strategy):
def __init__(self):
super(xd_range_switch_strategy, self).__init__()
self._channel_period = self.Param("ChannelPeriod", 200) \
.SetDisplay("Channel Period", "Lookback for highest/lowest channel", "Indicator")
self._stop_loss_points = self.Param("StopLossPoints", 200) \
.SetDisplay("Stop Loss", "Stop-loss distance in price steps", "Risk")
self._take_profit_points = self.Param("TakeProfitPoints", 400) \
.SetDisplay("Take Profit", "Take-profit distance in price steps", "Risk")
self._highest = None
self._lowest = None
self._prev_high = 0.0
self._prev_low = 0.0
self._entry_price = 0.0
self._cooldown = 0
@property
def channel_period(self):
return self._channel_period.Value
@property
def stop_loss_points(self):
return self._stop_loss_points.Value
@property
def take_profit_points(self):
return self._take_profit_points.Value
def OnReseted(self):
super(xd_range_switch_strategy, self).OnReseted()
self._highest = None
self._lowest = None
self._prev_high = 0.0
self._prev_low = 0.0
self._entry_price = 0.0
self._cooldown = 0
def OnStarted2(self, time):
super(xd_range_switch_strategy, self).OnStarted2(time)
self._highest = Highest()
self._highest.Length = self.channel_period
self._lowest = Lowest()
self._lowest.Length = self.channel_period
subscription = self.SubscribeCandles(DataType.TimeFrame(TimeSpan.FromMinutes(5)))
subscription.Bind(self._highest, self._lowest, self._process_candle)
subscription.Start()
def _process_candle(self, candle, high_value, low_value):
if candle.State != CandleStates.Finished:
return
h_val = float(high_value)
l_val = float(low_value)
if not self._highest.IsFormed or not self._lowest.IsFormed:
self._prev_high = h_val
self._prev_low = l_val
return
if self._cooldown > 0:
self._cooldown -= 1
self._prev_high = h_val
self._prev_low = l_val
return
close = float(candle.ClosePrice)
step = float(self.Security.PriceStep) if self.Security is not None and self.Security.PriceStep is not None else 1.0
# Check SL/TP
if self.Position > 0 and self._entry_price > 0:
if self.stop_loss_points > 0 and close <= self._entry_price - self.stop_loss_points * step:
self.SellMarket()
self._entry_price = 0.0
self._cooldown = 30
self._prev_high = h_val
self._prev_low = l_val
return
if self.take_profit_points > 0 and close >= self._entry_price + self.take_profit_points * step:
self.SellMarket()
self._entry_price = 0.0
self._cooldown = 30
self._prev_high = h_val
self._prev_low = l_val
return
elif self.Position < 0 and self._entry_price > 0:
if self.stop_loss_points > 0 and close >= self._entry_price + self.stop_loss_points * step:
self.BuyMarket()
self._entry_price = 0.0
self._cooldown = 30
self._prev_high = h_val
self._prev_low = l_val
return
if self.take_profit_points > 0 and close <= self._entry_price - self.take_profit_points * step:
self.BuyMarket()
self._entry_price = 0.0
self._cooldown = 30
self._prev_high = h_val
self._prev_low = l_val
return
# Breakout above previous channel high
if close > self._prev_high and self._prev_high > 0 and self.Position <= 0:
if self.Position < 0:
self.BuyMarket()
self.BuyMarket()
self._entry_price = close
self._cooldown = 30
# Breakout below previous channel low
elif close < self._prev_low and self._prev_low > 0 and self.Position >= 0:
if self.Position > 0:
self.SellMarket()
self.SellMarket()
self._entry_price = close
self._cooldown = 30
self._prev_high = h_val
self._prev_low = l_val
def CreateClone(self):
return xd_range_switch_strategy()