Открыть на GitHub

Стратегия Farhad Crab

Обзор

Farhad Crab — это порт оригинального советника MetaTrader FarhadCrab1.mq4 на высокоуровневый API StockSharp. Изначально алгоритм предназначался для минутных графиков пар GBP/JPY, GBP/USD и EUR/USD и комбинировал агрессивные входы по движению с динамическим сопровождением позиций. В новой реализации вся логика переписана на C#, а обмен данными происходит исключительно через подписки StockSharp.

В рабочем таймфрейме стратегия рассчитывает две скользящие средние: 9-периодную EMA от типичной цены и 9-периодную SMA от цен открытия свечи. Дополнительно ведётся дневная 55-периодная сглаженная средняя (SMMA), служащая «страховкой» от глобального разворота. Если минимум текущей свечи держится выше EMA и позиция отсутствует, открывается покупка. Если максимум остаётся ниже SMA от открытий, открывается продажа. Пересечение дневной SMMA с ценой закрытия в противоположную сторону немедленно закрывает позицию.

Система управления выходами повторяет настройки советника: отдельные значения тейк-профита (в пунктах) для длинных и коротких сделок, а также независимые параметры трейлинг-стопа. Трейлинг активируется только после движения цены на заданную величину, как и в MetaTrader. Закрытия выполняются рыночными заявками, что соответствует событиям высокоуровневого API.

Ключевые особенности

  • Полное соответствие индикаторной базе — EMA(9) по типичной цене, SMA(9) по ценам открытия и дневная SMMA(55).
  • Работа с несколькими таймфреймами — одновременная подписка на торговый и дневной таймфреймы без ручного накопления данных.
  • Настраиваемые выходы — тейк-профиты и трейлинг-стопы в пунктах, доступные для оптимизации.
  • Дневной предохранитель — строгая реализация условия закрытия при пересечении дневной SMMA и цены закрытия.
  • Защита позиций — однократный вызов StartProtection() в момент запуска стратегии.

Параметры

Параметр Описание Значение по умолчанию
OrderVolume Объём сделки при открытии рынка. 0.1
LongTakeProfitPips Дистанция тейк-профита для покупок в пунктах. 10
ShortTakeProfitPips Дистанция тейк-профита для продаж в пунктах. 10
LongTrailingStopPips Дистанция трейлинг-стопа для покупок (0 отключает). 8
ShortTrailingStopPips Дистанция трейлинг-стопа для продаж (0 отключает). 8
DailyMaPeriod Период дневной сглаженной средней. 55
CandleType Основной таймфрейм стратегии (по умолчанию 1 минута). 1m

Все параметры объявлены через StrategyParam<T> и помечены для оптимизации там, где это имеет смысл, поэтому стратегию легко адаптировать под конкретный инструмент.

Правила торговли

  1. Открытие лонга: минимум свечи находится выше EMA(9) по типичной цене, позиция отсутствует.
  2. Открытие шорта: максимум свечи находится ниже SMA(9) по ценам открытия, позиция отсутствует.
  3. Защитное закрытие лонга: дневная SMMA закрывается выше цены закрытия при условии, что ранее была ниже.
  4. Защитное закрытие шорта: дневная SMMA закрывается ниже цены закрытия при условии, что ранее была выше.
  5. Тейк-профит: достижение целевого количества пунктов закрывает позицию.
  6. Трейлинг-стоп: после движения в прибыль на заданное расстояние отслеживается обратный ход и при откате позиция закрывается.

Особенности реализации

  • Вся обработка данных выполняется через SubscribeCandles().Bind(...), что исключает прямой доступ к буферам индикаторов и соответствует внутренним правилам репозитория.
  • Размер пункта вычисляется на основании PriceStep с учётом пятого и третьего знаков, как в MetaTrader, поэтому параметры в пунктах работают идентично.
  • Стоп-приказы не выставляются, вместо этого стратегия контролирует цену и закрывает позиции рыночными ордерами при наступлении условий.
  • Метод OnReseted очищает все поля, благодаря чему повторные запуски и оптимизации выполняются из чистого состояния.

Рекомендации по использованию

  • Для повторения исходных результатов используйте минутные свечи по основным валютным парам. Тем не менее параметры позволяют адаптироваться к другим инструментам и волатильности.
  • Стратегия всегда держит только одну позицию, что упрощает мониторинг и анализ сделок.
  • В условиях бокового рынка можно сократить расстояние трейлинг-стопа или сосредоточиться на тейк-профите, чтобы уменьшить число ложных выходов.
  • Увеличение DailyMaPeriod сделает фильтр по дневной средне менее чувствительным, что подойдёт для более долгосрочных сценариев.

