GitHub で見る

TrendManager TM Plus戦略

概要

TrendManager TM Plusは、元のMetaTrader 5エキスパートアドバイザーExp_TrendManager_Tm_Plus.mq5から変換されたトレンドフォロー戦略です。この戦略は、2本の平滑化された移動平均を比較してその間の距離を強調するカスタムインジケーターTrendManagerに依存しています。距離が設定可能なしきい値を超えると、戦略は支配的なトレンドの方向にポジションをオープンし、トレンドが反転したり保護ルールが発動したりするとポジションをクローズします。

取引ロジック

  1. 選択されたローソク足シリーズに2本の移動平均を構築します。両線の平滑化方法と長さは設定可能です。
  2. 速い平均と遅い平均の間の距離を計算します。距離がしきい値以上の場合、インジケーターは上昇トレンドを報告します。距離が負のしきい値以下の場合、インジケーターは下降トレンドを報告します。それ以外の場合、実行可能なシグナルはありません。
  3. カラー状態(上昇トレンドは0、下降トレンドは1、中立は3)を短い履歴に保存します。SignalBarパラメーターは、元のMQLロジックに従って評価する閉じたバーの数を選択します。
  4. 新しい上昇トレンドカラーが現れると、戦略はオプションで既存のショートポジションをクローズし、ロングエントリーが許可されている場合はロングポジションをオープンできます。逆に、新しい下降トレンドカラーはロングをクローズしてショートをオープンできます。
  5. オプションの時間ベースおよび価格ベースのエグジットは、保有時間がMaxPositionAgeを超えた場合、ロングの価格がStopLossDistanceを下回った場合(またはショートの場合は上回った場合)、またはTakeProfitDistanceに達した場合にオープントレードをクローズします。

