MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のOnTradeとOnTradeTransaction、一覧の変化をまとめて確かめる簡単さと取引の段階ごとに受け取る細かさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のOnTradeとOnTradeTransaction、一覧の変化をまとめて確かめる簡単さと取引の段階ごとに受け取る細かさどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のOnTradeとOnTradeTransactionの比較

この記事を開いてくださったこと、心から感謝しています。MQL5で注文や取引の変化を知りたいとき、OnTradeとOnTradeTransactionのどちらを使えばよいか迷った人も多いはずです。

結論から言うと、注文や約定の数が変わったことをまとめて確かめたいならOnTrade、取引の段階ごとの中身まで受け取りたいならOnTradeTransactionが向いています。

ただし、ストラテジーテスターで呼ばれるかどうかは、確認した公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明と2つの公式の例をもとに、2つの関数の役割・受け取れる情報・仮の流れ・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のOnTradeとOnTradeTransactionの違いをまとめたインフォグラフィック
目次

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を呼ぶ必要があります。公式の例でも、履歴の期間を決めて読み込んでから、件数を調べています。

  • 履歴を読む前に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のときだけです。ほかの種類のときに、これらの中身がどうなっているかは、確認したページに記載なしでした。

  • 中身が入るのは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つの関数が呼ばれるかは、確認したページに記載なしです。

OnTradeは件数の変化で知らせてくれるので、書く量が少なくて、安心して試せました。
OnTradeTransactionは種類ごとに届くと分かって、頭が整理できました。段階が見えてうれしいです。
Kenichi
Kenichi
届く順番は保証されないと知って、順番に頼らない書き方に変えました。先に調べておいてよかったです。
2つを見比べたら、使い分けが整理されて、落ち着いてコードを書けるようになりました。

ログに、種類・注文の番号・受け取った時刻を並べて出しておくと、順番のずれにも、あとから落ち着いて気づけます。

  • デモ口座で小さな注文を出す
  • 種類と番号と時刻をログに出す

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

ストラテジーテスターでも、呼ばれるのか?

確認した公式ページには、ストラテジーテスターでの扱いについて、説明がありませんでした。テスターで動かす場合は、実際に呼ばれるかどうかを、自分で確かめましょう。

  • テスターでの扱いは記載なし
  • 自分の環境で確かめる

注文を出した関数は、いつ戻ってくるのか?

確認した公式ページには、注文を出した関数が、取引の通知より先に戻るのか、あとに戻るのかの説明が、ありませんでした。そのため、戻る順番に頼らない書き方が安心です。

  • 戻るタイミングは記載なし
  • 順番に頼らない書き方にする

この記事の例は、実際の結果なのか?

いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。

  • 仮の前提による例
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のOnTradeとOnTradeTransaction、一覧の変化をまとめて確かめる簡単さと取引の段階ごとに受け取る細かさどっちを選ぶ?」

変化に気づければよいならOnTrade、取引の段階ごとの中身を受け取りたいならOnTradeTransactionが向いています。どちらでも、届く順番や回数に頼らない書き方を心がけましょう。

  • 気づくだけならOnTrade
  • 中身までならOnTradeTransaction
  • 順番や回数に頼らない

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(OnTrade)
  • MQL5 リファレンス(OnTradeTransaction)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のOnTester、TesterStatisticsの統計をそのまま返す分かりやすさと自前で計算した基準を返す自由さどっちを選ぶ?
  • MQL5のOnInitの戻り値、INIT_FAILEDで止める確実さとINIT_PARAMETERS_INCORRECTで入力だけ除外する細やかさどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次