MQL5インジケーター開発・EA連携完全ガイド｜iCustom・CopyBuffer・OnCalculate・SetIndexBufferの基本

MQL5でインジケーターを開発したり、既存のサインインジケーターをEAから読み取ったりする場合、OnCalculate、SetIndexBuffer、iCustom、CopyBuffer、インジケーターバッファ、shift、確定足、リペイント確認などを整理しておく必要があります。

インジケーターは、チャート上にライン、矢印、ヒストグラム、サブウィンドウ表示などを出すためのものです。一方でEAは、条件判定、注文、決済、通知、記録などを担当します。サインインジをEA化する場合は、表示されている矢印をそのまま注文条件にするのではなく、どのバッファにどの値が出ているのか、確定足で読むのか、リアルタイム足で読むのかを分けて確認する必要があります。

この記事では、MQL5インジケーターを作る側と、EAからインジケーターを読む側を分けずに、次の流れで整理します。

• インジケーターを作る
• バッファへ値を出す
• EA側でiCustomとCopyBufferを使って読む
• サインEA化、通知化、集計化へつなげる

このページは、MT5 / MQL5の技術学習記事です。投資判断、売買タイミング、利益保証、勝率保証、推奨ロット、推奨銘柄、特定ブローカー誘導を目的とした内容ではありません。

MQL5インジケーターとEA連携をまとめて学ぶ理由

MQL5インジケーター開発とEA連携は、別々に考えられがちです。

しかし、実務上はインジケーターを作るだけで終わるケースよりも、次のような相談につながることが多くあります。

• サインインジの矢印をEAで読みたい
• 既存インジケーターをMT5 EAから参照したい
• 通知対応インジケーターにしたい
• インジケーターの値をGoogle SheetsやCSVへ記録したい
• MT4インジケーターをMQL5へ作り直したい
• インジケーターのリペイント有無を確認したい

このような場合、チャート上に表示されている見た目だけでは不十分です。

EAから読むためには、インジケーター側がどのバッファへ値を出しているのか、バッファ番号は何番なのか、未確定足で値が変わるのか、CopyBufferで取得できる値が何を意味するのかを確認する必要があります。

EAとインジケーターの役割の違い

EAとインジケーターは、どちらもMQL5で作成できますが、役割が異なります。

インジケーターは、主に計算結果をチャート上へ表示したり、バッファとして値を出したりするために使います。EAは、価格更新やタイマーなどをきっかけに、条件判定、注文、決済、通知、記録などを行います。

サインインジをEA化する時は、インジケーターの表示とEAの注文処理を混同しないことが重要です。

チャートにBUY矢印が表示されることと、EAがBUY注文を出すことは別の処理です。EA化では、signal、execution、risk、exit、notificationを分けて確認します。

カスタムインジケーターの基本構造

MQL5のカスタムインジケーターは、主に次の要素で構成されます。

• インジケーターのプロパティ
• inputパラメータ
• インジケーターバッファ
• OnInitによる初期化
• OnCalculateによる計算
• OnDeinitによる終了処理

インジケーターがEAから読まれることを前提にする場合、チャート上の見た目だけでなく、バッファ設計が重要になります。

OnCalculateの役割

OnCalculateは、MQL5インジケーターの計算処理を担当するイベント関数です。

EAのOnTickが価格更新時の処理を担当するのに対し、インジケーターのOnCalculateは、チャートのデータに基づいてバッファへ値を入れる処理を行います。

OnCalculateでは、どのバーから再計算するか、未確定足を計算対象にするか、過去足の値を変更するかを設計します。

OnCalculateとOnTickの違い

OnCalculateはインジケーターの計算、OnTickはEAの価格更新処理で使います。

サインインジをEA化する時に注意したいのは、OnCalculateで表示されたサインを、EA側でどのタイミングで読むかです。未確定足のサインを読むのか、確定足のサインを読むのかで、EAの挙動は変わります。

特にサインが足の途中で出たり消えたりするインジケーターでは、EAがshift 0を読むと、バックテストとリアルタイムで見え方が変わる可能性があります。

SetIndexBufferの役割

SetIndexBufferは、インジケーターの配列をインジケーターバッファとして登録するために使います。

バッファは、チャートへ表示する値だけでなく、EAからCopyBufferで取得する値としても重要です。

