Auf GitHub ansehen

VR Moving Distance-Strategie

Diese StockSharp-Strategie repliziert den VR-Moving Expert Advisor aus MetaTrader 5. Sie beobachtet einen konfigurierbaren gleitenden Durchschnitt und reagiert, wenn der Preis um eine feste Pip-Distanz abweicht. Der Algorithmus kann Trends durch Multiplikation des Basisordervolumens für Folgehandel skalieren und wendet einfache Take-Profit-Logik an, solange nur eine Position offen ist.

Überblick

  • Handelt das der Strategie zugewiesene Instrument mit einer einzigen Kerzendatensubskription.
  • Berechnet einen gleitenden Durchschnitt mit wählbarer Länge, Glättungstyp und Preisquelle.
  • Konvertiert Distanz- und Take-Profit-Einstellungen von Pips in Preisabweichungen mithilfe des Preisschritts des Wertpapiers.
  • Fügt Long-Positionen hinzu, wenn der Preis weit genug über dem gleitenden Durchschnitt steigt, oder Short-Positionen, wenn der Preis darunter fällt.
  • Kehrt die aktuelle Nettoexposition vor dem Öffnen einer Position in die entgegengesetzte Richtung um, um die Strategie netting-freundlich zu halten.

Indikatoren und Daten

  • Ein gleitender Durchschnitt (Simple, Exponential, Smoothed, Weighted oder VolumeWeighted).
  • Kerzen kommen mit dem konfigurierten Candle Type; derselbe Datenstrom treibt Indikatorwerte und Handelsentscheidungen.

Einstiegslogik

  1. Bei jeder abgeschlossenen Kerze wartet die Strategie, bis der gleitende Durchschnitt vollständig gebildet ist.
  2. Wenn das Hoch der Kerze mindestens DistancePips über dem gleitenden Durchschnitt liegt, wird ein Long-Einstieg ausgelöst.
  3. Wenn das Tief der Kerze mindestens DistancePips unter dem gleitenden Durchschnitt liegt, wird ein Short-Einstieg ausgelöst.
  4. Beim Richtungswechsel schließt die Strategie die bestehende Exposition, indem sie das entgegengesetzte Volumen zur neuen Marktorder hinzufügt.

Skalierung und Volumenverwaltung

  • Die erste Order verwendet das konfigurierte BaseVolume.
  • Folgeorders in dieselbe Richtung verwenden BaseVolume * VolumeMultiplier.
  • Der höchste ausgeführte Preis auf der Long-Seite und der niedrigste auf der Short-Seite werden verfolgt. Jede neue Skalierungsorder erfordert, dass der Preis sich um weitere DistancePips von diesem Extrem entfernt, bevor sie ausgelöst wird.

Ausstiegslogik

  • Wenn genau eine Long-Position offen ist, wird ein Gewinnziel beim Einstiegspreis plus TakeProfitPips (in Preiseinheiten umgerechnet) platziert. Wenn das Hoch einer Kerze das Ziel berührt, wird die Position geschlossen.
  • Ebenso erhält eine einzelne Short-Position ein Gewinnziel bei Einstieg minus TakeProfitPips und wird geschlossen, wenn das Kerzentief es berührt.
  • Sobald mehrere Einstiege existieren, hält die Strategie die Positionen offen und wartet auf neue Skalierungssignale; kein gemittelter Ausstieg wird in diesem Port versucht.

Hinweise zum Risikomanagement

  • StartProtection() wird beim Start aktiviert, um sich in die Standard-StockSharp-Schutzsysteme einzuklinken.
  • Distanz- und Take-Profit-Werte werden in Pips gemessen. Für Symbole, die mit 3 oder 5 Dezimalstellen notiert werden, multipliziert die Strategie den Preisschritt mit 10, um der MetaTrader-Pip-Semantik zu entsprechen.
  • Es gibt keinen automatischen Stop-Loss; das Risiko muss durch die gewählten Parameter und externe Portfoliolimits kontrolliert werden.

Parameter

  • Candle Type – Datentyp für die Kerzensubskription.
  • MA Length – Periode des gleitenden Durchschnitts.
  • MA Type – Glättungsmethode des gleitenden Durchschnitts.
  • Price Source – Kerzenkurs zur Berechnung des gleitenden Durchschnitts.
  • Distance (pips) – Minimale Pip-Lücke zwischen Preis und gleitendem Durchschnitt zum Auslösen von Einstiegen.
  • Take Profit (pips) – Gewinnziel-Distanz, die angewendet wird, wenn nur eine Position offen ist.
  • Volume Multiplier – Multiplikator auf das Basisvolumen für zusätzliche Einstiege.
  • Base Volume – Menge des ersten Handels.
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>
/// VR Moving strategy converted from MetaTrader 5 expert advisor.
/// Opens positions when price deviates from a moving average by a configurable distance and scales using a multiplier.
/// </summary>
public class VrMovingDistanceStrategy : Strategy
{
	public enum MovingAverageTypes
	{
		Simple,
		Exponential,
		Smoothed,
		Weighted,
		VolumeWeighted
	}