Проверяемая формула: на каждой завершённой минутной свече типичная цена равна (high+low+close)/3. EMA(9) по типичной цене инициализируется средним первых девяти значений, затем EMA=(8*EMA+2*typical)/10. Отдельная SMA(9) строится по Open. Без позиции и ожидающей заявки: покупка при low > EMA, иначе продажа при high < SMA(Open). Дневная SMMA(55) прогревается на 55 закрытых дневных свечах и обновляется как (54*SMMA+close)/55. Её пересечение дневной цены закрытия в неблагоприятную сторону закрывает позицию. Тейк и трейлинг рассчитываются от фактической цены исполнения входа и проверяются по завершённым минутным свечам; новый трейлинг действует только на следующих свечах. Сокращённый DailyMaPeriod в тестах проверяет механику, но не default 55. Доходность не гарантируется.

namespace StockSharp.Samples.Strategies;

using System;
using System.Collections.Generic;
using System.Linq;

using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;

/// <summary>
/// Farhad Crab uses EMA(9) on typical M1 prices, SMA(9) of M1 opens,
/// and daily SMMA protection with direction-specific take/trailing exits.
/// </summary>
public class FarhadCrabStrategy : Strategy
{
	private readonly StrategyParam<int> _dailyMaPeriod;
	private readonly StrategyParam<decimal> _orderVolume;
	private readonly StrategyParam<decimal> _longTakeProfitPips;
	private readonly StrategyParam<decimal> _shortTakeProfitPips;
	private readonly StrategyParam<decimal> _longTrailingStopPips;
	private readonly StrategyParam<decimal> _shortTrailingStopPips;
	private readonly StrategyParam<DataType> _candleType;

	private readonly Queue<decimal> _typicalSeed = new();
	private readonly Queue<decimal> _opens = new();
	private readonly Queue<decimal> _dailySeed = new();
	private decimal? _emaTypical;
	private decimal? _dailySmma;
	private decimal? _priorSmma;
	private decimal? _priorDailyClose;
	private decimal? _entryPrice;
	private decimal? _trailingLevel;
	private decimal _bestPrice;
	private Order _pendingOrder;
	private Order _entryOrder;

