GitHub で見る

KDJ エキスパートアドバイザー戦略

概要

この戦略はsenlin geによるMetaTrader 5「KDJ Expert Advisor」を再現します。%Kラインが2回平滑化されるストキャスティクスオシレーターの進化形であるKDJオシレーターからのシグナルを使用して単一のシンボルで取引します。戦略は%Kと%Dライン(しばしばJラインと呼ばれる)の差を観察してモメンタム反転を識別し、一度に1つのポジションのみをオープンします。取引管理は元のエキスパートアドバイザーを反映します:各取引はpipsで表現され、インスツルメントの設定を使用して価格距離に変換された固定ストップロスとテイクプロフィットを即座に受け取ります。

実装はローソク足サブスクリプションとMQL5バージョンのKDJパラメーターに一致するよう設定された組み込みのStochasticインジケーターを使用してStockSharpの高レベルAPIを使用します。コードは3桁または5桁のFORXシンボルを自動的に検出し、それに応じてpip値を調整します。

インジケーターロジック

基礎となるインジケーターは3段階で動作します:

  1. RSV計算 – 各完成したローソク足に対して、KDJ Lengthローソク足のRaw Stochastic Valueを計算します: [ RSV = \frac{Close - LowestLow}{HighestHigh - LowestLow} \times 100 ]
  2. %K平滑化 – %Kラインを得るために最後のSmooth %K個のRSV値を平均します。
  3. %D平滑化 – %Dラインを得るために最後のSmooth %D個の%K値を平均します。

戦略は次にK - D(元のソースでKDCと呼ばれる)と%Kの傾きを分析して反転を検出します。

エントリー条件

シンボルに対して既存のポジションがない場合のみ市場ポジションがオープンされます。シグナルは完成したローソク足で評価されます:

  • 買いは以下のいずれかの条件が真の場合:
    • K - Dがゼロを上向きにクロスする(ネガティブからポジティブへ);または
    • K - Dがゼロより上で、%Kラインが上昇している(K_current > K_previous)。
  • 売りは以下のいずれかの条件が真の場合:
    • K - Dがゼロを下向きにクロスする(ポジティブからネガティブへ);または
    • K - Dがゼロより下で、%Kラインが下落している(K_current < K_previous)。

これは元のMQL5エキスパートアドバイザーのブール構造に一致し、同一の取引タイミングを保証します。

リスク管理

  • 各約定した注文は保護ストップロスとテイクプロフィットを受け取り、pipsで測定され、インスツルメントのティックサイズを通じて価格距離に変換されます。ゼロ値は対応する保護レグを無効にします。
  • 戦略はピラミッドや平均コストを行いません。現在のポジションが保護注文または手動介入によって閉じられるまでフラットを維持します。

パラメーター

パラメーター 説明 デフォルト値
Candle Type 入力ローソク足のデータタイプ/時間軸。 15分時間軸
KDJ Length RSV計算のローソク足数。 30
Smooth %K %Kラインを平滑化するために使用されるRSV値の数。 3
Smooth %D %Dラインを平滑化するために使用される%K値の数。 6
Stop Loss (pips) 保護ストップロスの距離。無効にするには0に設定。 25
Take Profit (pips) 保護テイクプロフィットの距離。無効にするには0に設定。 45
Order Volume 市場注文で送信される数量。 1

すべてのパラメーターは元のエキスパートアドバイザーの入力と同一の最適化範囲をサポートします。

使用上の注意

  1. テスターまたはライブ環境で希望のインスツルメントとコネクターを設定します。
  2. MetaTraderからエミュレートしたいチャートの時間軸に合わせてローソク足タイプを調整します。
  3. オプションでKDJパラメーター、ストップロス、テイクプロフィット、または注文ボリュームを最適化します。
  4. 戦略を開始します。注文は完全に形成されたローソク足でのみ生成されます。
  5. チャートには視覚的な確認のためにローソク足、KDJインジケーター、および実行された取引が自動的に表示されます。

元のEAとの違い

  • MQL5 KDJバッファーを複製するために平滑化期間付きのStockSharpのStochasticインジケーターを使用します;外部インジケーターファイルは不要です。
  • 保護注文はStartProtectionを通じて管理され、トリガーされると市場決済を送信します。
  • ボリュームはMQL5のMoneyFixedMarginリスクモデルの代わりに固定パラメーターであり、実装を簡潔にシグナルロジックに集中させます。
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 replicates the MetaTrader KDJ Expert Advisor logic.
/// Uses the KDJ oscillator to detect momentum reversals and opens a single position with fixed take-profit and stop-loss levels.
/// </summary>
public class KdjExpertAdvisorStrategy : Strategy
{
	private readonly StrategyParam<int> _kdjPeriod;
	private readonly StrategyParam<int> _smoothK;
	private readonly StrategyParam<int> _smoothD;
	private readonly StrategyParam<int> _stopLossPips;
	private readonly StrategyParam<int> _takeProfitPips;
	private readonly StrategyParam<decimal> _orderVolume;
	private readonly StrategyParam<DataType> _candleType;

	private decimal? _previousK;
	private decimal? _previousKdc;
	private decimal _pipSize;

	/// <summary>
	/// Main lookback period used to calculate RSV for the KDJ oscillator.
	/// </summary>
	public int KdjPeriod
	{
		get => _kdjPeriod.Value;
		set => _kdjPeriod.Value = value;
	}

