Español ES
Ver en GitHub

Estrategia Abrir Dos Órdenes Pendientes

Descripción general

Esta estrategia replica el asesor experto de MetaTrader que simultáneamente coloca una orden buy stop y una orden sell stop alrededor del spread actual. Trabaja sobre un único instrumento y utiliza llamadas al API de alto nivel de StockSharp para suscribirse al libro de órdenes, gestionar órdenes pendientes y manejar controles de riesgo de cartera. Tan pronto como se llena una orden pendiente, se cancela la orden opuesta y la posición activa se gestiona con reglas de stop-loss, take-profit y trailing stop.

Lógica de Trading

  1. Suscribirse al libro de órdenes y leer los mejores precios bid y ask.
  2. Cuando no hay posición abierta ni orden de entrada activa, calcular el volumen de entrada y colocar dos órdenes stop:
    • Buy stop en ask + EntryOffsetPoints × PriceStep.
    • Sell stop en bid − EntryOffsetPoints × PriceStep.
  3. Cuando se ejecuta una orden stop:
    • Cancelar la orden pendiente opuesta.
    • Almacenar el precio de ejecución como el nuevo precio de entrada.
    • Calcular los niveles iniciales de stop-loss y take-profit en pasos de precio relativos al llenado.
  4. Mientras la posición está activa, monitorear el libro de órdenes:
    • Cerrar largos cuando el bid alcanza el nivel de stop-loss o take-profit.
    • Cerrar cortos cuando el ask alcanza el nivel de stop-loss o take-profit.
    • Activar el trailing stop después de que el precio se mueva a favor de la operación por la distancia de trailing y deslizar el nivel de stop en consecuencia.
  5. Cuando la posición vuelve a plana, restablecer el estado interno y colocar un nuevo par de órdenes stop.

Las salidas se ejecutan con órdenes de mercado una vez que se toca un nivel protector. Esto mantiene la lógica cercana a la implementación MQL sin depender de APIs de modificación de órdenes de nivel inferior.

Gestión de Capital

La estrategia puede usar ya sea un volumen fijo o un dimensionamiento dinámico basado en riesgo:

  • Volumen Fijo – usar el tamaño de lote constante definido por el parámetro FixedVolume.
  • Gestión de Capital – si está habilitado, calcular el volumen a partir del capital del portafolio, el porcentaje de riesgo y la distancia del stop-loss en pasos de precio. Los volúmenes se redondean al paso de volumen del instrumento y se limitan entre los valores mínimo y máximo del instrumento.

Parámetros

Parámetro Descripción
UseMoneyManagement Habilita el dimensionamiento de posición basado en riesgo. Predeterminado: true.
RiskPercent Porcentaje del capital del portafolio a arriesgar por operación cuando la gestión de capital está activa. Predeterminado: 2.
FixedVolume Tamaño de lote usado cuando la gestión de capital está deshabilitada. Predeterminado: 1.
StopLossPoints Distancia de stop-loss en pasos de precio desde el precio de entrada. Predeterminado: 100.
TakeProfitPoints Distancia de take-profit en pasos de precio desde el precio de entrada. Predeterminado: 300.
TrailingStopPoints Distancia del trailing stop en pasos de precio. Un valor de 0 deshabilita el trailing. Predeterminado: 50.
EntryOffsetPoints Distancia en pasos de precio usada para colocar las órdenes pendientes lejos del spread. Predeterminado: 50.
SlippagePoints Amortiguador adicional en pasos de precio reservado para el deslizamiento. Actualmente informativo y no se usa directamente. Predeterminado: 5.

Notas

  • La estrategia depende del feed del libro de órdenes. Asegúrese de que los datos de profundidad de mercado estén disponibles para el instrumento seleccionado.
  • La ejecución de stop-loss y take-profit usa órdenes de mercado una vez que el bid/ask cruza el nivel, coincidiendo con el comportamiento de la lógica de trailing stop del MQL original.
  • Los trailing stops comienzan solo después de que el precio se ha movido por la distancia de trailing configurada desde la entrada.
  • El código usa sangría de tabulación, comentarios en inglés y métodos de alto nivel de StockSharp según las directrices del proyecto.
