MQL5 OnTradeTransactionで約定を追跡する方法

MQL5でEAの注文、約定、決済、履歴追加を追跡したい場合は、OnTradeTransactionの確認が重要です。

OnTradeTransactionは、取引口座で発生した注文追加、注文更新、約定追加、履歴追加、ポジション変化などのトランザクションを受け取るイベント関数です。

OrderSendの戻り値だけを見ていると、注文要求を送った結果は確認できても、その後の約定、部分約定、決済、履歴反映、コピーEA同期用のイベントを追い切れない場合があります。

このページでは、MQL5のOnTradeTransactionで約定を追跡する方法を、注文・約定・ポジションの違い、transaction / request / resultの見方、約定ログ、決済イベント、コピーEAでの活用、重複記録防止の観点から整理します。

なお、このページはMQL5開発における技術確認を目的とした内容です。売買判断、推奨エントリー、推奨ロット、利益保証、損失回避保証を行うものではありません。

OnTradeTransactionとは何か

OnTradeTransactionは、取引トランザクションが発生した時にEA側で呼ばれるイベント関数です。

EAでは、注文を出した瞬間だけでなく、注文が追加された、約定が追加された、履歴に移動した、ポジションが変化した、といった複数の段階を確認する必要があります。

void OnTradeTransaction(const MqlTradeTransaction &trans,
                        const MqlTradeRequest &request,
                        const MqlTradeResult &result)
{
   PrintFormat("[TRADE_TRANSACTION] type=%d order=%I64u deal=%I64u position=%I64u symbol=%s price=%.5f volume=%.2f",
               trans.type,
               trans.order,
               trans.deal,
               trans.position,
               trans.symbol,
               trans.price,
               trans.volume);
}

OnTradeTransactionでは、まずtrans.typeを見て、どの種類の取引イベントなのかを分けます。

注文・約定・ポジションの違い

OnTradeTransactionを正しく使うには、Order、Deal、Positionの違いを分けて考える必要があります。

EAの検証ログでは、「注文を出した」ことと「約定した」ことを混同しないようにしてください。

主なTrade Transactionタイプ

OnTradeTransactionでは、trans.typeに応じて処理を分けます。

すべてのtypeで同じ情報が入るわけではないため、約定追跡では、特にDEAL追加系、ORDER履歴移動系、REQUEST系を分けてログ化します。

約定ログやコピーEA同期では、TRADE_TRANSACTION_DEAL_ADDを中心に確認すると整理しやすくなります。

transaction / request / resultの見方

OnTradeTransactionには、trans、request、resultの3つが渡されます。

ただし、requestとresultは常に有効な情報として使えるわけではありません。取引リクエストの処理結果を見る場合はTRADE_TRANSACTION_REQUESTを確認し、約定そのものを見る場合はtrans.dealから履歴情報を取得する流れに分けます。

ログでは、REQUEST結果とDEAL追加を別イベントとして記録してください。

約定追加を検出する基本コード

実際の約定を追跡する場合は、TRADE_TRANSACTION_DEAL_ADDを検出し、trans.dealを使って履歴からDeal情報を取得します。

void OnTradeTransaction(const MqlTradeTransaction &trans,
                        const MqlTradeRequest &request,
                        const MqlTradeResult &result)
{
   if(trans.type == TRADE_TRANSACTION_REQUEST)
   {
      PrintFormat("[TRADE_REQUEST_RESULT] retcode=%u deal=%I64u order=%I64u comment=%s request_id=%u",
                  result.retcode,
                  result.deal,
                  result.order,
                  result.comment,
                  result.request_id);
      return;
   }

   if(trans.type != TRADE_TRANSACTION_DEAL_ADD)
      return;

   ulong deal_ticket = trans.deal;

   if(deal_ticket == 0)
   {
      Print("[DEAL_ADD_SKIP] reason=deal_ticket_zero");
      return;
   }

   if(!HistoryDealSelect(deal_ticket))
   {
      PrintFormat("[DEAL_SELECT_NG] deal=%I64u last_error=%d",
                  deal_ticket,
                  GetLastError());
      return;
   }

   string symbol = HistoryDealGetString(deal_ticket, DEAL_SYMBOL);
   long magic    = HistoryDealGetInteger(deal_ticket, DEAL_MAGIC);
   long entry    = HistoryDealGetInteger(deal_ticket, DEAL_ENTRY);
   long type     = HistoryDealGetInteger(deal_ticket, DEAL_TYPE);
   double volume = HistoryDealGetDouble(deal_ticket, DEAL_VOLUME);
   double price  = HistoryDealGetDouble(deal_ticket, DEAL_PRICE);
   double profit = HistoryDealGetDouble(deal_ticket, DEAL_PROFIT);
   datetime time = (datetime)HistoryDealGetInteger(deal_ticket, DEAL_TIME);

   PrintFormat("[DEAL_ADD] deal=%I64u symbol=%s magic=%d entry=%d type=%d volume=%.2f price=%.5f profit=%.2f time=%s",
               deal_ticket,
               symbol,
               (int)magic,
               (int)entry,
               (int)type,
               volume,
               price,
               profit,
               TimeToString(time, TIME_DATE|TIME_SECONDS));
}

