Ver en GitHub

Estrategia del cangrejo Farhad

Descripción general

La Estrategia del Cangrejo Farhad es una StockSharp versión de alto nivel del MetaTrader asesor experto FarhadCrab1.mq4. El EA original es un sistema de especulación rápido diseñado para el período M1 en GBP/JPY, GBP/USD y EUR/USD. Esta conversión recrea la lógica comercial en C# al combinar filtros de promedio móvil intradía con una red de seguridad de tendencias diarias y una gestión de salida automatizada.

La estrategia analiza el período de tiempo actual a través de un EMA de 9 períodos calculado sobre el precio típico y un SMA de 9 períodos calculado sobre la apertura de la vela. Al mismo tiempo, realiza un seguimiento de una media móvil suavizada (SMMA) de 55 períodos construida a partir de velas diarias. Siempre que los filtros a corto plazo muestran suficiente impulso alcista mientras no hay ninguna posición abierta, se activa una operación larga. Por el contrario, cuando el máximo intradiario permanece por debajo del SMA de aperturas, se abre una operación corta. La SMMA diaria actúa como una capa protectora: cruzar el precio desde abajo obliga a todas las operaciones largas a salir, y cruzar desde arriba cierra las posiciones cortas.

La gestión de salida reproduce el comportamiento del EA original con niveles de obtención de beneficios configurables en pips y paradas finales independientes para posiciones largas y cortas. La lógica de seguimiento sigue la implementación de MetaTrader moviendo el stop solo después de que el mercado avanza la distancia configurada. La estrategia cierra posiciones mediante órdenes de mercado en lugar de órdenes stop pendientes, lo que la hace compatible con el flujo de eventos de alto nivel API.

Características clave

  • Conjunto de indicadores idéntico al EA: EMA de 9 períodos en el precio típico, SMA de 9 períodos en las aperturas y una SMMA diaria de 55 períodos para la dirección de la tendencia.
  • Manejo de datos de múltiples períodos de tiempo: se suscribe al período de negociación y a las velas diarias simultáneamente, lo que permite a StockSharp calcular los indicadores requeridos sin almacenamiento en búfer manual.
  • Salidas configurables: distancias de toma de ganancias simétricas (largas/cortas) y topes dinámicos expresados en pips, al igual que las entradas externas originales.
  • Interruptor de seguridad diario: replica la regla de EA que cierra posiciones largas cuando el SMMA diario se mueve por encima del cierre diario y posiciones cortas cuando se mueve por debajo.
  • Protección incorporada: llama a StartProtection() una vez al inicio para proteger las posiciones de acuerdo con las mejores prácticas del marco.

Parámetros

Parámetro Descripción Predeterminado
OrderVolume Volumen comercial aplicado a nuevas órdenes de mercado. 0.1
LongTakeProfitPips Distancia de obtención de beneficios para posiciones largas, medida en pips. 10
ShortTakeProfitPips Distancia de obtención de beneficios para posiciones cortas, medida en pips. 10
LongTrailingStopPips Distancia de trailing stop para operaciones largas. El seguimiento se desactiva cuando se establece en cero. 8
ShortTrailingStopPips Distancia de trailing stop para operaciones cortas. El seguimiento se desactiva cuando se establece en cero. 8
DailyMaPeriod Longitud de la media móvil diaria suavizada utilizada para las salidas de protección. 55
CandleType Periodo de tiempo principal que impulsa los cálculos de la estrategia. El valor predeterminado es velas de 1 minuto. 1m

Todos los parámetros se exponen a través de StrategyParam<T> y se marcan como optimizables cuando tiene sentido, para que puedan ajustarse mediante el optimizador StockSharp.

Reglas de trading

  1. Entradas largas: cuando el mínimo de la vela actual se mantiene por encima del EMA de 9 períodos del precio típico y no hay ninguna posición activa, abra una operación larga.
  2. Entradas cortas: cuando el máximo de la vela actual permanece por debajo del período 9 SMA del precio de apertura y no hay ninguna posición activa, abra una operación corta.
  3. Salida protectora diaria (larga): cierre cualquier posición larga si la SMMA diaria se mueve por encima del cierre diario mientras anteriormente estaba por debajo del cierre anterior.
  4. Salida protectora diaria (corta): cierre cualquier posición corta si la SMMA diaria se mueve por debajo del cierre diario mientras anteriormente estaba por encima del cierre anterior.
  5. Take-profit: cierre la posición una vez que se alcance el objetivo de pip configurado.
  6. Parada de seguimiento: después de que una posición gana la distancia de seguimiento, bloquee las ganancias monitoreando la distancia de retroceso y salga cuando el precio retroceda en esa cantidad.

Notas de implementación

  • El código se basa exclusivamente en llamadas SubscribeCandles().Bind(...) de alto nivel, lo que elimina cualquier buffer de indicador manual y se mantiene dentro de las pautas del proyecto.
  • Los pips se calculan a partir del PriceStep del instrumento con el ajuste habitual de estilo MetaTrader para cotizaciones de 3 y 5 dígitos. Esto mantiene el comportamiento coherente con los parámetros basados ​​en puntos de EA.
  • La gestión de stop-loss y take-profit se realiza internamente cerrando posiciones cuando se cumplen las condiciones, en lugar de registrar órdenes límite/stop. Este enfoque coincide con las salidas instantáneas que se encuentran en el script original y al mismo tiempo sigue siendo compatible con la ejecución de órdenes asincrónicas en StockSharp.
  • La estrategia restablece su estado dentro de OnReseted, lo que garantiza que las ejecuciones de optimización y los lanzamientos repetidos comiencen desde cero.

Consejos de uso

  • El EA original se diseñó para pares GBP y EUR altamente volátiles en el marco temporal M1. Se pueden esperar resultados similares al aplicar el mismo marco temporal e instrumentos, pero los parámetros están expuestos para adaptarse a diferentes perfiles de volatilidad.
  • Debido a que el sistema mantiene solo una posición a la vez, es adecuado para realizar pruebas retrospectivas sencillas y ejecución en vivo sin una compleja pirámide de posiciones.
  • Los trailingstops se vuelven más efectivos en instrumentos con tendencias suaves. En los mercados de rango, considere reducir la distancia de seguimiento o confiar únicamente en salidas de toma de ganancias.
  • La salida diaria de SMMA sirve como principal control de riesgos. Para configuraciones orientadas al swing, puede aumentar DailyMaPeriod para que el filtro a largo plazo sea menos reactivo.

Fórmulas comprobables: por cada vela M1 cerrada, typical=(high+low+close)/3. EMA(9) se inicia con la media de los primeros nueve typical y sigue EMA=(8*EMA+2*typical)/10; SMA(9) utiliza los Open. Sin posición ni orden pendiente, comprar si low > EMA, de otro modo vender si high < SMA(Open). SMMA(55) diario se inicia con 55 cierres y sigue (54*SMMA+close)/55. Un cruce diario contrario cierra la posición. El take profit y el trailing utilizan el precio real ejecutado, se comprueban al completar velas M1 y los nuevos stops valen solo a partir de velas posteriores. Reducir DailyMaPeriod para probar la mecánica no valida el valor por defecto 55. El backtest no garantiza rentabilidad.

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;
		}
	}
}