GitHub で見る

Fractals 最小距離

概要

Fractals 最小距離は、StockSharpの高レベル戦略APIを使用してMetaTraderのエキスパートアドバイザー「Fractals minimum distance」を再現します。このシステムは、設定されたローソク足シリーズをBill Williams式の5本バーフラクタルパターンでスキャンします。指定されたシグナルバーオフセットで新しい確認済みフラクタルが現れるたびに、戦略は最新の上昇フラクタルと下降フラクタルの間のギャップを測定します。この距離がpipsで表された必要なしきい値を超えた場合にのみ成行注文が許可されます。

この変換は、反転前に反対側のエクスポージャーを直ちに閉じるオリジナルの動作を維持します。MQLバージョンとは異なり、ポジションサイズはアカウントベースのリスク計算を行う代わりに戦略の Volume プロパティから取得されます。ソースのエキスパートに合わせて、ストップロスやテイクプロフィットの注文は送信されません。

シグナルロジック

  1. CandleType で定義されたローソク足タイプを購読し、常に過去 SignalBar 本のローソク足と各側に2本の隣接ローソク足を含む高値と安値のローリングバッファを構築します。
  2. 中央バーの高値が前の2本と後の2本のローソク足の高値より厳密に大きい場合に上部フラクタルを検出します。安値について同様に下部フラクタルを検出します。
  3. シンボルの PriceStep を使用して DistancePips パラメーターを価格距離に変換します。3桁または5桁の小数を持つシンボルは、0.001/0.00001の見積もりを1pipsとして扱うように自動的に調整されます。
  4. 上部フラクタルが確認された場合:
    • 新しい上部レベルを保存し、既存のロングポジションを閉じます。
    • 最新の上部フラクタルと下部フラクタルの両方がわかっており、その絶対差が少なくとも距離しきい値である場合、Volume を使用して成行売り注文を送信します。
  5. 下部フラクタルが確認された場合:
    • 新しい下部レベルを保存し、既存のショートポジションを閉じます。
    • 距離条件が満たされた場合、Volume を使用して成行買い注文を送信します。

トレードはフラクタルを完成させるローソク足が閉じた後にのみ行われ、未完成のバーがエントリーをトリガーしないことを保証します。戦略は環境が準備できる前に注文を配置することを避けるために IsFormedAndOnlineAndAllowTrading() に依存します。

パラメーター

名前 説明 備考
DistancePips pipsで測定した最新の上昇フラクタルと下降フラクタルの間の最小間隔。 楽器のティックサイズを使用して内部的に価格単位に変換されます。
SignalBar フラクタルをホストするバーの後に経過する必要がある完全に閉じたバーの数。 実効最小値は2で、Bill Williamsフラクタルで使用される2本バー確認に一致します。
CandleType 計算に使用するデータシリーズ。 デフォルトは1分足の時間軸です。他の解像度で動作するように変更できます。
Volume 取引サイズを定義するStockSharpの標準戦略プロパティ。 MetaTraderエキスパートのオリジナルのリスクベースのサイジングを置き換えます。

ポジション管理とMQLとの違い

  • ポジションは方向を反転させる前に常に決済されます。これはソースの ClosePositions ヘルパーの動作と全く同じです。
  • オリジナルのエキスパートは RefreshRates() を呼び出し、明示的なスリッページ設定を行いました。それらの側面はこのポートでStockSharpインフラストラクチャに委譲されます。
  • ストップロスとテイクプロフィットの注文はMQLロジックの一部ではなく、ここでも存在しません。
  • DistancePipsushort 入力のように整数精度を使用し、SignalBar はMQLの uchar 入力を反映します。
  • StockSharpはネットポジションで動作するため、反対方向に注文を開くと自動的にエクスポージャーが反転し、MetaTraderのネッティング動作に一致します。

使用のヒント

  • オリジナルコードと同じシグナルバーオフセット(SignalBar = 3)から始めて、楽器のボラティリティに応じて距離しきい値を調整します。
  • フラクタルが現れた後により多くのローソク足を待つために SignalBar を増やすと、急速な振動をフィルタリングできます。
  • 保護的なストップが必要な場合は、組み込みの StartProtection() ヘルパーなどの外部リスク管理と組み合わせてください。
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>
/// Fractals minimum distance breakout strategy converted from MetaTrader.
/// </summary>
public class FractalsMinimumDistanceStrategy : Strategy
{
	private readonly StrategyParam<int> _distancePips;
	private readonly StrategyParam<int> _signalBar;
	private readonly StrategyParam<DataType> _candleType;