バッファ番号を固定して管理する

EAからインジケーターを読む場合、バッファ番号の管理が重要です。

例えば、BUYサインがバッファ0、SELLサインがバッファ1、ライン値がバッファ2という設計の場合、EA側でも同じ番号でCopyBufferを呼び出す必要があります。

バッファ番号が変わると、EA側がBUYとSELLを逆に読む、サインがないのにあると判断する、ライン値をサイン値として扱うなどの不具合につながります。

PlotIndexSet系と描画設定の考え方

MQL5インジケーターでは、バッファへ値を入れるだけではなく、どのように表示するかを設定する必要があります。

PlotIndexSetInteger、PlotIndexSetDouble、PlotIndexSetStringなどの設定は、線の種類、矢印コード、表示名、空値などに関係します。

メインチャート表示とサブウィンドウ表示

インジケーターは、メインチャート上に表示するものと、サブウィンドウへ表示するものがあります。

メインチャート表示は、価格と重ねてラインや矢印を表示したい場合に使われます。サブウィンドウ表示は、オシレーター、強弱、スコア、状態値などを別枠で表示したい場合に使われます。

EA連携では、メインチャート表示かサブウィンドウ表示かよりも、CopyBufferで取得するバッファ値が重要です。

矢印・ライン・ヒストグラム表示の基本

インジケーターの表示形式には、矢印、ライン、ヒストグラム、ドット、塗りつぶしなどがあります。

表示形式は読者や利用者の視認性に関係しますが、EAから読む場合は見た目ではなくバッファ値を確認します。

インジケーターバッファとは何か

インジケーターバッファは、インジケーターの計算結果をバーごとに格納するための配列です。

ラインを表示する場合も、矢印を表示する場合も、EAから値を読む場合も、基本的にはバッファに入っている値が重要になります。

EA化の相談では、「チャートに矢印が出ています」だけでは不十分です。次のような情報が必要です。

• BUYサインは何番のバッファか
• SELLサインは何番のバッファか
• サインなしの時はEMPTY_VALUEか0か
• shift 0の値は変化するか
• 過去足の値が後から変わるか
• EAから読む前提のバッファがあるか

バッファ番号とshiftの考え方

CopyBufferでは、どのバッファ番号から、どの位置の値を、何本分取得するかを指定します。

この時に重要になるのが、バッファ番号とshiftです。

EAからインジケーターを読む場合は、shift 0を読むのか、shift 1を読むのかを仕様として固定してください。

「サインが出た瞬間に通知したい」のか、「確定足でサインが残った時だけ処理したい」のかで、読み方は変わります。

iCustomでカスタムインジを呼び出す考え方

iCustomは、EAや別のプログラムからカスタムインジケーターのハンドルを作成する時に使います。

iCustomで重要なのは、インジケーター名、配置場所、inputパラメータの順番と型です。

iCustomで読み込めない場合は、EA側だけでなく、インジケーター側が正しくコンパイルされているか、Indicatorsフォルダへ配置されているか、必要なincludeや依存ファイルが揃っているかを確認してください。

CopyBufferで値を取得する考え方

CopyBufferは、インジケーターのバッファ値をEA側で取得する時に使います。

CopyBufferの戻り値は、実際に取得できたデータ数です。戻り値を確認せずに配列を参照すると、データ不足や取得失敗時に誤判定につながります。

サインインジをEA化する場合は、CopyBufferで取得した値が、サインあり、サインなし、補助値、無効値のどれを意味するかを必ず整理してください。

IndicatorReleaseとハンドル管理

iCustomや標準インジケーター関数で作成したハンドルは、不要になったらIndicatorReleaseで解放する設計にします。

ハンドル管理が曖昧だと、時間足変更、チャート変更、EA再読み込み、長時間稼働時に不安定になることがあります。

確定足とリアルタイム足の違い

サインインジのEA化で特に重要なのが、確定足で読むのか、リアルタイム足で読むのかです。

shift 0は現在形成中の足であり、値が変わる可能性があります。shift 1は1本前の確定足です。

どちらが良いという話ではなく、目的に応じて決める必要があります。

通知インジであればshift 0の点灯を通知したい場合があります。一方、EA化して注文条件に使う場合は、確定足のサインを読む方が再現性を確認しやすい場合があります。

リペイント確認