using System;
using System.Linq;
using System.Collections.Generic;
using Ecng.Common;
using Ecng.Collections;
using Ecng.Serialization;
using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;

namespace StockSharp.Samples.Strategies;

/// <summary>
/// Strategy that simulates placing both buy stop and sell stop orders around the current price.
/// It uses candle-based breakout detection and manages the resulting position
/// with fixed stop loss, take profit and optional trailing stop levels.
/// </summary>
public class OpenTwoPendingOrdersStrategy : Strategy
{
	private readonly StrategyParam<decimal> _stopLossPoints;
	private readonly StrategyParam<decimal> _takeProfitPoints;
	private readonly StrategyParam<decimal> _trailingStopPoints;
	private readonly StrategyParam<decimal> _entryOffsetPoints;
	private readonly StrategyParam<DataType> _candleType;

	private decimal? _pendingBuyPrice;
	private decimal? _pendingSellPrice;
	private decimal? _entryPrice;
	private decimal? _stopLevel;
	private decimal? _takeLevel;
	private decimal _highestSinceEntry;
	private decimal _lowestSinceEntry;
	private int _cooldown;

	/// <summary>
	/// Stop loss distance expressed in price steps.
	/// </summary>
	public decimal StopLossPoints
	{
		get => _stopLossPoints.Value;
		set => _stopLossPoints.Value = value;
	}

	/// <summary>
	/// Take profit distance expressed in price steps.
	/// </summary>
	public decimal TakeProfitPoints
	{
		get => _takeProfitPoints.Value;
		set => _takeProfitPoints.Value = value;
	}

	/// <summary>
	/// Trailing stop distance expressed in price steps.
	/// </summary>
	public decimal TrailingStopPoints
	{
		get => _trailingStopPoints.Value;
		set => _trailingStopPoints.Value = value;
	}

	/// <summary>
	/// Distance in price steps used to place the pending entries away from the current price.
	/// </summary>
	public decimal EntryOffsetPoints
	{
		get => _entryOffsetPoints.Value;
		set => _entryOffsetPoints.Value = value;
	}

	/// <summary>
	/// Candle type used by the strategy.
	/// </summary>
	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	/// <summary>
	/// Initializes a new instance of <see cref="OpenTwoPendingOrdersStrategy"/>.
	/// </summary>
	public OpenTwoPendingOrdersStrategy()
	{
		_stopLossPoints = Param(nameof(StopLossPoints), 5000m)
			.SetDisplay("Stop Loss (steps)", "Stop loss distance in price steps", "Risk")
			.SetOptimize(20m, 300m, 20m);

		_takeProfitPoints = Param(nameof(TakeProfitPoints), 8000m)
			.SetDisplay("Take Profit (steps)", "Take profit distance in price steps", "Risk")
			.SetOptimize(50m, 600m, 50m);

		_trailingStopPoints = Param(nameof(TrailingStopPoints), 3000m)
			.SetDisplay("Trailing Stop (steps)", "Trailing stop distance in price steps", "Risk")
			.SetOptimize(10m, 200m, 10m);

		_entryOffsetPoints = Param(nameof(EntryOffsetPoints), 1000m)
			.SetDisplay("Entry Offset (steps)", "Offset from close for pending entries", "Execution")
			.SetOptimize(10m, 150m, 10m);

		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Type of candles", "General");
	}

	/// <inheritdoc />
	public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
	{
		return [(Security, CandleType)];
	}

	/// <inheritdoc />
	protected override void OnReseted()
	{
		base.OnReseted();
		ResetState();
	}

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

		var subscription = SubscribeCandles(CandleType);
		subscription.Bind(ProcessCandle).Start();

