Ver no GitHub

Estratégia Simples de Alligator

Visão geral

A estratégia Simples de Alligator recria o expert advisor do MetaTrader "Alligator Simple v1.0" usando a API de alto nível do StockSharp. Ela lê o indicador Alligator de Bill Williams em velas terminadas e abre uma posição quando as linhas Lips, Teeth e Jaw se expandem na mesma direção na barra completada anterior. Cada trade pode incluir opcionalmente gestão de stop-loss, take-profit e trailing stop baseados em pips que reflete a implementação MQL original.

Indicadores e dados

  • Linhas Alligator: três Médias Móveis Suavizadas (SMMA) calculadas sobre o preço médio da vela (high + low) / 2 com comprimentos configuráveis e deslocamentos para frente para o Jaw, Teeth e Lips.
  • Velas: a estratégia assina um único CandleType configurável (velas de uma hora por padrão) e apenas processa velas terminadas para evitar viés de antecipação.

Lógica de trading

  1. Avaliação de sinais
    • Recuperar os valores deslocados do Alligator para a vela completada anterior.
    • Sinal comprado: Lips[t-1] > Teeth[t-1] > Jaw[t-1].
    • Sinal vendido: Lips[t-1] < Teeth[t-1] < Jaw[t-1].
  2. Execução
    • Entrar no mercado com OrderVolume quando não há posição aberta.
    • Apenas uma posição é mantida por vez; sinais opostos são ignorados até que a posição atual seja fechada.

Saída e gestão de risco

  • Stop-loss inicial: se StopLossPips > 0, a estratégia desloca o preço de execução pela distância em pips convertida com o passo de preço do instrumento (incluindo o multiplicador de pips de 3/5 dígitos usado por símbolos MetaTrader).
  • Take-profit: quando TakeProfitPips > 0, um alvo de lucro é colocado simetricamente ao redor do preço de entrada. Um valor zero desativa o alvo.
  • Trailing stop: quando tanto TrailingStopPips quanto TrailingStepPips são positivos, o stop avança para close − TrailingStop (comprados) ou close + TrailingStop (vendidos) uma vez que o preço se moveu pelo menos TrailingStop + TrailingStep a favor do trade. As atualizações de trailing dependem da máxima/mínima da vela para simular toques intra-barra.
  • Tratamento de saída: condições de stop-loss, take-profit e trailing emitem ordens a mercado para zerar a posição e são avaliadas a cada vela terminada.

Parâmetros

  • OrderVolume (padrão 1): tamanho do trade em lotes ou contratos.
  • StopLossPips (padrão 100): distância do stop-loss inicial em pips. Definir como zero para desabilitar.
  • TakeProfitPips (padrão 100): distância do take-profit em pips. Definir como zero para desabilitar.
  • TrailingStopPips (padrão 5): distância do trailing stop em pips. Zero desativa o trailing.
  • TrailingStepPips (padrão 5): distância extra em pips que o preço deve percorrer antes que o trailing stop avance. Deve ser positivo quando o trailing está habilitado.
  • JawPeriod, TeethPeriod, LipsPeriod: comprimentos SMMA para o jaw, teeth e lips (padrões 13/8/5).
  • JawShift, TeethShift, LipsShift: deslocamentos para frente aplicados ao ler os valores do Alligator (padrões 8/5/3).
  • CandleType: tipo/período de dados de velas para cálculos (padrão velas de uma hora).

Notas de implementação

  • As distâncias em pips se adaptam automaticamente ao tamanho do tick do ativo. Instrumentos com três ou cinco casas decimais multiplicam o passo de preço por dez para replicar a definição de pip do MetaTrader.
  • Os buffers de histórico do indicador armazenam valores suficientes para respeitar os deslocamentos para frente configurados, eliminando a manipulação manual de arrays.
  • A estratégia usa os helpers BuyMarket e SellMarket para enviar ordens, mantendo o código focado na geração de sinais e no tratamento de risco.
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 Bill Williams Alligator breakout strategy.
/// Buys when Lips > Teeth > Jaw (upward expansion).
/// Sells when Lips less than Teeth less than Jaw (downward expansion).
/// Uses stop-loss and take-profit for risk management.
/// </summary>
public class AlligatorSimpleStrategy : Strategy
{
	private readonly StrategyParam<int> _jawPeriod;
	private readonly StrategyParam<int> _teethPeriod;
	private readonly StrategyParam<int> _lipsPeriod;
	private readonly StrategyParam<int> _stopLossPoints;
	private readonly StrategyParam<int> _takeProfitPoints;

