Estratégia do bot KA-Gold
A Estratégia KA-Gold Bot é uma versão direta do MetaTrader consultor especialista "KA-Gold Bot". Ele negocia rompimentos de um canal personalizado no estilo Keltner e alinha sinais com filtros de tendência de médio prazo. A porta depende de StockSharp assinaturas de vela de alto nível, ligações de indicadores e parâmetros de estratégia para que o comportamento permaneça configurável na IU e pronto para otimização.
Lógica de negociação
- Calcule três médias móveis exponenciais (EMA):
- EMA(10) para confirmação rápida do impulso.
- EMA(200) para detectar a tendência de período de tempo mais alto.
- EMA(ponto final) como centro do canal; o mesmo comprimento é usado para calcular a média do intervalo da vela (alto-baixo).
- Calcule a média do intervalo diário com uma média móvel simples para formar envelopes dinâmicos:
- Banda superior = EMA(período) + SMA(máximo-baixo, ponto final).
- Banda inferior = EMA(período) - SMA(alto-baixo, ponto final).
- Uma configuração longa requer todos os seguintes itens na última vela fechada:
- Preço de fechamento acima da banda superior.
- Preço de fechamento acima de EMA(200).
- EMA(10) cruzou de baixo da banda superior anterior para acima da última banda superior.
- Uma configuração curta reflete as regras:
- Preço de fechamento abaixo da banda inferior.
- Preço de fechamento abaixo de EMA(200).
- EMA(10) cruzou de cima da banda inferior anterior para abaixo da última banda inferior.
- Apenas uma posição poderá estar aberta por vez; sinais opostos são ignorados até que a estratégia seja plana.
Dimensionamento de posições
Dois modelos de volume são suportados:
- Modo de lote fixo – use o parâmetro
BaseVolume diretamente.
- Modo percentual de risco – quando
UseRiskPercent = true, o proxy de free equity (Portfolio.CurrentValue ou Portfolio.BeginValue) é multiplicado por RiskPercent. O resultado é dimensionado em 100.000 (MetaTrader convenção de lote) e arredondado para múltiplos de BaseVolume, respeitando Security.MinVolume, Security.MaxVolume e Security.VolumeStep.
Gestão de risco
- As compensações de stop-loss e take-profit são definidas em pips. Os pips são convertidos em distâncias de preços absolutos usando a etapa de segurança. Os símbolos forex de três e cinco decimais reutilizam a regra MetaTrader
pip = step × 10.
- As ordens de proteção iniciais são registradas imediatamente após o primeiro preenchimento e mantidas em sincronia com o tamanho da posição atual.
- Os trailing stops são ativados quando o lucro não realizado atinge
TrailingTriggerPips:
- As posições longas seguem mantendo o stop
TrailingStopPips longe do fechamento.
- As posições curtas utilizam a distância simétrica acima do mercado.
- A parada é movida somente se a distância melhorar em pelo menos
TrailingStepPips para evitar acionamento excessivo.
- Quando a posição é fechada, as ordens de proteção pendentes são canceladas automaticamente.
Filtros de Sessão e Spread
- Janela de negociação opcional controlada por
UseTimeFilter, StartHour, StartMinute, EndHour e EndMinute (janela inclusiva-exclusiva). As janelas noturnas são suportadas (terminam antes da meia-noite).
- Um filtro de spread opcional rejeita novas entradas se o spread atual (diferença entre a melhor oferta e venda nas etapas de preço) exceder
MaxSpreadPoints.
Notas de implementação
- As velas são processadas via
SubscribeCandles().Bind(...); os valores EMA(10) e EMA(200) chegam por meio da ligação, enquanto o canal EMA e a média do intervalo são atualizados dentro do manipulador sem usar GetValue.
- O estado do indicador é armazenado apenas por meio de campos escalares que espelham a lógica de deslocamento MetaTrader
iClose e CopyBuffer, preservando o requisito de comparação das duas últimas barras fechadas.
- A lógica protetora e final usa auxiliares de ordem de alto nível (
BuyStop, SellStop, BuyLimit, SellLimit) para espelhar as chamadas PositionModify de MetaTrader.
- O dimensionamento baseado em portfólio depende das informações de patrimônio disponíveis em StockSharp; se estiver faltando, a estratégia volta ao volume fixo.
Parâmetros
| Parâmetro |
Descrição |
Padrão |
KeltnerPeriod |
Período para o canal EMA e suavização de intervalo. |
50 |
FastEmaPeriod |
Comprimento do filtro EMA rápida. |
10 |
SlowEmaPeriod |
Comprimento do filtro de tendência lenta EMA. |
200 |
BaseVolume |
Volume mínimo de pedido (tamanho do lote). |
0,01 |
UseRiskPercent |
Ative o dimensionamento de posição baseado em equilíbrio. |
verdade |
RiskPercent |
Percentagem do capital utilizado por negociação quando o dimensionamento de risco está ativo. |
1 |
StopLossPips |
Distância de stop-loss em pips. |
500 |
TakeProfitPips |
Distância de lucro em pips (0 desabilita). |
500 |
TrailingTriggerPips |
Limite de lucro para armar o trailing stop. |
300 |
TrailingStopPips |
Distância mantida pelo trailing stop uma vez armado. |
300 |
TrailingStepPips |
Melhoria mínima antes que o stop seja movido. |
100 |
UseTimeFilter |
Alterne o filtro da sessão de negociação. |
verdade |
StartHour, StartMinute |
Hora de início da sessão. |
02:30 |
EndHour, EndMinute |
Horário de término da sessão (exclusivo). |
21:00 |
MaxSpreadPoints |
Spread máximo permitido nas etapas de preço (0 = desabilitado). |
65 |
CandleType |
Prazo usado para velas de sinalização. |
Velas de 5 minutos |
- A implementação do trailing stop recria a sequência
PositionModify usando ordens de parada StockSharp; a funcionalidade é equivalente, mas depende de pedidos confirmados pela bolsa.
- MetaTrader calculou a largura do canal a partir da faixa média alta-baixa; a porta reproduz a mesma média com uma média móvel simples para manter os rompimentos idênticos.
- O dimensionamento do risco acessa o patrimônio do portfólio em vez da margem livre. Esta aproximação corresponde à intenção (percentagem de capital), mas pode diferir se os dados de margem específicos da alavancagem não estiverem disponíveis.
- As verificações de spread usam
Security.BestAskPrice e Security.BestBidPrice. Quando a profundidade não está disponível, o filtro é ignorado, espelhando a opção "spread flutuante" no especialista original.
Dicas de uso
- Anexe a estratégia a instrumentos onde a definição do pip segue as convenções forex (3 ou 5 casas decimais) para manter os parâmetros de risco alinhados com o especialista original.
- Otimize os períodos EMA e a duração do canal para instrumentos que não sejam de ouro porque a estratégia de origem foi ajustada para XAUUSD.
- Monitore a janela do portfólio para garantir que os valores de patrimônio sejam preenchidos quando
UseRiskPercent estiver ativado.
using System;
using Ecng.Common;
using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.Messages;
namespace StockSharp.Samples.Strategies;
/// <summary>
/// Port of the MetaTrader expert "KA-Gold Bot".
/// Trades breakouts of a Keltner-style channel confirmed by trend filters from fast and slow EMA.
/// Buys when close breaks above upper Keltner band and fast EMA is above slow EMA.
/// Sells when close breaks below lower Keltner band and fast EMA is below slow EMA.
/// Exits when price crosses the opposite Keltner band or when EMA trend reverses.
/// </summary>
public class KAGoldBotStrategy : Strategy
{
private readonly StrategyParam<int> _keltnerPeriod;
private readonly StrategyParam<int> _fastEmaPeriod;
private readonly StrategyParam<int> _slowEmaPeriod;
private readonly StrategyParam<DataType> _candleType;
private readonly StrategyParam<decimal> _bandMultiplier;
private ExponentialMovingAverage _fastEma;
private ExponentialMovingAverage _slowEma;
private ExponentialMovingAverage _keltnerEma;
private SimpleMovingAverage _rangeAverage;
private bool _prevAboveUpper;
private bool _prevBelowLower;
private decimal _entryPrice;
/// <summary>
/// Keltner channel length used for the midline EMA and range average.
/// </summary>
public int KeltnerPeriod
{
get => _keltnerPeriod.Value;
set => _keltnerPeriod.Value = value;
}
/// <summary>
/// Fast EMA period for crossover signal.
/// </summary>
public int FastEmaPeriod
{
get => _fastEmaPeriod.Value;
set => _fastEmaPeriod.Value = value;
}
/// <summary>
/// Slow EMA period for trend filter.
/// </summary>
public int SlowEmaPeriod
{
get => _slowEmaPeriod.Value;
set => _slowEmaPeriod.Value = value;
}
/// <summary>
/// Multiplier for Keltner channel band width.
/// </summary>
public decimal BandMultiplier
{
get => _bandMultiplier.Value;
set => _bandMultiplier.Value = value;
}
/// <summary>
/// Candle type used for signal generation.
/// </summary>
public DataType CandleType
{
get => _candleType.Value;
set => _candleType.Value = value;
}
public KAGoldBotStrategy()
{
_keltnerPeriod = Param(nameof(KeltnerPeriod), 50)
.SetGreaterThanZero()
.SetDisplay("Keltner Period", "Length of the EMA and range average", "Indicators");
_fastEmaPeriod = Param(nameof(FastEmaPeriod), 10)
.SetGreaterThanZero()
.SetDisplay("Fast EMA", "Period of the fast EMA filter", "Indicators");
_slowEmaPeriod = Param(nameof(SlowEmaPeriod), 30)
.SetGreaterThanZero()
.SetDisplay("Slow EMA", "Period of the slow EMA trend filter", "Indicators");
_bandMultiplier = Param(nameof(BandMultiplier), 3m)
.SetGreaterThanZero()
.SetDisplay("Band Multiplier", "Multiplier for Keltner band width", "Indicators");
_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(5).TimeFrame())
.SetDisplay("Candle Type", "Timeframe for calculations", "General");
}
protected override void OnStarted2(DateTime time)
{
base.OnStarted2(time);
_fastEma = new ExponentialMovingAverage { Length = FastEmaPeriod };
_slowEma = new ExponentialMovingAverage { Length = SlowEmaPeriod };
_keltnerEma = new ExponentialMovingAverage { Length = KeltnerPeriod };
_rangeAverage = new SimpleMovingAverage { Length = KeltnerPeriod };
_prevAboveUpper = false;
_prevBelowLower = false;
_entryPrice = 0;
var subscription = SubscribeCandles(CandleType);
subscription
.Bind(_fastEma, _slowEma, ProcessCandle)
.Start();
var area = CreateChartArea();
if (area != null)
{
DrawCandles(area, subscription);
DrawIndicator(area, _fastEma);
DrawIndicator(area, _slowEma);
DrawOwnTrades(area);
}
}
private void ProcessCandle(ICandleMessage candle, decimal fastValue, decimal slowValue)
{
if (candle.State != CandleStates.Finished)
return;
var close = candle.ClosePrice;
// Process Keltner EMA and range average manually (IsFinal=true for finished candles)
var midResult = _keltnerEma.Process(new DecimalIndicatorValue(_keltnerEma, close, candle.OpenTime) { IsFinal = true });
var rangeResult = _rangeAverage.Process(new DecimalIndicatorValue(_rangeAverage, candle.HighPrice - candle.LowPrice, candle.OpenTime) { IsFinal = true });
if (!_keltnerEma.IsFormed || !_rangeAverage.IsFormed)
return;
var mid = midResult.GetValue<decimal>();
var avgRange = rangeResult.GetValue<decimal>();
var upper = mid + avgRange * BandMultiplier;
var lower = mid - avgRange * BandMultiplier;
var aboveUpper = close > upper;
var belowLower = close < lower;
// Exit logic: close crosses opposite band
if (Position > 0 && close < lower)
{
SellMarket();
}
else if (Position < 0 && close > upper)
{
BuyMarket();
}
// Entry logic: Keltner breakout + EMA trend confirmation
if (Position == 0)
{
// Buy: close breaks above upper band, fast EMA above slow EMA
if (!_prevAboveUpper && aboveUpper && fastValue > slowValue)
{
BuyMarket();
_entryPrice = close;
}
// Sell: close breaks below lower band, fast EMA below slow EMA
else if (!_prevBelowLower && belowLower && fastValue < slowValue)
{
SellMarket();
_entryPrice = close;
}
}
_prevAboveUpper = aboveUpper;
_prevBelowLower = belowLower;
}
/// <inheritdoc />
protected override void OnReseted()
{
_fastEma = null;
_slowEma = null;
_keltnerEma = null;
_rangeAverage = null;
_prevAboveUpper = false;
_prevBelowLower = false;
_entryPrice = 0;
base.OnReseted();
}
}
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 ExponentialMovingAverage, SimpleMovingAverage
from StockSharp.Algo.Strategies import Strategy
class ka_gold_bot_strategy(Strategy):
def __init__(self):
super(ka_gold_bot_strategy, self).__init__()
self._candle_type = self.Param("CandleType", DataType.TimeFrame(TimeSpan.FromMinutes(5)))
self._keltner_period = self.Param("KeltnerPeriod", 50)
self._fast_ema_period = self.Param("FastEmaPeriod", 10)
self._slow_ema_period = self.Param("SlowEmaPeriod", 30)
self._band_multiplier = self.Param("BandMultiplier", 3.0)
self._keltner_ema_value = None
self._range_buffer = []
self._candle_count = 0
self._prev_above_upper = False
self._prev_below_lower = False
self._entry_price = 0.0
@property
def CandleType(self):
return self._candle_type.Value
@CandleType.setter
def CandleType(self, value):
self._candle_type.Value = value
@property
def KeltnerPeriod(self):
return self._keltner_period.Value
@KeltnerPeriod.setter
def KeltnerPeriod(self, value):
self._keltner_period.Value = value
@property
def FastEmaPeriod(self):
return self._fast_ema_period.Value
@FastEmaPeriod.setter
def FastEmaPeriod(self, value):
self._fast_ema_period.Value = value
@property
def SlowEmaPeriod(self):
return self._slow_ema_period.Value
@SlowEmaPeriod.setter
def SlowEmaPeriod(self, value):
self._slow_ema_period.Value = value
@property
def BandMultiplier(self):
return self._band_multiplier.Value
@BandMultiplier.setter
def BandMultiplier(self, value):
self._band_multiplier.Value = value
def OnReseted(self):
self._keltner_ema_value = None
self._range_buffer = []
self._candle_count = 0
self._prev_above_upper = False
self._prev_below_lower = False
self._entry_price = 0.0
super(ka_gold_bot_strategy, self).OnReseted()
def OnStarted2(self, time):
super(ka_gold_bot_strategy, self).OnStarted2(time)
self._keltner_ema_value = None
self._range_buffer = []
self._candle_count = 0
self._prev_above_upper = False
self._prev_below_lower = False
self._entry_price = 0.0
fast_ema = ExponentialMovingAverage()
fast_ema.Length = self.FastEmaPeriod
slow_ema = ExponentialMovingAverage()
slow_ema.Length = self.SlowEmaPeriod
subscription = self.SubscribeCandles(self.CandleType)
subscription.Bind(fast_ema, slow_ema, self._process_candle).Start()
def _process_candle(self, candle, fast_value, slow_value):
if candle.State != CandleStates.Finished:
return
close = float(candle.ClosePrice)
high = float(candle.HighPrice)
low = float(candle.LowPrice)
candle_range = high - low
period = self.KeltnerPeriod
mult = float(self.BandMultiplier)
# EMA for Keltner midline (manual computation)
if self._keltner_ema_value is None:
self._keltner_ema_value = close
else:
k = 2.0 / (period + 1.0)
self._keltner_ema_value = close * k + self._keltner_ema_value * (1.0 - k)
# SMA for range average (manual computation)
self._range_buffer.append(candle_range)
if len(self._range_buffer) > period:
self._range_buffer.pop(0)
self._candle_count += 1
if self._candle_count < period:
return
mid = self._keltner_ema_value
avg_range = sum(self._range_buffer) / len(self._range_buffer)
upper = mid + avg_range * mult
lower = mid - avg_range * mult
above_upper = close > upper
below_lower = close < lower
fast_val = float(fast_value)
slow_val = float(slow_value)
# Exit logic: close crosses opposite band
if self.Position > 0 and close < lower:
self.SellMarket()
elif self.Position < 0 and close > upper:
self.BuyMarket()
# Entry logic: Keltner breakout + EMA trend confirmation
if self.Position == 0:
if not self._prev_above_upper and above_upper and fast_val > slow_val:
self.BuyMarket()
self._entry_price = close
elif not self._prev_below_lower and below_lower and fast_val < slow_val:
self.SellMarket()
self._entry_price = close
self._prev_above_upper = above_upper
self._prev_below_lower = below_lower
def CreateClone(self):
return ka_gold_bot_strategy()