MQL5関数辞典｜EA・インジケーター開発で使う主要関数一覧

MQL5でEAやインジケーターを開発する場合、イベント処理、注文処理、ポジション確認、履歴確認、インジケーター連携、価格取得、ファイル操作、外部連携、チャート表示など、目的ごとに使う関数が変わります。

このページでは、EA・インジケーター開発でよく使うMQL5関数を、目的別に整理します。公式リファレンスの代わりに丸暗記するための記事ではなく、どの関数を、どの場面で使い、戻り値やログのどこを確認するかを整理するための関数辞典です。

関数名だけを見ても、原因や使い方は判断できません。たとえば、OrderSendで注文できない場合でも、原因はロット、証拠金、銘柄仕様、取引時間、type_filling、EAの発注ガード、取引サーバー側retcodeなどに分かれます。CopyBufferで値が取れない場合も、インジケーターハンドル、バッファ番号、必要本数、確定足、履歴データ、BarsCalculatedなどを合わせて確認します。

注意：この記事は、MQL5開発・EA動作確認・インジケーター連携・不具合調査のための技術解説です。特定の売買判断、推奨エントリー、推奨ロット、推奨銘柄、利益保証、勝率保証、損失回避保証、特定ブローカーへの誘導を目的としたものではありません。実運用前には、必ずデモ環境や検証環境で動作を確認してください。

MQL5関数を目的別に調べる考え方

MQL5の関数は、名前だけでなく、処理の責務ごとに分けて確認すると理解しやすくなります。

EA開発では、signal、execution、risk、exit、auth、external control、notification、UI表示、loggingを分けて考えると、関数の使いどころを整理しやすくなります。

イベント関数一覧

イベント関数は、EA・インジケーター・スクリプトの処理入口です。どのイベントで何を処理しているかを分けると、不具合調査がしやすくなります。

ログ・エラー確認関数一覧

エラー確認では、GetLastErrorだけを見ても原因を断定できません。発生関数、戻り値、直前処理、Expertsログ、Journalログ、取引サーバーretcodeを合わせて確認します。

注文・取引関数一覧

注文関数では、関数の戻り値だけでなく、取引サーバー側の結果コードを確認します。特にOrderSendやCTrade系では、送信できたことと、約定・決済が成立したことを分けて確認します。

ポジション関数一覧

現在保有中の状態を確認する時は、OrderではなくPositionを確認します。Netting口座とHedging口座では、同一シンボルのポジション管理方式が異なるため、symbol単位かticket単位かを明確にします。

注文・履歴関数一覧

MQL5では、Order、Position、Deal、Historyを分けて確認します。未約定注文を見る関数と、現在ポジションを見る関数と、過去の約定履歴を見る関数は別です。

銘柄・価格・口座情報関数一覧

発注前やリスク計算では、銘柄仕様と口座状態の確認が重要です。point、digits、tick value、volume step、stops level、filling modeを固定値で決め打ちすると、ブローカーや銘柄差で不具合が出やすくなります。

時系列・価格取得関数一覧

時系列・価格取得では、現在足と確定足を分けることが重要です。shift=0やstart_pos=0は現在形成中の足を指すため、バー確定型EAではshift=1や確定足basisを明示します。

時間関数一覧

EAの時間制御では、PC時刻、サーバー時刻、バー時刻を混同しないことが重要です。ログには、どの時刻をbasisにしているかを明示します。

インジケーター関数一覧

EAからインジケーター値を使う場合は、ハンドル作成、BarsCalculated、CopyBuffer、buffer番号、shift、IndicatorReleaseを分けて確認します。

ファイル操作関数一覧

ファイル操作では、通常のMQL5\Files、Strategy Tester側Files、FILE_COMMONの共通フォルダを混同しないことが重要です。CSVログでは、列構成、文字コード、区切り文字、出力頻度も確認します。

外部連携・WebRequest関数一覧

WebRequestや外部API連携では、MQL5コードだけでなく、MT5側の許可URL、外部サービス側の権限、HTTPステータス、VPS通信状態を確認します。Webhook URL、APIキー、GAS URL、認証トークンは本文や公開ログに入れないでください。

外部連携の確認：WebRequestはMT5側で許可URLを登録する必要があります。また、Strategy Testerやインジケーター側では利用制約があります。EA本体の判定、通知処理、外部通信処理、外部サービス側の権限は分けて確認してください。

チャートオブジェクト関数一覧

チャートオブジェクト関数は、画面表示やボタン操作に使います。表示系と判定系を混同しないことが重要です。表示用objectをEAの判定truthとして扱うと、残存objectや削除漏れで誤動作につながる可能性があります。

標準ライブラリ関数・クラス一覧

MQL5標準ライブラリを使うと、取引処理や状態確認をクラスで扱えます。ただし、CTradeを使っても、注文結果の確認が不要になるわけではありません。メソッド戻り値、ResultRetcode、ResultDeal、ResultOrder、PositionInfoの選択結果を確認します。

文字列・配列・変換系関数一覧

ログ、CSV、外部連携、設定読み込みでは、文字列・配列・変換系関数をよく使います。文字コード、区切り文字、配列サイズ、添字、空欄処理を確認します。

関数辞典の使い方

この関数辞典は、関数名を単独で覚えるためではなく、目的別に確認するために使います。

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

EA利用者がMQL5コードを直接編集しない場合でも、関数まわりの不具合調査で整理できる情報があります。

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

MQL5開発では、関数を目的別に分け、戻り値とログを必ず確認します。特に、表示系と判定系、input初期値とruntime状態、推奨値とruntime調整値を混同しないことが重要です。

開発依頼前に整理する情報

MQL5関数まわりの開発や修正を依頼する場合は、次の情報を整理しておくと原因確認が早くなります。

