MQL5列挙型・定数辞典｜ENUM_ORDER_TYPE・ENUM_TIMEFRAMES・ORDER_FILLINGの基本

MQL5でEAやインジケーターを開発する場合、列挙型や定数を正しく理解していないと、注文種別、時間足、ポジション種別、約定種別、銘柄仕様、口座情報、取引リクエストの指定を誤りやすくなります。

特に、ENUM_TIMEFRAMES、ENUM_ORDER_TYPE、ENUM_POSITION_TYPE、ENUM_DEAL_TYPE、ENUM_ORDER_STATE、ENUM_SYMBOL_INFO_DOUBLE、ENUM_SYMBOL_INFO_INTEGER、ENUM_ACCOUNT_INFO_DOUBLE、ENUM_TRADE_REQUEST_ACTIONS、ORDER_FILLING_FOK / IOC / RETURN は、EA開発や不具合調査で頻繁に確認する項目です。

この記事では、MQL5の列挙型・定数を、EA開発や不具合調査で確認しやすい辞典形式で整理します。公式リファレンスの代わりに丸暗記するためではなく、どの定数を、どの場面で使い、どの関数・ログ・エラーと照合するかを整理するための記事です。

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

MQL5の列挙型・定数の全体像

MQL5では、時間足、注文種別、ポジション種別、約定種別、注文状態、銘柄情報、口座情報、取引リクエスト種別などを、列挙型や定数で指定します。

列挙型や定数は、単なる文字列ではありません。関数へ渡す値、構造体へ設定する値、ログで確認する値、履歴から読み取る値として使われます。意味を取り違えると、注文が通らない、ポジションを正しく選択できない、履歴集計がズレる、SymbolInfo系の値を誤読する、といった問題が起きます。

ENUM_TIMEFRAMES

ENUM_TIMEFRAMESは、MQL5で時間足を指定するための列挙型です。チャート時間足、価格取得、インジケーターハンドル作成、マルチタイムフレーム判定で使います。

ENUM_TIMEFRAMESで確認すること

ENUM_ORDER_TYPE

ENUM_ORDER_TYPEは、注文種別を表す列挙型です。MqlTradeRequest.type、OrderGetInteger、HistoryOrderGetIntegerなどで使います。

注文種別で確認すること

ENUM_POSITION_TYPE

ENUM_POSITION_TYPEは、現在保有中のポジション方向を表します。PositionGetIntegerでPOSITION_TYPEを取得すると、BUYポジションかSELLポジションかを確認できます。

ENUM_DEAL_TYPE

ENUM_DEAL_TYPEは、履歴上の約定種別を表します。HistoryDealGetIntegerでDEAL_TYPEを取得し、BUY約定、SELL約定、残高操作、手数料などを区別します。

DEAL_TYPEとDEAL_ENTRYは分けて確認する

Deal履歴を集計する時は、DEAL_TYPEだけで新規・決済を判断しないようにします。DEAL_ENTRYも合わせて確認することで、IN、OUT、INOUTなどの区別がしやすくなります。

ENUM_ORDER_STATE

ENUM_ORDER_STATEは、注文状態を表す列挙型です。現在注文や履歴注文を確認する時に、注文が配置済み、約定済み、取消済み、拒否済みなどを確認できます。

ENUM_SYMBOL_INFO_DOUBLE

ENUM_SYMBOL_INFO_DOUBLEは、SymbolInfoDoubleで取得するdouble系の銘柄情報を指定するための列挙型です。価格、point、tick value、ロット条件などの確認に使います。

ENUM_SYMBOL_INFO_INTEGER

ENUM_SYMBOL_INFO_INTEGERは、SymbolInfoIntegerで取得する整数系の銘柄情報を指定するための列挙型です。digits、spread、取引モード、StopsLevel、FreezeLevel、filling方式などを確認します。

ENUM_ACCOUNT_INFO_DOUBLE

ENUM_ACCOUNT_INFO_DOUBLEは、AccountInfoDoubleで取得するdouble系の口座情報を指定するための列挙型です。残高、有効証拠金、余剰証拠金、証拠金維持率などを確認します。

ENUM_TRADE_REQUEST_ACTIONS

ENUM_TRADE_REQUEST_ACTIONSは、MqlTradeRequest.actionへ設定する取引操作種別です。新規成行、pending order、SL/TP変更、注文削除など、何を行うリクエストなのかを指定します。

ORDER_FILLING_FOK / IOC / RETURN

ORDER_FILLING系は、注文の約定方式を指定する定数です。銘柄仕様と合っていないfilling方式を指定すると、TRADE_RETCODE_INVALID_FILLなどの原因になります。

定数を使う時の注意

MQL5の列挙型・定数は、関数や構造体の文脈に合わせて使います。同じBUYやSELLに見える値でも、Order、Position、Dealでは意味や取得場所が異なります。

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

EAが注文しない、決済しない、サインと違う動きをする、ログにINVALID_FILLやINVALID_VOLUMEが出る場合は、列挙型や定数の指定、銘柄仕様、注文種別、時間足指定が関係していることがあります。

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

MQL5開発では、enumや定数をその場の数値として扱わず、どの関数・構造体・履歴項目に対応する値なのかを明確にします。

実装時の注意点

