OnTradeTransaction() の使い方と書き方（MQL5）

OnTradeTransaction() とは

MT5 の EA で、注文の追加・約定（ディールの追加）・ポジションの変化などの処理が1つ行われるたびに呼ばれる関数です。何が起きたかが引数 trans に入っているため、「決済されたら通知する」などの処理を正確に書けます。

OnTradeTransaction() の書式と引数

void OnTradeTransaction(
   const MqlTradeTransaction &trans,
   const MqlTradeRequest &request,
   const MqlTradeResult &result
)

戻り値

OnTradeTransaction() の使い方（コード例）

int OnInit()
{
   return INIT_SUCCEEDED;
}

void OnTick()
{
}

// 決済の約定を検出して損益をログに出す
void OnTradeTransaction(const MqlTradeTransaction &trans, const MqlTradeRequest &request, const MqlTradeResult &result)
{
   if(trans.type != TRADE_TRANSACTION_DEAL_ADD)
      return;
   if(!HistoryDealSelect(trans.deal))
      return;
   long entry = HistoryDealGetInteger(trans.deal, DEAL_ENTRY);
   if(entry == DEAL_ENTRY_OUT)
   {
      double profit = HistoryDealGetDouble(trans.deal, DEAL_PROFIT);
      Print("決済しました：", trans.symbol, " 損益=", profit);
   }
}

MetaEditor でコンパイルできることを確認済みです。

OnTradeTransaction() の注意点

• MQL4 にはありません。
• 1回の注文でも「注文の追加」「約定」「注文の削除」など複数回呼ばれます。trans.type で必要な種類だけを処理します。
• 約定したディールの詳しい情報（損益・エントリーか決済か）は、HistoryDealSelect(trans.deal) で選んでから HistoryDealGetDouble() などで読みます。

関連する関数

• OnTrade()注文・ポジション・履歴が変化したときに呼ばれる
• HistoryDealSelect()チケット番号を指定して約定（ディール）を履歴に読み込む
• HistoryDealGetDouble()約定（ディール）の損益・価格・ロットなどを取得する
• HistoryDealGetInteger()約定（ディール）の種類・エントリー／決済・時刻などを取得する

イベント関数の関数一覧

• OnInit
• OnDeinit
• OnTick
• OnCalculate
• OnStart
• OnTimer
• OnChartEvent
• OnTrade
• OnTradeTransaction
• OnTester

← MQL関数リファレンスで、ほかの関数を探す