		var area = CreateChartArea();
		if (area != null)
		{
			DrawCandles(area, subscription);
			DrawOwnTrades(area);
		}
	}

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

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

		var step = GetStep();

		// Manage existing position
		if (Position != 0 && _entryPrice.HasValue)
		{
			ManagePosition(candle, step);

			// If position was closed, reset and set up new pending entries
			if (Position == 0)
			{
				ResetState();
				_cooldown = 20;
			}
			return;
		}

		// Check pending entries
		if (_pendingBuyPrice.HasValue && _pendingSellPrice.HasValue)
		{
			var buyLevel = _pendingBuyPrice.Value;
			var sellLevel = _pendingSellPrice.Value;

			// Buy stop triggered: price went up to pending buy level
			if (candle.HighPrice >= buyLevel)
			{
				_pendingBuyPrice = null;
				_pendingSellPrice = null;
				BuyMarket();
				InitializePositionLevels(true, buyLevel, step);
				return;
			}

			// Sell stop triggered: price went down to pending sell level
			if (candle.LowPrice <= sellLevel)
			{
				_pendingBuyPrice = null;
				_pendingSellPrice = null;
				SellMarket();
				InitializePositionLevels(false, sellLevel, step);
				return;
			}
		}
		else
		{
			// No pending entries, set up new ones
			SetupPendingEntries(candle.ClosePrice, step);
		}
	}

	private void SetupPendingEntries(decimal currentPrice, decimal step)
	{
		var offset = EntryOffsetPoints * step;
		_pendingBuyPrice = currentPrice + offset;
		_pendingSellPrice = currentPrice - offset;
	}

	private void InitializePositionLevels(bool isLong, decimal entryPrice, decimal step)
	{
		_entryPrice = entryPrice;
		_highestSinceEntry = entryPrice;
		_lowestSinceEntry = entryPrice;

		_stopLevel = StopLossPoints > 0m
			? entryPrice + (isLong ? -StopLossPoints : StopLossPoints) * step
			: null;

		_takeLevel = TakeProfitPoints > 0m
			? entryPrice + (isLong ? TakeProfitPoints : -TakeProfitPoints) * step
			: null;
	}

	private void ManagePosition(ICandleMessage candle, decimal step)
	{
		if (Position > 0)
		{
			_highestSinceEntry = Math.Max(_highestSinceEntry, candle.HighPrice);

			if (_stopLevel.HasValue && candle.LowPrice <= _stopLevel.Value)
			{
				SellMarket();
				return;
			}

			if (_takeLevel.HasValue && candle.HighPrice >= _takeLevel.Value)
			{
				SellMarket();
				return;
			}

			UpdateTrailingStop(true, step);
		}
		else if (Position < 0)
		{
			_lowestSinceEntry = Math.Min(_lowestSinceEntry, candle.LowPrice);

			if (_stopLevel.HasValue && candle.HighPrice >= _stopLevel.Value)
			{
				BuyMarket();
				return;
			}

			if (_takeLevel.HasValue && candle.LowPrice <= _takeLevel.Value)
			{
				BuyMarket();
				return;
			}

			UpdateTrailingStop(false, step);
		}
	}

	private void UpdateTrailingStop(bool isLong, decimal step)
	{
		if (TrailingStopPoints <= 0m || _entryPrice == null)
			return;

		var trailingDistance = TrailingStopPoints * step;
		if (trailingDistance <= 0m)
			return;

		if (isLong)
		{
			if (_highestSinceEntry - _entryPrice.Value >= trailingDistance)
			{
				var desiredStop = _highestSinceEntry - trailingDistance;
				if (_stopLevel == null || desiredStop > _stopLevel.Value)
					_stopLevel = desiredStop;
			}
		}
		else
		{
			if (_entryPrice.Value - _lowestSinceEntry >= trailingDistance)
			{
				var desiredStop = _lowestSinceEntry + trailingDistance;
				if (_stopLevel == null || desiredStop < _stopLevel.Value)
					_stopLevel = desiredStop;
			}
		}
	}

	private void ResetState()
	{
		_pendingBuyPrice = null;
		_pendingSellPrice = null;
		_entryPrice = null;
		_stopLevel = null;
		_takeLevel = null;
		_highestSinceEntry = 0m;
		_lowestSinceEntry = 0m;
		_cooldown = 0;
	}

	private decimal GetStep()
	{
		var step = Security?.PriceStep ?? 0m;
		return step > 0m ? step : 0.01m;
	}
}