• enumや定数を数値だけでログに出さず、意味が分かる文言も併記する
• Order、Position、Deal、Historyで使う定数を混同しない
• request.actionとrequest.typeを分けて確認する
• DEAL_TYPEとDEAL_ENTRYをセットで確認する
• SymbolInfoDoubleとSymbolInfoIntegerをプロパティ型に合わせて使う
• ACCOUNT_BALANCEとACCOUNT_EQUITYを混同しない
• ORDER_FILLINGはSYMBOL_FILLING_MODEと照合する
• ENUM_TIMEFRAMESはCopyTimeやbar timeとセットで確認する
• 定数指定ミスと取引サーバー拒否をログで分ける
• 未対応銘柄仕様やブローカー差をSymbolInfo系ログで確認する

列挙型・定数の辞典表

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

列挙型・定数、注文種別、時間足、銘柄仕様、口座情報まわりの不具合調査や改修依頼を行う場合は、次の情報を整理してください。

送ってはいけない情報：口座パスワード、投資家パスワード、Webhook URL、GAS URL、APIキー、認証トークン、口座番号の全桁、個人情報は、そのまま送らないでください。必要に応じて必ずマスクしてください。

関連するMQL5技術辞典

列挙型・定数の確認では、関数全体、エラーコード、注文処理、ポジション・履歴、インジケーター、時系列取得、ファイル操作、チャートオブジェクト、標準ライブラリの理解も関係します。関連するMQL5技術辞典もあわせて確認してください。

確認ポイント：列挙型・定数では、Order、Position、Deal、History、SymbolInfo、AccountInfo、TradeRequestのどこで使う値なのかを分けて確認してください。似た名前でも、確認対象が異なる場合があります。

関連する技術講座

FAQ

ENUM_TIMEFRAMESは何に使いますか？

価格取得、インジケーターハンドル作成、マルチタイムフレーム判定、時間足指定に使います。PERIOD_CURRENTを使う場合は、チャート時間足に依存する点に注意してください。

ENUM_ORDER_TYPEとENUM_POSITION_TYPEは何が違いますか？

ENUM_ORDER_TYPEは注文種別、ENUM_POSITION_TYPEは現在保有中ポジションの方向です。Order、Position、Deal、Historyは確認対象が異なるため、同じBUY / SELLでも文脈を分けて確認します。

DEAL_TYPE_BUYなら新規買いですか？

必ずしもそうとは限りません。Deal履歴では、DEAL_TYPEとDEAL_ENTRYを合わせて確認してください。新規、決済、反転などの区別にはDEAL_ENTRYも重要です。

SymbolInfoDoubleとSymbolInfoIntegerはどう使い分けますか？

double系プロパティはSymbolInfoDouble、integer系プロパティはSymbolInfoIntegerで取得します。Bid、Ask、Point、VolumeStepなどはdouble系、Digits、Spread、StopsLevel、FillingModeなどはinteger系として確認することが多いです。

ORDER_FILLING_FOK / IOC / RETURNは何を確認しますか？

注文の約定方式を指定するために使います。銘柄側が対応していない方式を指定すると、INVALID_FILLなどの原因になるため、SYMBOL_FILLING_MODEとrequest.type_fillingを照合してください。

ACCOUNT_BALANCEとACCOUNT_EQUITYは何が違いますか？

ACCOUNT_BALANCEは残高、ACCOUNT_EQUITYは含み損益を反映した有効証拠金です。ロット計算やrisk判定では、どちらを基準にしているかを明確にしてください。

TRADE_ACTION_DEALとORDER_TYPE_BUYはどう違いますか？

TRADE_ACTION_DEALは取引リクエストの操作種別で、成行注文や成行決済を行うactionです。ORDER_TYPE_BUYは注文方向・注文種別です。MqlTradeRequestでは、actionとtypeを分けて設定します。

列挙型や定数の指定ミスはどのログで確認できますか？

Expertsログのrequest内容、OrderSend結果、result.retcode、GetLastError、SymbolInfoログ、Journalログを確認します。定数指定ミス、銘柄仕様不一致、サーバー側拒否を分けて確認してください。

開発依頼前に何を整理すればよいですか？

EA名、インジケーター名、バージョン、対象銘柄、時間足、注文種別、filling方式、setファイル、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。

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

まず公式リファレンス、MetaEditorの補完、コンパイル結果、Expertsログ、Journalログ、実際の取引結果を確認してください。定数の意味だけでなく、どの関数・構造体・履歴項目で使う値なのかを整理して確認します。

まとめ

MQL5の列挙型・定数では、ENUM_TIMEFRAMES、ENUM_ORDER_TYPE、ENUM_POSITION_TYPE、ENUM_DEAL_TYPE、ENUM_ORDER_STATE、ENUM_SYMBOL_INFO_DOUBLE、ENUM_SYMBOL_INFO_INTEGER、ENUM_ACCOUNT_INFO_DOUBLE、ENUM_TRADE_REQUEST_ACTIONS、ORDER_FILLING系を用途別に理解することが重要です。

Order、Position、Deal、Historyでは、似たBUY / SELL表記でも確認対象が異なります。注文種別、ポジション種別、約定種別、注文状態を混同しないようにしてください。

SymbolInfo系やAccountInfo系では、double系とinteger系を分けて確認します。point、digits、spread、volume step、StopsLevel、FillingMode、balance、equity、margin_freeなどは、EAの発注・risk・検証に直結します。

不具合調査や開発依頼を行う場合は、EA名、インジケーター名、バージョン、銘柄、時間足、注文種別、filling方式、setファイル、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。