	public enum CandlePrices
	{
		Open,
		High,
		Low,
		Close,
		Median,
		Typical,
		Weighted
	}

	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _maLength;
	private readonly StrategyParam<MovingAverageTypes> _maType;
	private readonly StrategyParam<CandlePrices> _priceSource;
	private readonly StrategyParam<decimal> _distancePips;
	private readonly StrategyParam<decimal> _takeProfitPips;
	private readonly StrategyParam<decimal> _volumeMultiplier;
	private readonly StrategyParam<decimal> _baseVolume;

	private DecimalLengthIndicator _movingAverage = null!;
	private decimal _pipSize;

	private int _longEntries;
	private int _shortEntries;
	private decimal _longHighestEntry;
	private decimal _shortLowestEntry;
	private decimal? _longEntryPrice;
	private decimal? _shortEntryPrice;

	/// <summary>
	/// Candle type used for the moving average and decision logic.
	/// </summary>
	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	/// <summary>
	/// Moving average length.
	/// </summary>
	public int MaLength
	{
		get => _maLength.Value;
		set => _maLength.Value = value;
	}

	/// <summary>
	/// Moving average smoothing type.
	/// </summary>
	public MovingAverageTypes MaType
	{
		get => _maType.Value;
		set => _maType.Value = value;
	}

	/// <summary>
	/// Candle price source for the moving average.
	/// </summary>
	public CandlePrices PriceSource
	{
		get => _priceSource.Value;
		set => _priceSource.Value = value;
	}

	/// <summary>
	/// Distance from the moving average in pips.
	/// </summary>
	public decimal DistancePips
	{
		get => _distancePips.Value;
		set => _distancePips.Value = value;
	}

	/// <summary>
	/// Take profit distance in pips when a single position is active.
	/// </summary>
	public decimal TakeProfitPips
	{
		get => _takeProfitPips.Value;
		set => _takeProfitPips.Value = value;
	}

	/// <summary>
	/// Volume multiplier for additional entries in the same direction.
	/// </summary>
	public decimal VolumeMultiplier
	{
		get => _volumeMultiplier.Value;
		set => _volumeMultiplier.Value = value;
	}

	/// <summary>
	/// Base order volume.
	/// </summary>
	public decimal BaseVolume
	{
		get => _baseVolume.Value;
		set => _baseVolume.Value = value;
	}

	/// <summary>
	/// Constructor.
	/// </summary>
	public VrMovingDistanceStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Timeframe used for calculations", "General");

		_maLength = Param(nameof(MaLength), 60)
			.SetGreaterThanZero()
			.SetDisplay("MA Length", "Moving average period", "Moving Average")
			
			.SetOptimize(10, 200, 10);

		_maType = Param(nameof(MaType), MovingAverageTypes.Exponential)
			.SetDisplay("MA Type", "Moving average smoothing method", "Moving Average");

		_priceSource = Param(nameof(PriceSource), CandlePrices.Close)
			.SetDisplay("Price Source", "Price used for the moving average", "Moving Average");

		_distancePips = Param(nameof(DistancePips), 50m)
			.SetGreaterThanZero()
			.SetDisplay("Distance (pips)", "Offset from the moving average", "Trading")
			
			.SetOptimize(10m, 150m, 10m);

		_takeProfitPips = Param(nameof(TakeProfitPips), 50m)
			.SetNotNegative()
			.SetDisplay("Take Profit (pips)", "Exit distance when only one position is open", "Trading")
			
			.SetOptimize(10m, 150m, 10m);

		_volumeMultiplier = Param(nameof(VolumeMultiplier), 1m)
			.SetGreaterThanZero()
			.SetDisplay("Volume Multiplier", "Multiplier for additional entries", "Trading")
			
			.SetOptimize(1m, 3m, 0.25m);

