日本語 JA
GitHub で見る

TraderToolEA手動パネル（StockSharp移植）

概要

元のMetaTrader 4エキスパートアドバイザーTraderToolEA v1.8は自律売買ロボットではなく、裁量トレーダーが注文、グリッド、保護水準を管理するためのコントロールパネルです。この移植版はStockSharpフレームワーク内でパネルを再現します。チャート上ボタンの代わりに、戦略はトグルボタンのように振る舞うboolパラメーターを公開します。GUIまたはスクリプトでtrueに設定すると、対応するアクションを起動します。

移植された主な機能:

  • ロング/ショートエクスポージャーを開閉する成行注文ショートカット。
  • stopまたはlimitの待機注文で構成される対称グリッドの自動配置。
  • 待機注文（買い/売り/すべて）の選択的キャンセルと任意の孤立注文クリーンアップ。
  • Level1気配に基づく仮想ストップロス、テイクプロフィット、トレーリングストップ、ブレイクイーブン管理。
  • MetaTraderのロット計算（AccountBalance / LotSize * RiskFactor）を模倣する自動サイズ設定オプション。

すべてのロジックは高レベルAPIだけに依存します。Level1購読、注文ヘルパーメソッド（BuyStop、SellLimit、CancelOrder...）、組み込みログ機能を使います。

パラメーター

名前 説明
Use Auto Volume trueの場合、戦略はポートフォリオ残高とRisk Factorからロットサイズを計算します。それ以外は固定Order Volumeを使います。
Risk Factor 自動数量計算時にポートフォリオ残高へ適用する乗数。MT4入力RiskFactorに相当します。
Order Volume 自動サイズ設定が無効な場合、すべての成行または待機注文で使う手動ロットサイズ。
Distance (pips) 階層化された待機注文間の間隔（MetaTrader pips）。stopグリッドとlimitグリッドの両方に適用します。
Layers コマンドごとの追加待機注文数。1はEAでの1回ボタン押下を反映し、より高い値は複数回押下を模倣します。
Delete Orphans 有効時、部分約定後も買い/売りグリッドが均衡するよう、対応しない待機注文を自動キャンセルします。
Enable Stop Loss / Stop Loss (pips) 平均エントリー価格に対してpipsで測る固定ストップロス監視を有効にします。
Enable Take Profit / Take Profit (pips) pipsで測る固定テイクプロフィット監視を有効にします。
Enable Trailing / Trailing (pips) 仮想トレーリングストップ管理を有効にします。価格が少なくともTrailing pips有利に動いてからトレールが起動します。
Enable Break-Even / Break-Even Trigger / Break-Even Lock 価格がトリガー距離だけ進むと、ストップをエントリー価格プラスロックオフセット（ロング）またはマイナスオフセット（ショート）へ移動します。
コマンドトグル（Open Buy、Place Buy Stops、Delete Sell Limitsなど） EAボタンを模倣するboolパラメーター。trueにするとアクションを実行し、戦略がfalseへ戻します。

注文ワークフロー

  1. データフィード: 戦略はDataType.Level1だけを購読します。最良bid/ask更新が保護ロジックとグリッド配置を駆動します。
  2. 数量正規化: 注文送信前に、要求数量は銘柄のVolumeStepへ丸められ、MinVolumeとMaxVolumeの間に制限されます。メタデータがない場合は生の値を使います。
  3. 待機注文: stopおよびlimitグリッドは直近bid/askの周囲に構築されます。マッチングエンジンの拒否を避けるため、価格は銘柄の価格ステップに揃えられます。
  4. 孤立注文制御: Delete Orphansが有効な場合、戦略は約定または手動キャンセル後に余分な側をキャンセルし、買い/売り待機注文数を対称に保ちます。同じロジックはstopグリッドとlimitグリッドへ個別に適用されます。
  5. 仮想保護: ストップロス、テイクプロフィット、トレーリングストップ、ブレイクイーブンは仮想ガードとして実装されます。しきい値を超えると、戦略は残数量を閉じる成行注文を発行し、内部のトレーリング/ブレイクイーブン状態をリセットします。

