TotalPLForceCloseMT5
- ユーティリティ
- バージョン: 1.49
- アクティベーション: 5
==================================================================
商品名
==================================================================
Total PL Close Manager MT5
（合計損益で一括決済・共通TP/SL・利益保護）
==================================================================
説明文
==================================================================
Total PL Close Manager は、MetaTrader 5 用のポジション管理ユーティリティです。対象ポジションの合計損益を監視し、合計の利確目標または損切目標に達したら対象ポジションをまとめて決済します。また、銘柄ごと・BUY/SELL ごとに共通の TP/SL 価格を計算して各ポジションにサーバー側の注文として設定し、含み益が伸びたグループの利益保護や、その SL のトレーリングも行えます。
本ユーティリティは新規注文を一切出しません。手動で建てたポジションや、他の EA が建てたポジションの管理だけを行います。
■ 主な機能
1. 合計損益による一括決済
・対象ポジションの合計損益が利確目標または損切目標に達したら、すべて決済します。
・目標は「口座通貨の金額」または「口座残高に対する％」で指定できます。
・利確と損切は個別にオン/オフできます。
・損益の基準は評価損益＋スワップです（手数料は含みません）。
2. 銘柄・方向別の共通 TP/SL
・ポジションを銘柄ごと、BUY/SELL ごとのグループに分けて管理します。
・グループ全体が目標損益に達する価格を計算し、その価格をグループ内の全ポジションに TP/SL として設定します。
・TP/SL はサーバー側の注文なので、端末や VPS の接続が切れても有効なまま残ります。
・ポジションが追加・決済されると、グループ全体の共通 TP/SL を計算し直して更新します。
3. 利益保護
・グループの利益が TP 目標の一定割合（初期値 60%）に達すると、SL を利益側の小さな割合（初期値 5%）の位置へ移動します。
・発動後に追加されたポジションの扱いは 2 通りから選べます。発動時の SL 価格を固定して引き継ぐか、保護する利益を計算し直すかです（どちらの場合も SL を不利な方向へ戻すことはありません）。
4. 利益保護後のトレーリング
・利益保護の SL が設定された後、指定した価格幅（例：ゴールドなら 0.50）ごとに SL を価格に追従させます。
・SL は有利な方向にしか動きません。
5. 銘柄別設定（10 枠）
・銘柄ごとに、TP/SL の判定方法と値、利益保護の割合、トレーリング幅と間隔を個別に設定できます。
・0 または「共通設定を使用」にした項目は共通設定が使われます。登録していない銘柄も共通設定で動きます。
・設定値は、その銘柄の BUY グループと SELL グループにそれぞれ適用されます。
6. 対象ポジションの絞り込み
・すべてのポジション、または指定したマジックナンバーのポジションだけを対象にできます（複数指定はカンマ区切り）。
・手動取引（Magic = 0）は「マジック設定に従う」「手動のみ」「手動も含める」「手動を除外」から選べます。
7. 損益分岐ライン
・スワップを含めた BUY/SELL 別の損益分岐ラインを、その銘柄の開いているすべてのチャート（または EA を設置したチャートのみ）に表示します。
・表示専用です。ラインに達しても決済は行いません。
8. チャート上の状態表示
・合計損益、目標値、各グループの損益、TP/SL の候補価格、設定済みのポジション数、処理が保留されている場合はその理由を表示します。
■ 注文処理の安全対策
・TP/SL 変更には最短送信間隔と 1 分あたりの上限があり、取引サーバーへ要求を送りすぎないようにしています。
・成行決済にも別の送信間隔を設けています。許容スリッページも設定できます。
・ブローカーのストップレベル・フリーズレベルを考慮し、さらに指定した余裕幅（ティック数）を確保します。
・非同期送信（任意）により、サーバーの応答待ちの間も監視を続けます。
・応答が確定していない要求は状態ファイルに保存し、タイムアウトや端末の再起動後に照合します。結果を確認しないまま同じ注文を送り直すことはありません。
・サーバーから拒否が続いた場合は送信を停止し、理由を表示します。原因を確認したあと、入力項目「再開確認番号」の値を増やすと再開できます。
・TP/SL を設定できない理由を出力する診断ログ機能があります（任意）。
■ 使い方
1. 任意のチャート 1 つに EA を設置し、アルゴリズム取引を有効にします。
2. 管理するポジションを選びます（マジックナンバー指定・手動取引の扱い）。
3. 合計の利確目標と損切目標を設定します（金額または口座残高の％）。
4. 必要に応じて、利益保護・トレーリング・銘柄別設定を有効にします。
5. EA は 1 つの口座につき 1 つだけ稼働させてください。
設定内容は、まずデモ口座でご確認ください。
■ 主な入力項目
対象ポジション
・InpUseMagicFilter：true＝指定したマジックナンバーのみ、false＝すべて
・InpTargetMagicNumbers：マジックナンバー（カンマ区切り）
・InpManualTradeMode：手動取引（Magic = 0）の扱い
合計利確・合計損切
・InpEnableTakeProfitAll / InpEnableStopLossAll：利確・損切の有効/無効
・InpTakeProfitMode / InpStopLossMode：口座残高の％ または 金額
・InpTakeProfitPercent / InpTakeProfitAmount：利確の％・金額
・InpStopLossPercent / InpStopLossAmount：損切の％・金額
・InpEnableAutoCommonSLTP：銘柄・BUY/SELL 別の共通 TP/SL を自動設定
・InpEnableAggregateClose：全体の合計損益でも一括決済する
送信制御
・InpModifyIntervalMs、InpMaxModifyPerMinute、InpPerTicketModifySeconds：TP/SL 変更の送信間隔と上限
・InpCloseIntervalMs、InpSlippagePoints、InpStopSafetyTicks：決済の送信間隔、スリッページ、ストップレベルへの余裕
・InpMinCommonChangeTicks、InpMaxTargetDriftPercent、InpMinTPRepriceTicks：わずかな価格変更を送らないための設定
・InpUseAsyncRequests、InpSyncSLTPRequests、InpServerResumeToken：非同期送信、TP/SL の同期送信、再開確認番号
損益分岐ライン
・InpShowBreakEvenLine ほか：表示の有無、色、線の種類・太さ、ラベル、文字サイズ、更新間隔、全チャート表示
利益保護・トレーリング
・InpEnableProfitLock、InpProfitLockTriggerPercent（初期値 60）、InpProfitLockKeepPercent（初期値 5）
・InpProfitLockEntryMode：発動後の追加ポジションの扱い（価格固定 / 再計算）
・InpEnableProfitTrailing、InpProfitTrailingStepPrice、InpTrailingModifyIntervalMs
銘柄別設定
・InpUseSymbolSettings、InpAllowAggregateWithSymbolSettings
・01〜10 枠：銘柄名、利確の方法と値、損切の方法と値、利益保護、発動率、保護率、追加ポジションの扱い、トレーリング、追従幅、間隔
診断
・InpEnableDiagnosticLog、InpDiagnosticIntervalSeconds、InpUseV140ModifyCompatibility
※ EA の入力画面の表示名は英語です。
■ ご注意
・ヘッジング口座向けです。ネッティング口座では同じ銘柄の BUY と SELL を同時に保有できず、複数の EA のポジションをマジックナンバーで完全に分けることもできません。
・決済価格は保証されません。成行決済ではスリッページが発生することがあり、窓開けなどで TP/SL の価格を飛び越えて約定することがあります。
・ブローカーや口座で設定された取引制限は、この EA では解除できません。
・利益保護の割合は TP 目標に対する割合です。口座残高に対する割合ではありません。
・本商品はポジション管理ツールです。売買シグナルを出すものではなく、利益を保証するものでもありません。