		_baseVolume = Param(nameof(BaseVolume), 1m)
			.SetGreaterThanZero()
			.SetDisplay("Base Volume", "Volume of the initial order", "Trading");
	}

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

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

		_longEntries = 0;
		_shortEntries = 0;
		_longHighestEntry = 0m;
		_shortLowestEntry = 0m;
		_longEntryPrice = null;
		_shortEntryPrice = null;
		_pipSize = 0m;
	}

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

		UpdatePipSize();

		_movingAverage = CreateMovingAverage(MaType, MaLength, PriceSource);

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

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

	}

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

		if (!_movingAverage.IsFormed)
			return;


		var distance = DistancePips * _pipSize;
		var takeProfit = TakeProfitPips * _pipSize;

		var longTrigger = _longEntries == 0 ? maValue + distance : _longHighestEntry + distance;
		var shortTrigger = _shortEntries == 0 ? maValue - distance : _shortLowestEntry - distance;

		if (takeProfit > 0m)
		{
			// Close a single long position once the take profit level is reached.
			if (_longEntries == 1 && Position > 0 && _longEntryPrice.HasValue)
			{
				var target = _longEntryPrice.Value + takeProfit;
				if (candle.HighPrice >= target)
				{
					SellMarket(Position);
					ResetLongState();
				}
			}

			// Close a single short position once the take profit level is reached.
			if (_shortEntries == 1 && Position < 0 && _shortEntryPrice.HasValue)
			{
				var target = _shortEntryPrice.Value - takeProfit;
				if (candle.LowPrice <= target)
				{
					BuyMarket(Math.Abs(Position));
					ResetShortState();
				}
			}
		}

		var baseVolume = BaseVolume;
		if (baseVolume <= 0m)
			return;

		// Open or scale a long position when price moves sufficiently above the moving average.
		if (candle.HighPrice >= longTrigger)
		{
			ExecuteLongEntry(longTrigger);
		}
		// Open or scale a short position when price moves sufficiently below the moving average.
		else if (candle.LowPrice <= shortTrigger)
		{
			ExecuteShortEntry(shortTrigger);
		}
	}

	private void ExecuteLongEntry(decimal triggerPrice)
	{
		var volume = _longEntries == 0 ? BaseVolume : BaseVolume * VolumeMultiplier;
		if (volume <= 0m)
			return;

		var orderVolume = volume;

		// Reverse short exposure before adding new long volume.
		if (Position < 0)
		{
			orderVolume += Math.Abs(Position);
			ResetShortState();
		}

		BuyMarket(orderVolume);

		_longEntries++;
		_longHighestEntry = _longEntries == 1 ? triggerPrice : Math.Max(_longHighestEntry, triggerPrice);
		_longEntryPrice = _longEntries == 1 ? triggerPrice : null;
	}

	private void ExecuteShortEntry(decimal triggerPrice)
	{
		var volume = _shortEntries == 0 ? BaseVolume : BaseVolume * VolumeMultiplier;
		if (volume <= 0m)
			return;

		var orderVolume = volume;

		// Reverse long exposure before adding new short volume.
		if (Position > 0)
		{
			orderVolume += Position;
			ResetLongState();
		}

		SellMarket(orderVolume);

		_shortEntries++;
		_shortLowestEntry = _shortEntries == 1 ? triggerPrice : Math.Min(_shortLowestEntry, triggerPrice);
		_shortEntryPrice = _shortEntries == 1 ? triggerPrice : null;
	}

	private void ResetLongState()
	{
		_longEntries = 0;
		_longHighestEntry = 0m;
		_longEntryPrice = null;
	}

	private void ResetShortState()
	{
		_shortEntries = 0;
		_shortLowestEntry = 0m;
		_shortEntryPrice = null;
	}

	private void UpdatePipSize()
	{
		var step = Security?.PriceStep ?? 1m;
		if (step <= 0m)
			step = 1m;

		var digits = GetDecimalDigits(step);
		_pipSize = (digits == 3 || digits == 5) ? step * 10m : step;
	}

	private static int GetDecimalDigits(decimal value)
	{
		value = Math.Abs(value);
		var digits = 0;
		while (value != Math.Truncate(value) && digits < 10)
		{
			value *= 10m;
			digits++;
		}

		return digits;
	}

	private static DecimalLengthIndicator CreateMovingAverage(MovingAverageTypes type, int length, CandlePrices priceSource)
	{
		DecimalLengthIndicator indicator = type switch
		{
			MovingAverageTypes.Simple => new SimpleMovingAverage(),
			MovingAverageTypes.Exponential => new ExponentialMovingAverage(),
			MovingAverageTypes.Smoothed => new SmoothedMovingAverage(),
			MovingAverageTypes.Weighted => new WeightedMovingAverage(),
			_ => new SimpleMovingAverage(),
		};

		indicator.Length = length;
		return indicator;
	}
}