	/// <summary>
	/// Smoothing period applied to the %K line.
	/// </summary>
	public int SmoothK
	{
		get => _smoothK.Value;
		set => _smoothK.Value = value;
	}

	/// <summary>
	/// Smoothing period applied to the %D line.
	/// </summary>
	public int SmoothD
	{
		get => _smoothD.Value;
		set => _smoothD.Value = value;
	}

	/// <summary>
	/// Stop-loss distance expressed in pips.
	/// </summary>
	public int StopLossPips
	{
		get => _stopLossPips.Value;
		set => _stopLossPips.Value = value;
	}

	/// <summary>
	/// Take-profit distance expressed in pips.
	/// </summary>
	public int TakeProfitPips
	{
		get => _takeProfitPips.Value;
		set => _takeProfitPips.Value = value;
	}

	/// <summary>
	/// Volume applied to every market order.
	/// </summary>
	public decimal OrderVolume
	{
		get => _orderVolume.Value;
		set => _orderVolume.Value = value;
	}

	/// <summary>
	/// Candle type used for indicator calculations.
	/// </summary>
	public DataType CandleType
	{
		get => _candleType.Value;
		set => _candleType.Value = value;
	}

	/// <summary>
	/// Initializes a new instance of the <see cref="KdjExpertAdvisorStrategy"/> class.
	/// </summary>
	public KdjExpertAdvisorStrategy()
	{
		_kdjPeriod = Param(nameof(KdjPeriod), 30)
			.SetGreaterThanZero()
			.SetDisplay("KDJ Length", "Lookback period for KDJ RSV calculation", "KDJ")
			
			.SetOptimize(10, 60, 5);

		_smoothK = Param(nameof(SmoothK), 3)
			.SetGreaterThanZero()
			.SetDisplay("Smooth %K", "Smoothing length for %K", "KDJ")
			
			.SetOptimize(1, 10, 1);

		_smoothD = Param(nameof(SmoothD), 6)
			.SetGreaterThanZero()
			.SetDisplay("Smooth %D", "Smoothing length for %D", "KDJ")
			
			.SetOptimize(1, 15, 1);

		_stopLossPips = Param(nameof(StopLossPips), 250)
			.SetNotNegative()
			.SetDisplay("Stop Loss (pips)", "Protective stop distance in pips", "Risk")

			.SetOptimize(0, 1000, 50);

		_takeProfitPips = Param(nameof(TakeProfitPips), 450)
			.SetNotNegative()
			.SetDisplay("Take Profit (pips)", "Profit target distance in pips", "Risk")

			.SetOptimize(0, 1500, 50);

		_orderVolume = Param(nameof(OrderVolume), 1m)
			.SetGreaterThanZero()
			.SetDisplay("Order Volume", "Quantity used for entries", "Trading");

		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(4).TimeFrame())
			.SetDisplay("Candle Type", "Timeframe for KDJ calculation", "Data");
	}

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

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

		_previousK = null;
		_previousKdc = null;
		_pipSize = 0m;
	}

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

		_pipSize = CalculatePipSize();

		var stopLossUnit = StopLossPips > 0 ? new Unit(StopLossPips * _pipSize, UnitTypes.Absolute) : null;
		var takeProfitUnit = TakeProfitPips > 0 ? new Unit(TakeProfitPips * _pipSize, UnitTypes.Absolute) : null;

		StartProtection(
			takeProfit: takeProfitUnit,
			stopLoss: stopLossUnit,
			useMarketOrders: true);

		var kdj = new StochasticOscillator
		{
			K = { Length = KdjPeriod },
			D = { Length = SmoothD }
		};

		var subscription = SubscribeCandles(CandleType);
		subscription
			.BindEx(kdj, ProcessCandle)
			.Start();

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

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

		var stochastic = (StochasticOscillatorValue)kdjValue;
		if (stochastic.K is not decimal k || stochastic.D is not decimal d)
			return;

		var kdc = k - d;

		var buySignal = false;
		var sellSignal = false;

		if (_previousKdc.HasValue)
		{
			buySignal |= _previousKdc.Value < 0m && kdc > 0m;
			sellSignal |= _previousKdc.Value > 0m && kdc < 0m;
		}

		if (_previousK.HasValue)
		{
			buySignal |= kdc > 0m && _previousK.Value < k;
			sellSignal |= kdc < 0m && _previousK.Value > k;
		}

		if (buySignal || sellSignal)
		{
			if (Position == 0)
			{
				if (buySignal)
				{
					LogInfo($"Buy signal at {candle.ClosePrice}: K={k:F2}, D={d:F2}, K-D={kdc:F2}");
					BuyMarket();
				}
				else if (sellSignal)
				{
					LogInfo($"Sell signal at {candle.ClosePrice}: K={k:F2}, D={d:F2}, K-D={kdc:F2}");
					SellMarket();
				}
			}
		}

		_previousK = k;
		_previousKdc = kdc;
	}

	private decimal CalculatePipSize()
	{
		var security = Security;
		if (security == null)
			return 1m;

		var step = security.PriceStep ?? 1m;
		var decimals = security.Decimals;
		var multiplier = (decimals == 3 || decimals == 5) ? 10m : 1m;

		return step * multiplier;
	}
}