Esta estratégia é um port StockSharp do expert advisor do MetaTrader 4 FxNode - Safe Tunnel. O sistema usa um canal de tendência baseado em ZigZag: as máximas de swing mais recentes são conectadas para formar uma linha de resistência, enquanto as mínimas de swing criam uma linha de suporte. Uma posição é aberta quando o preço de mercado toca um dos limites do canal dentro de uma tolerância configurável e todas as verificações de segurança passam.
A conversão segue o fluxo de trabalho original, mas o adapta à API de alto nível do StockSharp:
A assinatura de velas impulsiona a lógica. Apenas velas completamente formadas são processadas.
Um par Highest/Lowest emula o detector ZigZag usado para desenhar as linhas de tendência do túnel.
Um indicador AverageTrueRange fornece a âncora de stop baseada em volatilidade que a versão MQL produzia com ATRCheck() * 10.
As cotações Level1 são monitoradas para que a estratégia possa impor um spread máximo antes de permitir novos trades.
Lógica de entrada
Detectar máximas e mínimas de swing com uma profundidade ZigZag configurável, desvio (em pips) e backstep. As duas máximas e duas mínimas mais recentes definem as linhas de tendência.
Calcular o preço de cada linha de tendência no tempo de fechamento da vela atual e medir a distância vertical entre a última máxima e mínima de swing.
Configuração comprada: o melhor preço ask deve permanecer acima da linha de tendência inferior, mas não mais longe do que o buffer TouchDistanceBuyPips. As posições vendidas espelham a condição em torno da linha de tendência superior e o melhor bid.
O filtro de sessão opcional (padrão meia-noite–06:00) deve permitir o trading. A estratégia também bloqueia novas ordens na sexta-feira, sábado e domingo, imitando as restrições originais de AllowToOrder().
O spread atual (ask – bid) não deve exceder MaxSpreadPips quando as cotações estão disponíveis.
MaxOpenPositions controla a exposição líquida máxima. Como o StockSharp usa netting, este valor age como um limite no volume total da posição em vez de em tickets separados.
Lógica de saída
Stop-loss inicial: o EA original o colocava em ATR * 10. O port mantém o mesmo multiplicador respeitando o limite MaxStopLossPips.
Take-profit inicial: padrão é a distância entre a última máxima e mínima de swing, mas é limitado por TakeProfitPips quando configurado.
Alvo de lucro fixo: se FixedTakeProfitPips for maior que zero, a posição é fechada quando o preço ganha pelo menos essa quantidade de pips a partir da entrada.
Trailing stop: uma vez que o fechamento da vela se move mais de TrailingStopPips a favor do trade, o stop-loss é ajustado para travar lucros.
Saída de fim de semana: quando CloseBeforeWeekend está habilitado, qualquer posição aberta é fechada após as 23:50 de sexta-feira.
Todas as saídas são executadas com ordens a mercado para permanecer consistentes com o comportamento original.
Risco e dimensionamento
O tamanho do lote é calculado em três estágios:
Tentar arriscar RiskPercentage do valor do portfólio, assumindo que o passo de preço do instrumento e o valor monetário do passo são conhecidos.
Se o dimensionamento por risco não puder ser calculado, recorrer ao StaticVolume.
Limitar o volume final entre MinVolume e MaxVolume.
Como o StockSharp relata uma única posição líquida por instrumento, o limite original de MaxOpenPosition é interpretado como uma exposição total máxima em vez de uma contagem de tickets independentes.
Parâmetros
Nome
Padrão
Descrição
CandleType
Velas de 30 minutos
Período principal para análise e trading.
TrendPreference
Ambos
Escolher trading somente comprado, somente vendido ou simétrico.
TakeProfitPips
800
Distância máxima de take-profit em pips (0 desativa o limite).
MaxStopLossPips
200
Distância máxima de stop-loss em pips (0 desativa o limite).
FixedTakeProfitPips
0
Distância de saída antecipada expressa em pips.
TouchDistanceBuyPips
20
Entradas compradas requerem que o preço ask permaneça dentro deste buffer acima da linha de tendência inferior.
TouchDistanceSellPips
20
Entradas vendidas espelham o requisito de buffer próximo à linha de tendência superior.
TrailingStopPips
50
Distância de trailing aplicada após o trade se tornar lucrativo.
StaticVolume
1
Volume de ordem alternativo quando o dimensionamento baseado em risco não é possível.
MinVolume / MaxVolume
0.02 / 10
Limites para o volume final da ordem.
MaxSpreadPips
15
Spread máximo permitido em pips para novas entradas.
RiskPercentage
30
Percentual do portfólio arriscado por trade. Definir como 0 para sempre usar StaticVolume.
MaxOpenPositions
1
Exposição líquida máxima (em múltiplos do volume de ordem atual).
UseTimeFilter
true
Habilita a janela de trading.
SessionStart / SessionEnd
00:00 / 06:00
Janela de trading. Quando o início é posterior ao fim, a janela se estende pela meia-noite.
CloseBeforeWeekend
true
Fechar qualquer posição após as 23:50 de sexta-feira.
AtrPeriod
14
Lookback do ATR usado para o cálculo do stop.
ZigZagDepth
5
Profundidade de lookback do ZigZag.
ZigZagDeviationPips
3
Distância mínima entre pivôs consecutivos (em pips).
ZigZagBackstep
1
Barras entre pivôs elegíveis.
ZigZagHistory
10
Número de pivôs armazenados para a projeção de linhas de tendência.
Notas e limitações
A reconstrução do ZigZag espelha o comportamento MQL combinando os indicadores Highest/Lowest com filtros de desvio e backstep. Se o instrumento negocia em uma sessão personalizada, considere ajustar os parâmetros para alinhá-los com o indicador original.
A filtragem de spread requer cotações bid/ask ao vivo. Quando as cotações estão ausentes (por exemplo, durante o backtesting com dados apenas de velas), o filtro de spread é ignorado.
O port opera com posições líquidas. Ambientes que requerem gerenciamento independente de tickets devem estender a estratégia para rastrear cada execução separadamente.
As strings de tempo da versão MQL (p. ex., "24:00") são substituídas por parâmetros TimeSpan. Para reproduzir uma sessão noturna, defina o início mais tarde que o fim, por exemplo 23:30 a 05:30.
Uso
Anexar a estratégia a um instrumento, configurar o tipo de vela e os parâmetros, e executá-la em modo de simulação ou ao vivo.
Garantir que as assinaturas de profundidade de mercado ou Level1 estejam habilitadas para aplicar o filtro de spread com precisão.
Revisar e ajustar os controles de risco antes de negociar com capital real.
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>
/// Simplified conversion of the FxNode Safe Tunnel EA.
/// Uses Highest/Lowest channel (tunnel) with ATR-based stops.
/// Buys near the lower boundary and sells near the upper boundary.
/// </summary>
public class FxNodeSafeTunnelStrategy : Strategy
{
private readonly StrategyParam<DataType> _candleType;
private readonly StrategyParam<int> _channelPeriod;
private readonly StrategyParam<int> _atrPeriod;
private readonly StrategyParam<decimal> _touchPct;
private decimal _entryPrice;
private int _cooldown;
public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }
public int ChannelPeriod { get => _channelPeriod.Value; set => _channelPeriod.Value = value; }
public int AtrPeriod { get => _atrPeriod.Value; set => _atrPeriod.Value = value; }
public decimal TouchPct { get => _touchPct.Value; set => _touchPct.Value = value; }
public FxNodeSafeTunnelStrategy()
{
_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(5).TimeFrame())
.SetDisplay("Candle Type", "Timeframe", "General");
_channelPeriod = Param(nameof(ChannelPeriod), 100)
.SetGreaterThanZero()
.SetDisplay("Channel Period", "Lookback for Highest/Lowest channel", "Indicator");
_atrPeriod = Param(nameof(AtrPeriod), 14)
.SetGreaterThanZero()
.SetDisplay("ATR Period", "ATR lookback for stops", "Indicator");
_touchPct = Param(nameof(TouchPct), 0.02m)
.SetDisplay("Touch %", "How close price must be to channel boundary (0-1)", "Indicator");
}
/// <inheritdoc />
public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
{
yield return (Security, CandleType);
}
/// <inheritdoc />
protected override void OnReseted()
{
base.OnReseted();
_entryPrice = 0;
_cooldown = 0;
}
/// <inheritdoc />
protected override void OnStarted2(DateTime time)
{
base.OnStarted2(time);
_entryPrice = 0;
var highest = new Highest { Length = ChannelPeriod };
var lowest = new Lowest { Length = ChannelPeriod };
var atr = new AverageTrueRange { Length = AtrPeriod };
var subscription = SubscribeCandles(CandleType);
subscription
.Bind(highest, lowest, atr, ProcessCandle)
.Start();
var area = CreateChartArea();
if (area != null)
{
DrawCandles(area, subscription);
DrawIndicator(area, highest);
DrawIndicator(area, lowest);
DrawOwnTrades(area);
}
}
private void ProcessCandle(ICandleMessage candle, decimal high, decimal low, decimal atrVal)
{
if (candle.State != CandleStates.Finished)
return;
if (_cooldown > 0)
{
_cooldown--;
return;
}
var channelWidth = high - low;
if (channelWidth <= 0)
return;
var touchZone = channelWidth * TouchPct;
var close = candle.ClosePrice;
// Check stop/take for active positions
if (Position > 0)
{
// Exit long: price near upper channel or stop loss
if (close >= high - touchZone || (_entryPrice > 0 && close < _entryPrice - atrVal * 2))
{
SellMarket();
_entryPrice = 0;
_cooldown = 10;
return;
}
}
else if (Position < 0)
{
// Exit short: price near lower channel or stop loss
if (close <= low + touchZone || (_entryPrice > 0 && close > _entryPrice + atrVal * 2))
{
BuyMarket();
_entryPrice = 0;
_cooldown = 10;
return;
}
}
// Entry signals
if (Position <= 0 && close <= low + touchZone)
{
// Price near lower boundary - buy
if (Position < 0) BuyMarket(); // close short first
BuyMarket();
_entryPrice = close;
_cooldown = 10;
}
else if (Position >= 0 && close >= high - touchZone)
{
// Price near upper boundary - sell
if (Position > 0) SellMarket(); // close long first
SellMarket();
_entryPrice = close;
_cooldown = 10;
}
}
}
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, AverageTrueRange
from StockSharp.Algo.Strategies import Strategy
class fx_node_safe_tunnel_strategy(Strategy):
def __init__(self):
super(fx_node_safe_tunnel_strategy, self).__init__()
self._candle_type = self.Param("CandleType", DataType.TimeFrame(TimeSpan.FromMinutes(5))) \
.SetDisplay("Candle Type", "Timeframe", "General")
self._channel_period = self.Param("ChannelPeriod", 100) \
.SetGreaterThanZero() \
.SetDisplay("Channel Period", "Lookback for Highest/Lowest channel", "Indicator")
self._atr_period = self.Param("AtrPeriod", 14) \
.SetGreaterThanZero() \
.SetDisplay("ATR Period", "ATR lookback for stops", "Indicator")
self._touch_pct = self.Param("TouchPct", 0.02) \
.SetDisplay("Touch %", "How close price must be to channel boundary (0-1)", "Indicator")
self._entry_price = 0.0
self._cooldown = 0
@property
def candle_type(self):
return self._candle_type.Value
@property
def channel_period(self):
return self._channel_period.Value
@property
def atr_period(self):
return self._atr_period.Value
@property
def touch_pct(self):
return self._touch_pct.Value
def OnReseted(self):
super(fx_node_safe_tunnel_strategy, self).OnReseted()
self._entry_price = 0.0
self._cooldown = 0
def OnStarted2(self, time):
super(fx_node_safe_tunnel_strategy, self).OnStarted2(time)
self._entry_price = 0.0
highest = Highest()
highest.Length = self.channel_period
lowest = Lowest()
lowest.Length = self.channel_period
atr = AverageTrueRange()
atr.Length = self.atr_period
subscription = self.SubscribeCandles(self.candle_type)
subscription.Bind(highest, lowest, atr, self.process_candle).Start()
area = self.CreateChartArea()
if area is not None:
self.DrawCandles(area, subscription)
self.DrawIndicator(area, highest)
self.DrawIndicator(area, lowest)
self.DrawOwnTrades(area)
def process_candle(self, candle, high, low, atr_val):
if candle.State != CandleStates.Finished:
return
if self._cooldown > 0:
self._cooldown -= 1
return
high = float(high)
low = float(low)
atr_val = float(atr_val)
channel_width = high - low
if channel_width <= 0:
return
touch_zone = channel_width * float(self.touch_pct)
close = float(candle.ClosePrice)
if self.Position > 0:
if close >= high - touch_zone or (self._entry_price > 0 and close < self._entry_price - atr_val * 2):
self.SellMarket()
self._entry_price = 0.0
self._cooldown = 10
return
elif self.Position < 0:
if close <= low + touch_zone or (self._entry_price > 0 and close > self._entry_price + atr_val * 2):
self.BuyMarket()
self._entry_price = 0.0
self._cooldown = 10
return
if self.Position <= 0 and close <= low + touch_zone:
if self.Position < 0:
self.BuyMarket()
self.BuyMarket()
self._entry_price = close
self._cooldown = 10
elif self.Position >= 0 and close >= high - touch_zone:
if self.Position > 0:
self.SellMarket()
self.SellMarket()
self._entry_price = close
self._cooldown = 10
def CreateClone(self):
return fx_node_safe_tunnel_strategy()