パラメーター

  • Candle Type – シグナル生成に使用される時間軸(デフォルト:元のスクリプトと一致させるための4時間ローソク足)。
  • Fast MA Method / Slow MA Method – 速い線と遅い線の平滑化アルゴリズム。利用可能なオプション:Simple、Exponential、Smoothed、Weighted、Jurik、Kaufman Adaptive。
  • Fast Length / Slow Length – 移動平均の期間。
  • Distance Threshold(DvLimit – トレンドを検出するために必要な速い平均と遅い平均の間の最小絶対距離。元のMT5のポイントベース値を価格単位に変換します(例:5桁のシンボルの70ポイント≈0.00070)。
  • Signal Bar – 新しいシグナルを確認するために使用された閉じたバーの数。値が1の場合、MQL戦略のデフォルト動作を再現します。
  • Allow Long Entries / Allow Short Entries – 各方向のエントリーを有効/無効にします。
  • Close Long / Close Short on Opposite Signal – 反対の色のシグナルが現れたときに即座にオープンポジションをクローズします。
  • Use Time Exit / Max Position Age – ポジションが強制的にクローズされる前の最大保有時間を有効化して設定します。
  • Order Volume – マーケット注文で送信される固定ボリューム。このパラメーターはMetaTraderバージョンのマネー管理設定を置き換えます。
  • Stop Loss Distance / Take Profit Distance – 絶対価格単位で測定されたオプションの保護価格オフセット(無効にするにはゼロに設定)。

実装上の注意

  • TrendManagerの動作を再現するためにStockSharpインジケーターが使用されます。元のライブラリからサポートされていないエキゾチックな平滑化モードは、利用可能な最も近いStockSharpの移動平均にフォールバックします。
  • シグナル処理は小さな履歴バッファーを保持するため、SignalBarチェックがMT5アドバイザーと同様に遷移を検出できます。
  • 保護エグジットは完成したローソク足で評価されます。元の環境のバー内フィルは、ローソク足の高値と安値を設定された距離と比較することで近似されます。
  • DeviationやマージンベースのポジションサイジングなどのMT5固有のパラメーターは、StockSharpに適した対応物に置き換えられています。

使用上の推奨事項

  1. 意図された取引ホライズンに合うローソク足タイプを選択します。H4はソースコードとの同等性のためにデフォルトとして保持されています。
  2. しきい値をインストゥルメントのボラティリティに合わせてキャリブレーションします。ティックやボラティリティが大きいインストゥルメントはより高い値が必要です。
  3. 元のアドバイザーのリスクコントロールをエミュレートするため、時間エグジットをストップロスとテイクプロフィット距離と組み合わせます。
  4. 両方向で取引する資産については、トレンドが変化したときに戦略がポジションを反転できるよう、両方のエントリートグルを有効にしておきます。

元のエキスパートアドバイザーとの違い

  • 注文サイジングはMT5のマネー管理モジュールの代わりに固定のOrderVolumeを使用します。
  • ストップロスとテイクプロフィット注文は即座のMT5注文配置ではなくローソク足データを使用してシミュレートされます。
  • 戦略はStockSharpのネイティブ移動平均を使用します。一部の平滑化オプション(例:Jurik、Kaufman adaptive)は直接マッピングされ、サポートされていないMT5バリアントは最も近い一致にフォールバックします。
  • 時間ベースのエグジットは生の分カウンターの代わりにTimeSpan精度のMaxPositionAgeに依存します。

このドキュメントは、StockSharpエコシステム内でTrendManager TM Plus戦略を設定、実行、拡張するために必要な重要情報を提供します。

using System;
using System.Collections.Generic;

using StockSharp.Algo.Indicators;
using StockSharp.Algo.Strategies;
using StockSharp.BusinessEntities;
using StockSharp.Messages;

namespace StockSharp.Samples.Strategies;

/// <summary>
/// TrendManager TM Plus strategy. Uses fast/slow EMA crossover with distance threshold.
/// </summary>
public class TrendManagerTmPlusStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _fastLength;
	private readonly StrategyParam<int> _slowLength;
	private decimal? _prevFast;
	private decimal? _prevSlow;

	public DataType CandleType { get => _candleType.Value; set => _candleType.Value = value; }
	public int FastLength { get => _fastLength.Value; set => _fastLength.Value = value; }
	public int SlowLength { get => _slowLength.Value; set => _slowLength.Value = value; }

	public TrendManagerTmPlusStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(1).TimeFrame()).SetDisplay("Candle Type", "Timeframe", "General");
		_fastLength = Param(nameof(FastLength), 10).SetGreaterThanZero().SetDisplay("Fast EMA", "Fast EMA period", "Indicators");
		_slowLength = Param(nameof(SlowLength), 30).SetGreaterThanZero().SetDisplay("Slow EMA", "Slow EMA period", "Indicators");
	}

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

	/// <inheritdoc />
	protected override void OnReseted()
	{
		base.OnReseted();
		_prevFast = null;
		_prevSlow = null;
	}

	protected override void OnStarted2(DateTime time)
	{
		base.OnStarted2(time);
		_prevFast = null; _prevSlow = null;
		var fast = new ExponentialMovingAverage { Length = FastLength };
		var slow = new ExponentialMovingAverage { Length = SlowLength };
		var subscription = SubscribeCandles(CandleType);
		subscription.Bind(fast, slow, ProcessCandle).Start();
		var area = CreateChartArea();
		if (area != null) { DrawCandles(area, subscription); DrawIndicator(area, fast); DrawIndicator(area, slow); DrawOwnTrades(area); }
	}

	private void ProcessCandle(ICandleMessage candle, decimal fast, decimal slow)
	{
		if (candle.State != CandleStates.Finished) return;
		if (!IsFormedAndOnlineAndAllowTrading()) { _prevFast = fast; _prevSlow = slow; return; }
		if (_prevFast == null || _prevSlow == null) { _prevFast = fast; _prevSlow = slow; return; }
		var prevAbove = _prevFast.Value > _prevSlow.Value;
		var currAbove = fast > slow;
		_prevFast = fast; _prevSlow = slow;
		if (!prevAbove && currAbove && Position <= 0) { if (Position < 0) BuyMarket(); BuyMarket(); }
		else if (prevAbove && !currAbove && Position >= 0) { if (Position > 0) SellMarket(); SellMarket(); }
	}
}