Deutsch DE
Auf GitHub ansehen

Timer-Strategie

Die Timer-Strategie berechnet Ausbruchsniveaus in festen Zeitintervallen neu und handelt, wenn der Preis diese dynamischen Schwellen kreuzt. Die Niveaus werden anhand des Average True Range (ATR) und einem optionalen zusätzlichen Pip-Abstand positioniert. Der Ansatz zielt darauf ab, kurzfristige Ausbrüche in beide Richtungen zu erfassen.

Alle WaitSeconds setzt die Strategie:

  • Kaufniveau bei close + pipDistance + ATR.
  • Verkaufsniveau bei close - pipDistance - ATR.

Wenn die nächste abgeschlossene Kerze jenseits eines dieser Niveaus schließt, wird eine Marktorder in der entsprechenden Richtung platziert. Die Position ist durch konfigurierbaren Stop-Loss, Take-Profit und Trailing Stop geschützt.

Der Handel kann mithilfe der Handelszeiteinstellungen auf ein bestimmtes Zeitfenster begrenzt werden.

Parameter

  • WaitSeconds – Sekunden zwischen Neuberechnungen der Niveaus.
  • PipDistance – zusätzlicher Abstand vom aktuellen Preis in Punkten.
  • AtrPeriod – ATR-Indikatorperiode.
  • TakeProfit – Take-Profit-Abstand in Punkten.
  • StopLoss – Stop-Loss-Abstand in Punkten.
  • TrailingStop – Trailing-Stop-Abstand in Punkten.
  • TradeVolume – Ordervolumen.
  • CandleType – Kerzentyp für Berechnungen.
  • UseTradingHours – Tageszeit-Filter aktivieren.
  • StartTime – Handelsstartzeit.
  • StopTime – Handelsendzeit.

Funktionsweise

  1. Anmeldung auf Kerzen und ATR-Berechnung.
  2. Bei jeder abgeschlossenen Kerze:
    • Wenn das konfigurierte Zeitintervall abgelaufen ist, werden neue Kauf- und Verkaufsniveaus berechnet.
    • Wenn Handelszeiten aktiviert sind, wird geprüft, ob die aktuelle Zeit im erlaubten Fenster liegt.
    • Kauf- oder Verkaufs-Marktorder wird platziert, wenn der Preis das entsprechende Niveau kreuzt.
  3. Stop-Loss, Take-Profit und Trailing Stop werden automatisch von der Strategie-Infrastruktur verwaltet.

Hinweise

  • Die Strategie handelt sowohl Long als auch Short.
  • Funktioniert mit jedem Instrument und Zeitrahmen.
  • ATR-basierte Niveaus passen sich der Marktvolatilität an und ermöglichen eine flexible Ausbruchserkennung.
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>
/// Timer ATR breakout strategy.
/// </summary>
public class TimerStrategy : Strategy
{
	private readonly StrategyParam<int> _waitSeconds;
	private readonly StrategyParam<decimal> _pipDistance;
	private readonly StrategyParam<int> _atrPeriod;
	private readonly StrategyParam<decimal> _takeProfit;
	private readonly StrategyParam<decimal> _stopLoss;
	private readonly StrategyParam<decimal> _trailingStop;
	private readonly StrategyParam<decimal> _tradeVolume;
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<bool> _useTradingHours;
	private readonly StrategyParam<TimeSpan> _startTime;
	private readonly StrategyParam<TimeSpan> _stopTime;

	private readonly List<Order> _pendingOrders = [];

	private DateTimeOffset? _lastLevelTime;
	private decimal? _buyLevel;
	private decimal? _sellLevel;
	private decimal? _trailExtreme;