リペイントとは、過去に表示されたサインやラインが後から変わることを指します。

すべての再計算が問題というわけではありませんが、EA化や検証では、過去足のサインが後から消える、移動する、別方向へ変わる場合に注意が必要です。

リペイントするインジケーターでも、用途によっては通知や確認補助として使える場合があります。ただし、EA化する場合は、どの時点の値を採用するのかを明確にする必要があります。

サインインジをEA化する前に整理すること

サインインジをEA化する場合、まずは「サインが出る」ことではなく、「EAが機械的に読める値があるか」を確認します。

EA化では、signalとexecutionを分けて考えます。

インジケーターのサインを読む部分がsignalです。注文を出す部分はexecutionです。さらに、ロット、スプレッド、時間帯、最大ポジション数、損切り、決済条件、通知条件は別責務として整理します。

通知対応インジ・集計インジへの応用

インジケーターの値は、EA化だけでなく、通知や集計にも使えます。

例えば、サインが出た時にDiscordへ通知する、一定期間のサイン回数を集計する、CSVへ記録する、Google Sheetsへ送信するなどの応用があります。

通知や外部連携を行う場合でも、通知成功と売買成功を混同しないでください。通知はnotification層であり、EAの注文処理とは別責務です。

外部連携の基本は、MT5外部連携・通知セキュリティガイドも参考にしてください。

よくあるエラーと確認ポイント

MQL5インジケーター開発やEA連携では、iCustomで読み込めない、CopyBufferで値が取れない、バッファ番号が違う、サインがEAで読めないなどの問題が出ることがあります。

エラーコードやリターンコードの整理は、MQL5エラーコード辞典も確認してください。

EA利用者向けの確認ポイント

EA利用者がサインインジEA化や通知化を相談する場合、ソースコードの詳細を理解していなくても、必要な情報を整理できます。

• どのインジケーターを使いたいか
• BUYサインとSELLサインがどのように表示されるか
• サインが出るタイミングは足の途中か、足確定後か
• 過去のサインが後から変わるか
• 通知だけしたいのか、EA注文まで行いたいのか
• 対象銘柄と時間足
• 使用しているsetファイル
• ExpertsログとJournalログ

インジケーターのソースがない場合でも、ex5からEA連携できる可能性はあります。ただし、バッファ番号や値の意味が分からない場合、確認用EAやログ取得が必要になることがあります。

MQL5開発者向けの確認ポイント

MQL5開発者は、インジケーターをEAから読む前提で作る場合、表示用バッファとEA連携用バッファを分けることを検討してください。

検証担当者向けの確認ポイント

検証担当者は、チャート上の見た目だけでなく、EAが取得しているバッファ値を確認する必要があります。

• サイン表示とCopyBuffer値が一致しているか
• shift 0とshift 1で値の出方が違うか
• 時間足変更後に値が変わるか
• MT5再起動後に過去サインが変わるか
• バックテストとリアルタイム表示に差があるか
• 通知やEA注文が同一足で重複しないか
• インジケーターのinputを変更した時にEA側も同じ設定になっているか

検証では、スクリーンショット、Expertsログ、Journalログ、setファイル、対象銘柄、時間足、発生時刻をセットで残してください。

開発依頼前に送る情報

MQL5インジケーター開発、EA連携、サインEA化、通知対応、集計対応を相談する場合は、次の情報を整理してください。

開発依頼前の資料整理は、MT5開発依頼前に用意する資料まとめも参考にしてください。

送ってはいけない情報

インジケーターやEAの相談では、ログやスクリーンショットが重要です。ただし、次の情報はそのまま送らないでください。

• 口座番号の全桁
• 投資家パスワード
• マスターパスワード
• Webhook URLの実値
• GAS URLの実値
• APIキー
• 認証トークン
• 個人情報
• 第三者の個人情報が入ったログ

問い合わせが必要な場合は、必要情報を整理したうえで、不具合報告・サポート依頼を確認してください。

MQL5インジケーター開発・EA連携チェック表