MetaTrader実装との差異

  • グラフィカル要素（ボタン、テキストボックス、色、音）はStockSharpパラメーターとログに置き換えられます。各アクションはAddWarningLogまたは既定ロガーで情報ログを書きます。
  • 保護ロジックはLevel1更新で動作し、個別注文のストップ価格を変更する代わりにポジションを直接閉じます。MetaTrader風stop注文をサポートしないブローカーでも動作を一貫させます。
  • MT4のManageOrdersモード（ID/manual/all/own）は戦略スコープへ集約されます。この戦略が作成した注文のみを追跡・管理します。
  • 自動ロットサイズはAccountBalance()ではなくポートフォリオ評価額を使いますが、式と丸め規則は維持します。

使用のヒント

  1. pip変換と数量丸めがブローカー規則に一致するよう、接続内で銘柄メタデータ（PriceStep、VolumeStep、MinVolume、LotSizeなど）を設定してください。
  2. 元の操作感を再現するため、StockSharp端末でboolコマンドパラメーターをホットキーまたはUIボタンに割り当ててください。各実行成功後、プロパティはfalseへ戻ります。
  3. 対称グリッドで作業する場合、片側が発動した後に残ったstop/limitを自動清掃するためDelete Orphansを有効にしてください。
  4. 情報ログを監視してください。bid/askがない、計算数量がゼロなどでアクションをスキップした場合、理由付きの警告が出ます。
  5. 保護は仮想なので、ポジションが開いている間は戦略を実行し続けてください。サーバー側stop注文ではなく成行注文で取引を閉じます。

移植メモ

  • pipサイズはMetaTraderを反映します。小数3桁または5桁の銘柄は、ポイントをpipsへ変換するため価格ステップを10倍します。
  • トレーリングストップとブレイクイーブンはMQLコードフローに従います。価格が利益方向へ動いた後にのみ起動し、新規取引、キャンセル、ポジション反転でリセットされる状態変数を使います。
  • EAはボタンを複数回押してグリッドを拡張できました。Layersパラメーターは、1回の呼び出しで複数の待機レベルを作成してこれを模倣します。
  • すべての手動コントロールはSetCanOptimize(false)を維持し、最適化キャンペーンが誤ってアクションを起動しないようにします。
using System;

using Ecng.Common;

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

namespace StockSharp.Samples.Strategies;

/// <summary>
/// Trader Tool Manager strategy: EMA + Momentum trend follower.
/// Buys when close crosses above EMA and momentum > 100.
/// Sells when close crosses below EMA and momentum < 100.
/// </summary>
public class TraderToolEaStrategy : Strategy
{
	private readonly StrategyParam<DataType> _candleType;
	private readonly StrategyParam<int> _emaPeriod;
	private readonly StrategyParam<int> _momPeriod;

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

	public int EmaPeriod
	{
		get => _emaPeriod.Value;
		set => _emaPeriod.Value = value;
	}

	public int MomPeriod
	{
		get => _momPeriod.Value;
		set => _momPeriod.Value = value;
	}

	public TraderToolEaStrategy()
	{
		_candleType = Param(nameof(CandleType), TimeSpan.FromHours(1).TimeFrame())
			.SetDisplay("Candle Type", "Candle timeframe", "General");

		_emaPeriod = Param(nameof(EmaPeriod), 30)
			.SetGreaterThanZero()
			.SetDisplay("EMA Period", "EMA period", "Indicators");

		_momPeriod = Param(nameof(MomPeriod), 20)
			.SetGreaterThanZero()
			.SetDisplay("Momentum", "Momentum period", "Indicators");
	}

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

		var ema = new ExponentialMovingAverage { Length = EmaPeriod };
		var mom = new Momentum { Length = MomPeriod };

		decimal? prevClose = null;
		decimal? prevEma = null;

		var subscription = SubscribeCandles(CandleType);
		subscription
			.Bind(ema, mom, (candle, emaVal, momVal) =>
			{
				if (candle.State != CandleStates.Finished)
					return;

				if (!IsFormedAndOnlineAndAllowTrading())
					return;

				var close = candle.ClosePrice;

				if (prevClose.HasValue && prevEma.HasValue)
				{
					var crossUp = prevClose.Value <= prevEma.Value && close > emaVal;
					var crossDown = prevClose.Value >= prevEma.Value && close < emaVal;

					if (crossUp && momVal > 100m && Position <= 0)
						BuyMarket();
					else if (crossDown && momVal < 100m && Position >= 0)
						SellMarket();
				}

				prevClose = close;
				prevEma = emaVal;
			})
			.Start();

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