この記事を開いてくださったこと、心から感謝しています。MQL5で注文や取引の変化を知りたいとき、OnTradeとOnTradeTransactionのどちらを使えばよいか迷った人も多いはずです。
結論から言うと、注文や約定の数が変わったことをまとめて確かめたいならOnTrade、取引の段階ごとの中身まで受け取りたいならOnTradeTransactionが向いています。
ただし、ストラテジーテスターで呼ばれるかどうかは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明と2つの公式の例をもとに、2つの関数の役割・受け取れる情報・仮の流れ・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
OnTradeとOnTradeTransactionは、そもそも何が違うのか?
まずは、公式リファレンスで説明されている、2つの関数の形と役割を整理します。
OnTradeは、一覧が変わったことを知らせる
MQL5公式リファレンスによると、OnTradeは戻り値のない関数で、EAでだけ使えます。有効な注文・ポジション・約定・履歴のどれかが変わったときに、サーバーから端末へ届く「Trade」のイベントで呼ばれます。
自分が送った注文だけでなく、逆指値の発動やサーバー側の処理でも、イベントが届きます。インジケーターやスクリプトに同じ名前の関数を書いても、呼ばれることはありません。
- 戻り値はない
- EAでだけ使える
- 自分の注文以外の変化でも呼ばれる
OnTradeTransactionは、取引の段階ごとに呼ばれる
OnTradeTransactionは、取引の内容を表すtrans、送った注文の内容を表すrequest、その結果を表すresultの3つを受け取る関数です。公式リファレンスによると、注文を送ったとき、画面から手動で注文したとき、逆指値の発動、サーバー側の処理で呼ばれます。
たとえば買い注文を1つ出すと、注文の受け付け、注文の作成、約定、有効な注文からの削除、履歴への追加、ポジションの作成が、それぞれ別の取引として届きます。
- 3つの引数を受け取る
- 段階ごとに別の呼び出しになる
- 手動の注文でも呼ばれる
2つの関数を、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | OnTrade | OnTradeTransaction |
|---|---|---|
| 受け取る引数 | なし | trans・request・result |
| 分かること | 一覧が変わったこと | 変化の種類と中身 |
| 履歴の読み取り | HistorySelectが先に必要 | 取引の中身を直接読める |
| 公式の例 | 件数の変化を表示 | 取引の種類ごとに表示 |
※公式の例をもとにした、筆者の整理です。
OnTradeで確かめると、どうなるのか?
次に、一覧の変化をまとめて確かめる1つ目の方法を見ていきます。
公式の例は、4つの件数を見比べている
公式のOnTrade_Sample.mq5では、有効な注文・ポジション・履歴の約定・履歴の注文の件数を、覚えておきます。OnTradeが呼ばれるたびに、現在の件数と見比べて、変わったものを表示します。
この例が見ているのは件数だけで、1件ずつの注文や約定の中身までは調べていません。そのため、何が増えたのかは分かっても、どの注文なのかは別に調べる必要があります。
- 4つの件数を覚えておく
- 呼ばれるたびに見比べる
- 1件ずつの中身は見ていない
履歴を読むには、先にHistorySelectを呼ぶ
公式ページによると、注文や約定の履歴を読むときは、先にHistorySelectを呼ぶ必要があります。公式の例でも、履歴の期間を決めて読み込んでから、件数を調べています。
1回の注文が、1回の呼び出しとは限らない
公式ページには、1つの注文が1回のTradeイベントになると思い込まないように、という注意があります。処理が段階に分かれるため、1つの注文から複数のイベントが起きることもあります。
たとえば、注文を1つ出したあとに、OnTradeが2回呼ばれることもありえます。そのため、呼ばれた回数を数えて、注文の数だと考えるのは避けましょう。
- 1注文が1回とは限らない
- 複数のイベントが起きることもある
- 回数を注文の数とみなさない
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
OnTradeTransactionで受け取ると、どうなるのか?
続いて、段階ごとの中身まで受け取る2つ目の方法を見ていきます。
取引の種類は、transのtypeで見分ける
公式リファレンスによると、transのtypeには、注文の追加・更新・削除、約定の追加・更新・削除、履歴の追加・更新・削除、ポジションの変化、注文の処理結果の到着、などの種類があります。公式の例では、このtypeでswitchを書き分けています。
| type | 意味 |
|---|---|
| ORDER_ADD | 有効な注文の追加 |
| DEAL_ADD | 履歴への約定の追加 |
| HISTORY_ADD | 注文が履歴へ移った |
| REQUEST | 注文の処理結果が届いた |
※公式の説明から、筆者が一部を抜き出して整理しました。
requestとresultが入るのは、REQUESTのときだけ
公式ページによると、requestとresultの中身が入るのは、typeがTRADE_TRANSACTION_REQUESTのときだけです。ほかの種類のときに、これらの中身がどうなっているかは、確認したページに記載なしでした。
届く順番は、保証されていない
公式ページには、取引が端末に届く順番は保証されない、と書かれています。ある種類のあとに別の種類が必ず届く、と決めつけた書き方は避けましょう。
また、処理をしている間にも、口座の状態は変わりえます。たとえば、追加の通知を処理している間に、その注文が約定し、削除され、履歴へ移ることもあります。
- 届く順番は保証されない
- 処理中も口座の状態は変わる
- 種類を決めつけない
キューは1024件で、遅いと上書きされる
公式ページによると、取引のキューは1024件です。処理が遅いと、古い取引が新しいものに置き換えられることがあります。ただし、置き換えられたときに通知があるのかは、確認したページに記載なしでした。
- キューは1024件
- 処理が遅いと置き換えられる
- 通知の有無は記載なし
仮の流れで比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの関数が受け取る様子を比べます。
例の前提を、そろえる
買い注文を1つ出して、約定し、ポジションができるまでを考えます。取引の段階は、全部で6つに分かれると仮定します。
- 買い注文を1つ出す
- 取引の段階は6つと仮定する
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
OnTradeTransactionなら、6つの段階を順に受け取る
OnTradeTransactionでは、仮の6つの段階が、それぞれ別の呼び出しとして届きます。ただし、順番は保証されないため、届いた順で意味を決めない書き方にする必要があります。
- 6つの段階を別々に受け取る
- 順番は保証されない
OnTradeなら、変化のあとにまとめて知る
OnTradeは、公式ページによると、対応するOnTradeTransactionの呼び出しのあとに呼ばれます。呼び出しの回数は、一致するとは限りません。1回のOnTradeが、1回または複数回のOnTradeTransactionに対応します。
| 流れ(仮) | OnTrade | OnTradeTransaction |
|---|---|---|
| 注文の受け付け | 件数が変わったら知る | 段階として届く |
| 約定 | 件数が変わったら知る | 段階として届く |
| ポジションの作成 | 件数が変わったら知る | 段階として届く |
※仮の流れにもとづく、筆者の例です。実際の動きは、公式の最新情報で確かめてください。
どう使い分ければよいのか?
2つの特徴をふまえて、目的別の使い分けを考えます。
変化に気づければよいなら、OnTradeが向いている
注文や約定の数が変わったことに気づければよいなら、OnTradeが向いています。注文を送る側の書き方は、CTradeとOrderSendの比較記事で整理しています。
また、動かす頻度の考え方は、OnTickとOnTimerの比較記事で整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
中身を知りたいなら、OnTradeTransactionが向いている
約定した価格や、注文の状態、処理結果のコードまで知りたいなら、OnTradeTransactionが向いています。公式の例でも、約定のときに、約定の番号や数量を表示しています。
そのぶん、書くコードは増えます。段階ごとの中身を、自分で読み分ける必要があるためです。まずは、読み取りたい種類を絞って、少しずつ増やしていくと迷いにくくなります。
- 注文や約定の中身を知りたい
- 処理結果のコードを見たい
- 段階ごとに処理を分けたい
小さく試して、動きを確かめる
いきなり実際の口座で試さず、デモ口座で、小さな注文を出して、ログに出る順番を見てみましょう。ただし、ストラテジーテスターで2つの関数が呼ばれるかは、確認したページに記載なしです。









ログに、種類・注文の番号・受け取った時刻を並べて出しておくと、順番のずれにも、あとから落ち着いて気づけます。
- デモ口座で小さな注文を出す
- 種類と番号と時刻をログに出す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ストラテジーテスターでも、呼ばれるのか?
確認した公式ページには、ストラテジーテスターでの扱いについて、説明がありませんでした。テスターで動かす場合は、実際に呼ばれるかどうかを、自分で確かめましょう。
注文を出した関数は、いつ戻ってくるのか?
確認した公式ページには、注文を出した関数が、取引の通知より先に戻るのか、あとに戻るのかの説明が、ありませんでした。そのため、戻る順番に頼らない書き方が安心です。
- 戻るタイミングは記載なし
- 順番に頼らない書き方にする
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のOnTradeとOnTradeTransaction、一覧の変化をまとめて確かめる簡単さと取引の段階ごとに受け取る細かさどっちを選ぶ?」
変化に気づければよいならOnTrade、取引の段階ごとの中身を受け取りたいならOnTradeTransactionが向いています。どちらでも、届く順番や回数に頼らない書き方を心がけましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