	private decimal? _prevUpperFractal;
	private decimal? _prevLowerFractal;
	private decimal[] _highs = Array.Empty<decimal>();
	private decimal[] _lows = Array.Empty<decimal>();
	private int _bufferCount;
	private int _windowSize;
	private int _signalOffset;
	private decimal _pipSize;

	public int DistancePips
	{
		get => _distancePips.Value;
		set => _distancePips.Value = value;
	}

	public int SignalBar
	{
		get => _signalBar.Value;
		set => _signalBar.Value = value;
	}

	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	public FractalsMinimumDistanceStrategy()
	{
		_distancePips = Param(nameof(DistancePips), 15)
			.SetDisplay("Distance (pips)", "Minimum allowed gap between the last two fractals", "Risk")
			;

		_signalBar = Param(nameof(SignalBar), 3)
			.SetDisplay("Signal bar offset", "How many closed bars ago the fractal must appear", "General")
			;

		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle type", "Primary candle series used for signals", "Data")
			;
	}

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

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

		_prevUpperFractal = null;
		_prevLowerFractal = null;
		_highs = Array.Empty<decimal>();
		_lows = Array.Empty<decimal>();
		_bufferCount = 0;
		_windowSize = 0;
		_signalOffset = 0;
		_pipSize = 0m;
	}

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

		InitializeBuffers();
		_pipSize = CalculatePipSize();

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

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

	private void InitializeBuffers()
	{
		_signalOffset = Math.Max(2, SignalBar);
		_windowSize = Math.Max(_signalOffset + 3, 5);
		_highs = new decimal[_windowSize];
		_lows = new decimal[_windowSize];
		_bufferCount = 0;
	}

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

		// Shift the rolling buffers to keep the configured number of historical bars.
		for (var i = 0; i < _windowSize - 1; i++)
		{
			_highs[i] = _highs[i + 1];
			_lows[i] = _lows[i + 1];
		}

		// Append the latest candle extremes.
		_highs[_windowSize - 1] = candle.HighPrice;
		_lows[_windowSize - 1] = candle.LowPrice;

		if (_bufferCount < _windowSize)
			_bufferCount++;

		if (_bufferCount < _windowSize)
			return;

		var centerIndex = _windowSize - 1 - _signalOffset;
		if (centerIndex < 2 || centerIndex > _windowSize - 3)
			return;

		var high = _highs[centerIndex];
		var low = _lows[centerIndex];

		var isUpperFractal =
			high > _highs[centerIndex - 1] &&
			high > _highs[centerIndex - 2] &&
			high > _highs[centerIndex + 1] &&
			high > _highs[centerIndex + 2];

		var isLowerFractal =
			low < _lows[centerIndex - 1] &&
			low < _lows[centerIndex - 2] &&
			low < _lows[centerIndex + 1] &&
			low < _lows[centerIndex + 2];

		var distanceThreshold = DistancePips * _pipSize;

		if (isUpperFractal)
		{
			_prevUpperFractal = high;

			// Close existing long exposure before reversing.
			if (Position > 0)
				SellMarket();

			// Enter a short position if the fractals are far enough apart.
			if (ShouldOpenTrade(distanceThreshold))
				SellMarket();
		}

		if (isLowerFractal)
		{
			_prevLowerFractal = low;

			// Close existing short exposure before reversing.
			if (Position < 0)
				BuyMarket();

			// Enter a long position if the fractals are far enough apart.
			if (ShouldOpenTrade(distanceThreshold))
				BuyMarket();
		}
	}

	private bool ShouldOpenTrade(decimal distanceThreshold)
	{
		if (Volume <= 0)
			return false;

		if (_prevUpperFractal is not decimal upper || _prevLowerFractal is not decimal lower)
			return false;

		var threshold = Math.Abs(distanceThreshold);
		return Math.Abs(upper - lower) >= threshold;
	}

	private decimal CalculatePipSize()
	{
		var priceStep = Security?.PriceStep;

		if (priceStep is not decimal step || step <= 0m)
			return 1m;

		var decimals = GetDecimalPlaces(step);

		if (decimals == 3 || decimals == 5)
			return step * 10m;

		return step;
	}

	private static int GetDecimalPlaces(decimal value)
	{
		var bits = decimal.GetBits(value);
		return (bits[3] >> 16) & 0xFF;
	}
}