	public int WaitSeconds { get => _waitSeconds.Value; set => _waitSeconds.Value = value; }
	public decimal PipDistance { get => _pipDistance.Value; set => _pipDistance.Value = value; }
	public int AtrPeriod { get => _atrPeriod.Value; set => _atrPeriod.Value = value; }
	public decimal TakeProfit { get => _takeProfit.Value; set => _takeProfit.Value = value; }
	public decimal StopLoss { get => _stopLoss.Value; set => _stopLoss.Value = value; }
	public decimal TrailingStop { get => _trailingStop.Value; set => _trailingStop.Value = value; }
	public decimal TradeVolume { get => _tradeVolume.Value; set => _tradeVolume.Value = value; }
	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }
	public bool UseTradingHours { get => _useTradingHours.Value; set => _useTradingHours.Value = value; }
	public TimeSpan StartTime { get => _startTime.Value; set => _startTime.Value = value; }
	public TimeSpan StopTime { get => _stopTime.Value; set => _stopTime.Value = value; }

	public TimerStrategy()
	{
		_waitSeconds = Param(nameof(WaitSeconds), 60).SetGreaterThanZero();
		_pipDistance = Param(nameof(PipDistance), 10m).SetNotNegative();
		_atrPeriod = Param(nameof(AtrPeriod), 14).SetGreaterThanZero();
		_takeProfit = Param(nameof(TakeProfit), 100m).SetNotNegative();
		_stopLoss = Param(nameof(StopLoss), 50m).SetNotNegative();
		_trailingStop = Param(nameof(TrailingStop), 0m).SetNotNegative();
		_tradeVolume = Param(nameof(TradeVolume), 1m).SetGreaterThanZero();
		_candleType = Param(nameof(CandleType), TimeSpan.FromMinutes(1).TimeFrame());
		_useTradingHours = Param(nameof(UseTradingHours), false);
		_startTime = Param(nameof(StartTime), TimeSpan.Zero);
		_stopTime = Param(nameof(StopTime), new TimeSpan(23, 59, 59));

		OrderRegistering += _pendingOrders.Add;
	}

	public override IEnumerable<(Security sec, DataType dt)> GetWorkingSecurities()
		=> [(Security, CandleType)];

	protected override void OnReseted()
	{
		base.OnReseted();
		_lastLevelTime = null;
		_buyLevel = null;
		_sellLevel = null;
		_trailExtreme = null;
		_pendingOrders.Clear();
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);

		var point = Security?.PriceStep ?? 1m;
		if (point <= 0m)
			point = 1m;

		var take = TakeProfit > 0m ? new Unit(TakeProfit * point, UnitTypes.Absolute) : null;
		var stop = StopLoss > 0m ? new Unit(StopLoss * point, UnitTypes.Absolute) : null;

		if (take is not null || stop is not null)
			StartProtection(take, stop, useMarketOrders: true);

		var atr = new AverageTrueRange { Length = AtrPeriod };
		SubscribeCandles(CandleType)
			.Bind(atr, (candle, atrValue) =>
			{
				if (candle.State != CandleStates.Finished || !atr.IsFormed || atrValue <= 0m)
					return;

				ProcessCandle(candle, atrValue);
			})
			.Start();
	}

	private void ProcessCandle(ICandleMessage candle, decimal atr)
	{
		var now = candle.CloseTime;

		var point = Security?.PriceStep ?? 1m;
		if (point <= 0m)
			point = 1m;

		var position = ApplyTrailingStop(candle, GetExpectedPosition(), point);

		if (IsTradingTime(now.TimeOfDay))
		{
			if (_buyLevel is decimal buy && candle.ClosePrice >= buy && position <= 0m)
			{
				BuyMarket(TradeVolume + Math.Abs(position));
				_trailExtreme = candle.ClosePrice;
			}
			else if (_sellLevel is decimal sell && candle.ClosePrice <= sell && position >= 0m)
			{
				SellMarket(TradeVolume + Math.Abs(position));
				_trailExtreme = candle.ClosePrice;
			}
		}

		if (_lastLevelTime is null || now - _lastLevelTime.Value >= TimeSpan.FromSeconds(WaitSeconds))
		{
			(_buyLevel, _sellLevel) = CalculateLevels(candle.ClosePrice, PipDistance, point, atr);
			_lastLevelTime = now;
		}
	}

	/// <summary>
	/// Position once the orders still in flight are filled. Protection registers its exit before the
	/// candle handler runs, so the handler must not close or size against the position that exit closes.
	/// </summary>
	private decimal GetExpectedPosition()
	{
		_pendingOrders.RemoveAll(order => order.State is OrderStates.Done or OrderStates.Failed);

		var position = Position;

		foreach (var order in _pendingOrders)
			position += order.Side == Sides.Buy ? order.Balance : -order.Balance;

		return position;
	}

	private decimal ApplyTrailingStop(ICandleMessage candle, decimal position, decimal point)
	{
		if (position == 0m)
		{
			_trailExtreme = null;
			return position;
		}

		if (TrailingStop <= 0m || _trailExtreme is not decimal extreme)
			return position;

		var trail = TrailingStop * point;

		// Earlier candles set the extreme: within this candle the order of high and low is unknown.
		if (position > 0m)
		{
			if (candle.LowPrice <= extreme - trail)
			{
				SellMarket(position);
				_trailExtreme = null;
				return 0m;
			}

			_trailExtreme = Math.Max(extreme, candle.HighPrice);
		}
		else
		{
			if (candle.HighPrice >= extreme + trail)
			{
				BuyMarket(-position);
				_trailExtreme = null;
				return 0m;
			}

			_trailExtreme = Math.Min(extreme, candle.LowPrice);
		}

		return position;
	}

	private bool IsTradingTime(TimeSpan time)
	{
		if (!UseTradingHours)
			return true;

		return StartTime <= StopTime
			? time >= StartTime && time <= StopTime
			: time >= StartTime || time <= StopTime;
	}

	internal static (decimal buy, decimal sell) CalculateLevels(
		decimal close,
		decimal pipDistancePoints,
		decimal priceStep,
		decimal atr)
	{
		var distance = pipDistancePoints * priceStep + atr;
		return (close + distance, close - distance);
	}
}