	private SmoothedMovingAverage _jaw;
	private SmoothedMovingAverage _teeth;
	private SmoothedMovingAverage _lips;

	private decimal _entryPrice;
	private int _cooldown;

	/// <summary>
	/// Period for the Alligator jaw (blue) smoothed moving average.
	/// </summary>
	public int JawPeriod
	{
		get => _jawPeriod.Value;
		set => _jawPeriod.Value = value;
	}

	/// <summary>
	/// Period for the Alligator teeth (red) smoothed moving average.
	/// </summary>
	public int TeethPeriod
	{
		get => _teethPeriod.Value;
		set => _teethPeriod.Value = value;
	}

	/// <summary>
	/// Period for the Alligator lips (green) smoothed moving average.
	/// </summary>
	public int LipsPeriod
	{
		get => _lipsPeriod.Value;
		set => _lipsPeriod.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>
	/// Initialize <see cref="AlligatorSimpleStrategy"/>.
	/// </summary>
	public AlligatorSimpleStrategy()
	{
		_jawPeriod = Param(nameof(JawPeriod), 13)
			.SetGreaterThanZero()
			.SetDisplay("Jaw Period", "Alligator jaw period", "Alligator");

		_teethPeriod = Param(nameof(TeethPeriod), 8)
			.SetGreaterThanZero()
			.SetDisplay("Teeth Period", "Alligator teeth period", "Alligator");

		_lipsPeriod = Param(nameof(LipsPeriod), 5)
			.SetGreaterThanZero()
			.SetDisplay("Lips Period", "Alligator lips period", "Alligator");

		_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();

		_jaw = null;
		_teeth = null;
		_lips = null;
		_entryPrice = 0;
		_cooldown = 0;
	}

	/// <inheritdoc />
	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		_jaw = new SmoothedMovingAverage { Length = JawPeriod };
		_teeth = new SmoothedMovingAverage { Length = TeethPeriod };
		_lips = new SmoothedMovingAverage { Length = LipsPeriod };

		var subscription = SubscribeCandles(TimeSpan.FromMinutes(5).TimeFrame());
		subscription.Bind(_jaw, _teeth, _lips, ProcessCandle);
		subscription.Start();
	}

	private void ProcessCandle(ICandleMessage candle, decimal jawValue, decimal teethValue, decimal lipsValue)
	{
		if (candle.State != CandleStates.Finished)
			return;

		if (!_jaw.IsFormed || !_teeth.IsFormed || !_lips.IsFormed)
			return;

		if (_cooldown > 0)
		{
			_cooldown--;
			return;
		}

		var close = candle.ClosePrice;
		var step = Security?.PriceStep ?? 1m;

		// Check SL/TP for existing positions
		if (Position > 0 && _entryPrice > 0)
		{
			if (StopLossPoints > 0 && close <= _entryPrice - StopLossPoints * step)
			{
				SellMarket();
				_entryPrice = 0;
				_cooldown = 110;
				return;
			}

			if (TakeProfitPoints > 0 && close >= _entryPrice + TakeProfitPoints * step)
			{
				SellMarket();
				_entryPrice = 0;
				_cooldown = 110;
				return;
			}
		}
		else if (Position < 0 && _entryPrice > 0)
		{
			if (StopLossPoints > 0 && close >= _entryPrice + StopLossPoints * step)
			{
				BuyMarket();
				_entryPrice = 0;
				_cooldown = 110;
				return;
			}

			if (TakeProfitPoints > 0 && close <= _entryPrice - TakeProfitPoints * step)
			{
				BuyMarket();
				_entryPrice = 0;
				_cooldown = 110;
				return;
			}
		}

		// Buy when lips > teeth > jaw (Alligator opening upward)
		if (lipsValue > teethValue && teethValue > jawValue && Position <= 0)
		{
			if (Position < 0)
				BuyMarket();

			BuyMarket();
			_entryPrice = close;
			_cooldown = 110;
		}
		// Sell when lips < teeth < jaw (Alligator opening downward)
		else if (lipsValue < teethValue && teethValue < jawValue && Position >= 0)
		{
			if (Position > 0)
				SellMarket();

			SellMarket();
			_entryPrice = close;
			_cooldown = 110;
		}
	}
}