	public int DailyMaPeriod { get => _dailyMaPeriod.Value; set => _dailyMaPeriod.Value = value; }
	public decimal OrderVolume { get => _orderVolume.Value; set => _orderVolume.Value = value; }
	public decimal LongTakeProfitPips { get => _longTakeProfitPips.Value; set => _longTakeProfitPips.Value = value; }
	public decimal ShortTakeProfitPips { get => _shortTakeProfitPips.Value; set => _shortTakeProfitPips.Value = value; }
	public decimal LongTrailingStopPips { get => _longTrailingStopPips.Value; set => _longTrailingStopPips.Value = value; }
	public decimal ShortTrailingStopPips { get => _shortTrailingStopPips.Value; set => _shortTrailingStopPips.Value = value; }
	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }

	public FarhadCrabStrategy()
	{
		_dailyMaPeriod = Param(nameof(DailyMaPeriod), 55).SetGreaterThanZero();
		_orderVolume = Param(nameof(OrderVolume), 0.1m).SetGreaterThanZero();
		_longTakeProfitPips = Param(nameof(LongTakeProfitPips), 10m).SetNotNegative();
		_shortTakeProfitPips = Param(nameof(ShortTakeProfitPips), 10m).SetNotNegative();
		_longTrailingStopPips = Param(nameof(LongTrailingStopPips), 8m).SetNotNegative();
		_shortTrailingStopPips = Param(nameof(ShortTrailingStopPips), 8m).SetNotNegative();
		_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(1).TimeFrame());
	}

	public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
		=> [(Security, CandleType), (Security, TimeSpan.FromDays(1).TimeFrame())];

	protected override void OnReseted()
	{
		base.OnReseted();
		ClearState();
	}

	private void ClearState()
	{
		_typicalSeed.Clear();
		_opens.Clear();
		_dailySeed.Clear();
		_emaTypical = null;
		_dailySmma = null;
		_priorSmma = null;
		_priorDailyClose = null;
		_entryPrice = null;
		_trailingLevel = null;
		_bestPrice = 0m;
		_pendingOrder = null;
		_entryOrder = null;
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);
		ClearState();
		if ((Security?.PriceStep ?? 0m) <= 0m)
			throw new InvalidOperationException("Farhad Crab requires a positive instrument PriceStep.");
		SubscribeCandles(TimeSpan.FromDays(1).TimeFrame()).Bind(ProcessDailyCandle).Start();
		SubscribeCandles(CandleType).Bind(ProcessCandle).Start();
	}

	private decimal PipSize()
	{
		var step = Security?.PriceStep ?? 0m;
		return Security?.Decimals is 3 or 5 ? step * 10m : step;
	}

	private bool Pending => _pendingOrder is not null &&
		_pendingOrder.State is not (OrderStates.Done or OrderStates.Failed);

	private void ProcessDailyCandle(ICandleMessage candle)
	{
		if (candle.State != CandleStates.Finished)
			return;

		var priorSmma = _dailySmma;
		var priorClose = _priorDailyClose;
		if (_dailySmma is null)
		{
			_dailySeed.Enqueue(candle.ClosePrice);
			if (_dailySeed.Count == DailyMaPeriod)
				_dailySmma = _dailySeed.Average();
		}
		else
			_dailySmma = (_dailySmma.Value * (DailyMaPeriod - 1) + candle.ClosePrice) / DailyMaPeriod;

		_priorSmma = priorSmma;
		_priorDailyClose = candle.ClosePrice;

		if (Pending || Position == 0m || priorSmma is null || priorClose is null || _dailySmma is null)
			return;

		if (Position > 0m && priorSmma < priorClose && _dailySmma > candle.ClosePrice ||
			Position < 0m && priorSmma > priorClose && _dailySmma < candle.ClosePrice)
			Exit("Farhad Crab daily safety exit");
	}

	private void ProcessCandle(ICandleMessage candle)
	{
		if (candle.State != CandleStates.Finished)
			return;

		var typical = (candle.HighPrice + candle.LowPrice + candle.ClosePrice) / 3m;
		if (_emaTypical is null)
		{
			_typicalSeed.Enqueue(typical);
			if (_typicalSeed.Count == 9)
				_emaTypical = _typicalSeed.Average();
		}
		else
			_emaTypical = (_emaTypical.Value * 8m + typical * 2m) / 10m;

		_opens.Enqueue(candle.OpenPrice);
		while (_opens.Count > 9)
			_opens.Dequeue();

		if (Pending)
			return;
		if (Position != 0m)
		{
			HandleRisk(candle);
			return;
		}
		if (_emaTypical is null || _opens.Count < 9)
			return;

		if (candle.LowPrice > _emaTypical.Value)
			Enter(Sides.Buy);
		else if (candle.HighPrice < _opens.Average())
			Enter(Sides.Sell);
	}

	private void Enter(Sides side)
	{
		var volume = OrderVolume;
		if (Security?.VolumeStep is decimal step && step > 0m)
			volume = decimal.Floor(volume / step) * step;
		if (Security?.MinVolume is decimal min && min > 0m)
			volume = Math.Max(min, volume);
		if (Security?.MaxVolume is decimal max && max > 0m)
			volume = Math.Min(max, volume);
		if (volume > 0m)
			Submit(side, volume, "Farhad Crab entry");
	}

	private void HandleRisk(ICandleMessage candle)
	{
		if (_entryPrice is not decimal entry)
			return;
		var positive = Position > 0m;
		var pip = PipSize();
		var target = (positive ? LongTakeProfitPips : ShortTakeProfitPips) * pip;
		if (target > 0m && (positive ? candle.HighPrice >= entry + target :
			candle.LowPrice <= entry - target))
		{
			Exit("Farhad Crab take profit");
			return;
		}

		if (_trailingLevel is decimal level && (positive ? candle.LowPrice <= level :
			candle.HighPrice >= level))
		{
			Exit("Farhad Crab trailing stop");
			return;
		}

		var distance = (positive ? LongTrailingStopPips : ShortTrailingStopPips) * pip;
		if (distance <= 0m)
			return;

		_bestPrice = positive ? Math.Max(_bestPrice, candle.HighPrice) :
			Math.Min(_bestPrice, candle.LowPrice);
		var move = positive ? _bestPrice - entry : entry - _bestPrice;
		if (move < distance)
			return;
		var next = positive ? _bestPrice - distance : _bestPrice + distance;
		if (_trailingLevel is null || (positive ? next > _trailingLevel.Value : next < _trailingLevel.Value))
			_trailingLevel = next;
	}

	private void Exit(string reason)
	{
		if (!Pending && Position != 0m)
			Submit(Position > 0m ? Sides.Sell : Sides.Buy, Math.Abs(Position), reason);
	}

	private void Submit(Sides side, decimal volume, string comment)
	{
		_pendingOrder = new Order
		{
			Security = Security,
			Portfolio = Portfolio,
			Type = OrderTypes.Market,
			Side = side,
			Volume = volume,
			Comment = comment,
		};
		if (comment == "Farhad Crab entry")
			_entryOrder = _pendingOrder;
		RegisterOrder(_pendingOrder);
	}

	protected override void OnOwnTradeReceived(MyTrade trade)
	{
		base.OnOwnTradeReceived(trade);
		if (trade?.Order == _entryOrder && trade.Trade is not null)
		{
			_entryPrice = trade.Trade.Price;
			_bestPrice = _entryPrice.Value;
			_trailingLevel = null;
		}
		else if (Position == 0m)
		{
			_entryPrice = null;
			_trailingLevel = null;
			_bestPrice = 0m;
		}
	}
}