• □ インジケーター名とバージョンを確認した
• □ mq5ソースの有無を確認した
• □ ex5ファイルの有無を確認した
• □ BUYサインのバッファ番号を確認した
• □ SELLサインのバッファ番号を確認した
• □ サインなしの値がEMPTY_VALUEか0か確認した
• □ shift 0とshift 1の違いを確認した
• □ リペイントの有無を確認した
• □ iCustomで読み込めるか確認した
• □ CopyBufferの戻り値を確認した
• □ 確定足で読むかリアルタイム足で読むか整理した
• □ 通知だけかEA注文まで行うか整理した
• □ Expertsログを保存した
• □ Journalログを保存した
• □ setファイルを保存した
• □ 口座番号や認証情報をマスクした

次に読む技術講座

この講座とあわせて確認すると、MT5・MQL5開発、検証、不具合調査の流れを整理しやすくなります。

次に確認するページ

技術講座を確認した後、導入・商品確認・開発相談・不具合報告へ進む場合は、以下のページも確認してください。

よくある質問

OnCalculateとOnTickは何が違いますか？

OnCalculateはインジケーターの計算処理、OnTickはEAの価格更新処理で使います。インジケーターはOnCalculateでバッファへ値を出し、EAは必要に応じてiCustomとCopyBufferでその値を読みます。

CopyBufferで取得するshiftは何を意味しますか？

shiftは取得するバーの位置を意味します。shift 0は現在形成中の足、shift 1は1本前の確定足です。EA化では、どちらを読むかを仕様として明確にする必要があります。

サインインジはそのままEA化できますか？

場合によります。EAから読めるバッファがあり、BUY / SELLサインのバッファ番号や値の意味が確認できればEA化しやすくなります。ただし、表示だけでバッファ仕様が不明な場合は追加確認が必要です。

リペイントするインジはEA化できますか？

技術的には可能な場合がありますが、どの時点の値を採用するかを明確にする必要があります。過去足のサインが後から変わる場合、バックテストやリアルタイム運用で見え方が変わる可能性があります。

SetIndexBufferは何に使いますか？

SetIndexBufferは、インジケーターの配列をバッファとして登録するために使います。ライン表示、矢印表示、ヒストグラム表示、EA連携用の値出力などに関係します。

iCustomで読み込めない時は何を確認しますか？

インジケーター名、ファイル配置、ex5生成、inputの順番、inputの型、必要なincludeや依存ファイル、INVALID_HANDLEの有無、GetLastErrorを確認してください。

インジケーターのソースがない場合でもEA化できますか？

ex5からiCustomとCopyBufferで値を取得できる場合は、EA連携できる可能性があります。ただし、バッファ番号や値の意味が不明な場合は、確認用ログや調査が必要です。

矢印が見えているのにEAでサインが読めないのはなぜですか？

矢印表示とEAが読むバッファ値が一致していない可能性があります。バッファ番号、EMPTY_VALUE、shift、CopyBufferの戻り値、表示用オブジェクトかバッファ描画かを確認してください。

通知対応インジとEA化は同じですか？

同じではありません。通知対応インジはサインや状態を通知する機能であり、EA化は注文や決済などのexecution層を含む場合があります。通知成功と売買成功は分けて確認します。

EA化前に最低限必要な情報は何ですか？

対象インジケーター名、バージョン、mq5またはex5の有無、BUY / SELLバッファ番号、サインなしの値、shift 0 / 1の扱い、リペイント有無、対象銘柄、時間足、setファイル、ログが必要です。

まとめ

MQL5インジケーター開発とEA連携では、チャート上の見た目だけでなく、バッファ設計、OnCalculate、SetIndexBuffer、iCustom、CopyBuffer、shift、確定足、リペイント確認を整理することが重要です。

インジケーターは、ライン、矢印、ヒストグラム、状態値などを表示・出力する側です。EAは、必要に応じてその値を読み、signal、execution、risk、exit、notificationなどの責務に分けて処理します。

サインインジをEA化する場合は、BUY / SELLのバッファ番号、サインなしの値、shift 0とshift 1の違い、過去足の値が変わるかどうかを必ず確認してください。

通知対応やGoogle Sheets連携、CSV記録へ応用する場合も、Webhook URL、GAS URL、APIキー、認証トークン、口座番号などの実値は共有しないようにしてください。

開発や改修を相談する場合は、対象インジケーター、バージョン、対象銘柄、時間足、setファイル、Expertsログ、Journalログ、スクリーンショットを整理しておくと、確認が進めやすくなります。

MT4/MT5 技術講座へ戻る