約定追跡では、trans.dealだけをログに出すのではなく、HistoryDealSelect後にDealの詳細を取得して記録します。

約定ログで残したい項目

約定ログは、あとから検証、コピーEA同期、決済漏れ調査、重複記録防止に使える形で残します。

コピーEAや運用記録ツールでは、deal、symbol、magic、entry、type、volume、price、timeを必ず確認できる形にしておくと、あとから同期差分を追いやすくなります。

新規約定と決済約定を分ける

Dealには、エントリー種別があります。

新規建てなのか、決済なのか、反転なのかを分けることで、EAの履歴集計やコピーEAの同期処理を整理できます。

string DealEntryToText(const long entry)
{
   if(entry == DEAL_ENTRY_IN)
      return "IN";

   if(entry == DEAL_ENTRY_OUT)
      return "OUT";

   if(entry == DEAL_ENTRY_INOUT)
      return "INOUT";

   if(entry == DEAL_ENTRY_OUT_BY)
      return "OUT_BY";

   return "UNKNOWN";
}

void PrintDealEntryLog(const ulong deal_ticket)
{
   if(!HistoryDealSelect(deal_ticket))
      return;

   long entry = HistoryDealGetInteger(deal_ticket, DEAL_ENTRY);
   string symbol = HistoryDealGetString(deal_ticket, DEAL_SYMBOL);
   double volume = HistoryDealGetDouble(deal_ticket, DEAL_VOLUME);
   double profit = HistoryDealGetDouble(deal_ticket, DEAL_PROFIT);

   PrintFormat("[DEAL_ENTRY] deal=%I64u symbol=%s entry=%s volume=%.2f profit=%.2f",
               deal_ticket,
               symbol,
               DealEntryToText(entry),
               volume,
               profit);
}

決済イベントだけを追跡したい場合は、DEAL_ENTRY_OUTやDEAL_ENTRY_INOUTを条件にして、決済ログ、履歴CSV、コピー先決済処理へつなげます。

決済イベント追跡の考え方

EAの決済を検証する時は、OrderSendで決済要求を送ったログだけでなく、実際に決済Dealが追加されたかを確認します。

決済要求を送ったが決済Dealが出ていない場合、約定拒否、価格変動、部分約定、サーバー側の処理待ちなどを切り分ける必要があります。

決済処理では、要求ログと約定ログを分けておくと、EAが要求を出していないのか、要求後に約定していないのか、約定後の記録だけが失敗したのかを確認できます。

コピーEAでの活用

コピーEAでは、コピー元口座で発生した約定イベントを検出し、コピー先へ反映する必要があります。

OnTradeTransactionのDEAL_ADDを使うと、コピー元で新規約定や決済約定が発生したタイミングを検出しやすくなります。

コピーEAでは、約定イベントをそのまま注文処理へ直結せず、対象symbol、対象magic、対象entry、重複処理済みdealかどうかを確認してからコピー処理へ渡す設計が安全です。

重複記録防止

OnTradeTransactionでは、同じDealをCSV、履歴配列、外部ファイル、コピーキューへ記録する場合があります。

この時、同じdeal ticketを二重に処理しないように、処理済みDealを記録しておく必要があります。

ulong g_processed_deals[];

bool IsProcessedDeal(const ulong deal_ticket)
{
   for(int i = 0; i < ArraySize(g_processed_deals); i++)
   {
      if(g_processed_deals[i] == deal_ticket)
         return true;
   }

   return false;
}

void MarkProcessedDeal(const ulong deal_ticket)
{
   int size = ArraySize(g_processed_deals);
   ArrayResize(g_processed_deals, size + 1);
   g_processed_deals[size] = deal_ticket;
}

