Стратегия Alligator Simple
Обзор
Стратегия Alligator Simple переносит советник MetaTrader «Alligator Simple v1.0» в экосистему StockSharp. Алгоритм анализирует индикатор Alligator Билла Уильямса только на закрытых свечах и открывает позицию, когда линии Lips, Teeth и Jaw на предыдущей свече выстраиваются в одном направлении. Для каждой сделки можно задать стоп-лосс, тейк-профит и трейлинг-стоп в пунктах, полностью повторяя оригинальную MQL-логику.
Индикаторы и данные
- Линии Alligator: три сглаженные скользящие средние (SMMA), рассчитываемые по медианной цене свечи
(high + low) / 2 с индивидуальными периодами и сдвигами вперёд для Jaw, Teeth и Lips.
- Свечи: стратегия подписывается на выбранный
CandleType (по умолчанию часовые свечи) и обрабатывает только завершённые свечи, чтобы избежать заглядывания в будущее.
Логика торговли
- Оценка сигнала
- Получить значения Alligator на предыдущей закрытой свече с учётом заданных сдвигов.
- Условие для покупки:
Lips[t-1] > Teeth[t-1] > Jaw[t-1].
- Условие для продажи:
Lips[t-1] < Teeth[t-1] < Jaw[t-1].
- Исполнение
- Если позиций нет, открыть сделку объёмом
OrderVolume по рынку.
- Одновременно удерживается только одна позиция; противоположные сигналы игнорируются, пока текущая позиция не будет закрыта.
Выход и управление рисками
- Начальный стоп-лосс: при
StopLossPips > 0 уровень устанавливается на расстоянии заданного количества пунктов от цены входа, расстояние пересчитывается через минимальный шаг цены инструмента (для инструментов с 3/5 знаками добавляется множитель 10, как в MetaTrader).
- Тейк-профит: при
TakeProfitPips > 0 цель ставится симметрично относительно цены входа; значение 0 отключает тейк-профит.
- Трейлинг-стоп: если
TrailingStopPips и TrailingStepPips положительные, стоп переносится к close − TrailingStop (для лонга) или close + TrailingStop (для шорта), когда цена прошла минимум TrailingStop + TrailingStep в прибыльную сторону. Для моделирования внутридневных касаний используются максимумы и минимумы свечи.
- Закрытие позиций: условия стоп-лосса, тейк-профита и трейлинг-стопа проверяются на каждой завершённой свече и приводят к отправке рыночного ордера на закрытие.
Параметры
OrderVolume (по умолчанию 1): торговый объём в лотах или контрактах.
StopLossPips (по умолчанию 100): дистанция стоп-лосса в пунктах. Ноль отключает стоп.
TakeProfitPips (по умолчанию 100): дистанция тейк-профита в пунктах. Ноль отключает цель.
TrailingStopPips (по умолчанию 5): расстояние трейлинг-стопа в пунктах. Ноль отключает трейлинг.
TrailingStepPips (по умолчанию 5): дополнительное движение цены перед переносом трейлинг-стопа; при активном трейлинге должно быть положительным.
JawPeriod, TeethPeriod, LipsPeriod: периоды SMMA для линий Alligator (по умолчанию 13/8/5).
JawShift, TeethShift, LipsShift: сдвиги вперёд при чтении значений Alligator (по умолчанию 8/5/3).
CandleType: тип/таймфрейм свечей для расчётов (по умолчанию часовые свечи).
Особенности реализации
- Пунктовые расстояния автоматически подстраиваются под шаг цены инструмента; для инструментов с тремя или пятью знаками используется коэффициент 10, чтобы сохранить определение пункта из MetaTrader.
- История индикаторов хранится в буферах достаточной длины, чтобы учитывать заданные сдвиги, без ручного копирования массивов.
- Для отправки заявок используются методы
BuyMarket и SellMarket, что позволяет сосредоточиться на генерации сигналов и управлении рисками.
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;
}
}
}
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 CandleStates
from StockSharp.Algo.Indicators import SmoothedMovingAverage
from StockSharp.Algo.Strategies import Strategy
from datatype_extensions import *
class alligator_simple_strategy(Strategy):
"""
Simplified Bill Williams Alligator breakout strategy.
Buys when Lips > Teeth > Jaw (upward expansion).
Sells when Lips < Teeth < Jaw (downward expansion).
Uses stop-loss and take-profit for risk management.
"""
def __init__(self):
super(alligator_simple_strategy, self).__init__()
self._jaw_period = self.Param("JawPeriod", 13) \
.SetGreaterThanZero() \
.SetDisplay("Jaw Period", "Alligator jaw period", "Alligator")
self._teeth_period = self.Param("TeethPeriod", 8) \
.SetGreaterThanZero() \
.SetDisplay("Teeth Period", "Alligator teeth period", "Alligator")
self._lips_period = self.Param("LipsPeriod", 5) \
.SetGreaterThanZero() \
.SetDisplay("Lips Period", "Alligator lips period", "Alligator")
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._entry_price = 0.0
self._cooldown = 0
@property
def JawPeriod(self):
return self._jaw_period.Value
@JawPeriod.setter
def JawPeriod(self, value):
self._jaw_period.Value = value
@property
def TeethPeriod(self):
return self._teeth_period.Value
@TeethPeriod.setter
def TeethPeriod(self, value):
self._teeth_period.Value = value
@property
def LipsPeriod(self):
return self._lips_period.Value
@LipsPeriod.setter
def LipsPeriod(self, value):
self._lips_period.Value = value
@property
def StopLossPoints(self):
return self._stop_loss_points.Value
@StopLossPoints.setter
def StopLossPoints(self, value):
self._stop_loss_points.Value = value
@property
def TakeProfitPoints(self):
return self._take_profit_points.Value
@TakeProfitPoints.setter
def TakeProfitPoints(self, value):
self._take_profit_points.Value = value
def OnReseted(self):
super(alligator_simple_strategy, self).OnReseted()
self._entry_price = 0.0
self._cooldown = 0
def OnStarted2(self, time):
super(alligator_simple_strategy, self).OnStarted2(time)
jaw = SmoothedMovingAverage()
jaw.Length = self.JawPeriod
teeth = SmoothedMovingAverage()
teeth.Length = self.TeethPeriod
lips = SmoothedMovingAverage()
lips.Length = self.LipsPeriod
subscription = self.SubscribeCandles(tf(5))
subscription.Bind(jaw, teeth, lips, self.ProcessCandle).Start()
def ProcessCandle(self, candle, jaw_value, teeth_value, lips_value):
if candle.State != CandleStates.Finished:
return
if self._cooldown > 0:
self._cooldown -= 1
return
close = float(candle.ClosePrice)
step = 1.0
# Check SL/TP for existing positions
if self.Position > 0 and self._entry_price > 0:
if self.StopLossPoints > 0 and close <= self._entry_price - self.StopLossPoints * step:
self.SellMarket()
self._entry_price = 0.0
self._cooldown = 110
return
if self.TakeProfitPoints > 0 and close >= self._entry_price + self.TakeProfitPoints * step:
self.SellMarket()
self._entry_price = 0.0
self._cooldown = 110
return
elif self.Position < 0 and self._entry_price > 0:
if self.StopLossPoints > 0 and close >= self._entry_price + self.StopLossPoints * step:
self.BuyMarket()
self._entry_price = 0.0
self._cooldown = 110
return
if self.TakeProfitPoints > 0 and close <= self._entry_price - self.TakeProfitPoints * step:
self.BuyMarket()
self._entry_price = 0.0
self._cooldown = 110
return
# Buy when lips > teeth > jaw (Alligator opening upward)
if lips_value > teeth_value and teeth_value > jaw_value and self.Position <= 0:
if self.Position < 0:
self.BuyMarket()
self.BuyMarket()
self._entry_price = close
self._cooldown = 110
# Sell when lips < teeth < jaw (Alligator opening downward)
elif lips_value < teeth_value and teeth_value < jaw_value and self.Position >= 0:
if self.Position > 0:
self.SellMarket()
self.SellMarket()
self._entry_price = close
self._cooldown = 110
def CreateClone(self):
"""!! REQUIRED!! Creates a new instance of the strategy."""
return alligator_simple_strategy()