開発依頼前に必要な資料の整理については、次のページも確認してください。

MT5開発依頼前に用意する資料まとめ

関連する技術講座

問い合わせ前チェック表

• □ 対象EA・インジ名を確認した
• □ バージョンを確認した
• □ 対象銘柄と時間足を確認した
• □ どの機能で発生したかを整理した
• □ 関数名または該当処理を確認した
• □ Expertsログを確認した
• □ Journalログを確認した
• □ GetLastError系かTRADE_RETCODE系かを分けた
• □ Order / Position / Deal / Historyを混同していないか確認した
• □ 現在足と確定足を混同していないか確認した
• □ Webhook URL、APIキー、GAS URL、認証トークン、口座番号をマスクした
• □ setファイルを保存した
• □ 再現手順を整理した
• □ スクリーンショットを保存した

FAQ

この辞典だけでMQL5の仕様をすべて判断できますか？

いいえ。この辞典は、MQL5の主要関数を実務上確認しやすく整理した記事です。最終的な仕様確認は、公式リファレンス、MetaEditorのコンパイル結果、Expertsログ、Journalログ、実際の動作結果を合わせて確認してください。

公式リファレンスとこの記事は何が違いますか？

公式リファレンスは、関数仕様や引数を厳密に確認するための一次情報です。この記事では、EA・インジケーター開発で見落としやすい「使う場面」「戻り値」「確認するログ」「出やすいエラー」「開発依頼前に整理する情報」を中心に補足しています。

関数名だけで原因を断定できますか？

断定できない場合が多いです。たとえばOrderSendで失敗しても、原因はロット、証拠金、銘柄仕様、取引時間、type_filling、EA側ガード、取引サーバー側retcodeなどに分かれます。関数名、戻り値、GetLastError、retcode、Expertsログ、Journalログをセットで確認してください。

EA利用者でも確認すべき項目はありますか？

あります。EA名、バージョン、発生日時、銘柄、時間足、Expertsログ、Journalログ、スクリーンショット、setファイル、発生時の操作手順を整理しておくと、原因確認が早くなります。

開発依頼前にどの情報を整理すればよいですか？

対象EA・インジ名、バージョン、対象銘柄、時間足、発生した機能、エラー内容、Expertsログ、Journalログ、setファイル、再現手順、スクリーンショットを整理してください。Webhook URL、APIキー、GAS URL、認証トークン、口座番号などは必ずマスクしてください。

ExpertsログとJournalログのどちらを確認すべきですか？

両方確認するのが基本です。ExpertsログではEAやインジケーター内部の判定、関数戻り値、GetLastError、ResultRetcodeなどを確認できます。Journalログでは端末側、サーバー側、接続状態、注文処理、Strategy Tester関連の情報を確認できます。

OrderSendとCTradeはどちらを使うべきですか？

目的によります。CTradeは標準ライブラリとして扱いやすい一方、OrderSend直接実装はMqlTradeRequestやMqlTradeResultを細かく制御しやすい特徴があります。どちらを使う場合でも、戻り値、retcode、order、deal、comment、Position確認は必要です。

CopyBufferが失敗する場合は何を確認すべきですか？

iCustomや標準インジケーターのhandleが有効か、BarsCalculatedが十分か、buffer番号が正しいか、必要本数が取得できているか、現在足と確定足を混同していないかを確認してください。CopyBufferの戻り値とGetLastErrorも確認します。

WebRequest関連では何を確認すべきですか？

MT5側のWebRequest許可URL、送信先URL形式、HTTPステータス、payload、timeout、外部サービス側の権限、VPS通信状態を確認します。ただし、Webhook URL、GAS URL、APIキー、認証トークンの実値は公開ログや問い合わせ文に含めないでください。

この記事にない関数はどのように確認すればよいですか？

まず公式リファレンス、MetaEditorの補完、コンパイル結果、Expertsログ、Journalログを確認してください。EA固有の仕様が関係する場合は、対象ファイル、バージョン、設定値、該当関数、再現手順、ログを整理して確認すると原因を追いやすくなります。

開発依頼・不具合調査前の確認：関数まわりの不具合では、関数名だけで判断せず、分類、戻り値、GetLastError、ResultRetcode、対象symbol、timeframe、ticket、magic、buffer番号、保存先、HTTPステータスをセットで確認してください。

MT5開発依頼前に用意する資料まとめ

関連するMQL5技術辞典

MQL5関数は、目的別に確認すると整理しやすくなります。エラー確認、注文処理、ポジション管理、インジケーター連携、時系列取得、ファイル操作、チャート表示、標準ライブラリなど、詳しい内容は各技術辞典も確認してください。

確認ポイント：関数名だけで原因や仕様を断定せず、分類、戻り値、GetLastError、ResultRetcode、対象symbol、timeframe、ticket、magic、buffer番号、保存先、HTTPステータスをセットで確認してください。

まとめ

MQL5関数は、目的別に分けて確認すると整理しやすくなります。イベント関数、注文・ポジション・履歴関数、インジケーター関数、時系列・価格取得関数、ファイル操作関数、外部連携関数、チャートオブジェクト関数、標準ライブラリは、それぞれ確認すべき戻り値とログが異なります。

不具合調査では、関数名だけで原因を断定せず、発生場所、戻り値、GetLastError、ResultRetcode、Expertsログ、Journalログ、対象銘柄、時間足、設定値、再現手順を合わせて確認してください。

開発依頼や修正依頼を行う場合は、EA名、バージョン、setファイル、ログ、スクリーンショット、再現手順を整理し、Webhook URL、APIキー、GAS URL、認証トークン、口座番号などの機密情報は必ずマスクしてください。