bool CanProcessDealOnce(const ulong deal_ticket)
{
   if(deal_ticket == 0)
      return false;

   if(IsProcessedDeal(deal_ticket))
   {
      PrintFormat("[DEAL_DUP_SKIP] deal=%I64u reason=already_processed", deal_ticket);
      return false;
   }

   MarkProcessedDeal(deal_ticket);
   return true;
}

長時間稼働EAでは、処理済みDeal配列が増え続けないように、保持件数の上限、日付単位の整理、CSV記録済み判定などを設計してください。

履歴CSVへ記録する時の考え方

運用記録や検証補助では、約定DealをCSVへ記録することがあります。

CSV記録では、同じDealを二重に書かないこと、必要な項目を固定列で残すこと、機密情報や不要な個人情報を混ぜないことが重要です。

CSVへ出力する場合は、Webhook URL、APIキー、認証トークン、口座番号などの実値を混入させないようにしてください。

ログ出力例

約定追跡のログは、REQUEST結果、DEAL追加、決済種別、重複防止を分けると確認しやすくなります。

[TRADE_REQUEST_RESULT] retcode=10009 deal=123456789 order=987654321 comment=Request executed request_id=15
[DEAL_ADD] deal=123456789 symbol=GOLD magic=24014 entry=IN type=BUY volume=0.10 price=2350.12 profit=0.00 time=2026.05.26 10:15:04
[DEAL_ADD] deal=123456790 symbol=GOLD magic=24014 entry=OUT type=SELL volume=0.10 price=2353.12 profit=30.00 time=2026.05.26 11:22:31
[HISTORY_DEAL_LOGGED] deal=123456790 entry=OUT profit=30.00
[DEAL_DUP_SKIP] deal=123456790 reason=already_processed

この形式でログを残すと、注文要求、実約定、決済、履歴記録、重複スキップを分けて確認できます。

OnTradeTransaction実装時の注意点

OnTradeTransactionは便利ですが、重い処理を直接詰め込みすぎると、ログ過多や処理遅延の原因になります。

OnTradeTransactionは、約定追跡の入口として使い、重い集計、外部送信、CSV整形、コピーキュー処理は必要に応じて別関数やOnTimerへ分けると安定しやすくなります。

OnTradeTransactionとあわせて確認したいイベント設計

OnTradeTransactionで約定や決済を追跡する場合は、イベント構造、OrderSend結果ログ、重複記録防止を分けて確認しておくと、約定後の状態反映を追いやすくなります。

関連ページ

OnTradeTransactionは、注文・ポジション・履歴、標準ライブラリ、注文関数、コピーEA、ログ確認と合わせて確認すると理解しやすくなります。

イベント処理と注文結果ログを確認する場合

OnTradeTransactionは、注文送信後のorder、deal、position、決済、部分約定、注文変更などを追跡するために使うイベント関数です。イベント処理全体の役割分担や、OrderSend直後の結果ログとあわせて確認したい場合は、関連する親記事も確認してください。

注文処理の確認では、OrderSendの戻り値だけで完了判定せず、OrderSend結果、OnTradeTransaction、HistoryDeal、Position情報を分けて確認してください。コピーEAや複数ロジックEAでは、Magic Number、symbol、ticket、deal、positionの対応関係もログで追跡できるようにします。

開発依頼前に整理したい情報

OnTradeTransactionを使った約定追跡、履歴CSV、コピーEA同期、決済ログを相談する場合は、次の情報を整理しておくと確認が進めやすくなります。

約定追跡の不具合を相談する場合は、OrderSendログだけでなく、OnTradeTransactionで出ているDEAL_ADD、REQUEST、HistoryDealGet系のログも合わせて確認してください。

MT4/MT5の開発・改修相談はこちら

まとめ

OnTradeTransactionは、MQL5 EAで注文、約定、決済、履歴追加、ポジション変化を追跡するための重要なイベント関数です。

約定追跡では、TRADE_TRANSACTION_DEAL_ADDを検出し、trans.dealからHistoryDealSelect、HistoryDealGetInteger、HistoryDealGetDouble、HistoryDealGetStringを使ってDeal情報を取得します。

REQUEST結果、注文ticket、Deal ticket、Position ticket、Magic Number、DEAL_ENTRY、DEAL_TYPE、volume、price、profitを分けてログ化すると、EA検証、決済ログ、コピーEA同期、履歴CSV、重複記録防止に使いやすくなります。

OnTradeTransactionには重い処理を詰め込みすぎず、約定検出、重複確認、必要情報の記録に役割を絞ると、長時間稼働やコピーEA同期でも確認しやすい構造になります。