MQL5標準ライブラリ辞典｜CTrade・CPositionInfo・COrderInfo・CDealInfo一覧

MQL5でEAを開発する場合、標準ライブラリを使うと、発注、ポジション確認、注文確認、約定履歴確認、銘柄仕様確認、口座情報確認をクラス単位で扱いやすくなります。

特に、CTrade、CPositionInfo、COrderInfo、CDealInfo、CSymbolInfo、CAccountInfo、Buy / Sell、PositionClose、ResultRetcode、CheckResult は、EA開発や不具合調査で頻繁に確認する項目です。

この記事では、MQL5標準ライブラリの主要クラス・メソッドを、EA開発や不具合調査で確認しやすい辞典形式で整理します。公式リファレンスの丸写しではなく、どのクラスを、どの場面で使い、どの戻り値・retcode・ログを確認するかを整理するための記事です。

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

MQL5標準ライブラリとは

MQL5標準ライブラリは、MQL5に用意されているクラス群です。取引処理、ポジション情報、注文情報、約定履歴、銘柄仕様、口座状態などを、関数を直接呼び出すよりも扱いやすい形で整理できます。

ただし、標準ライブラリを使えば必ず安全になるわけではありません。CTradeを使っても、発注失敗、retcode不一致、filling方式不一致、StopsLevel違反、証拠金不足、ロット不正、接続不安定などは発生します。標準ライブラリを使う場合でも、戻り値、ResultRetcode、CheckResult、Expertsログ、Journalログを確認することが重要です。

標準ライブラリを使う時の基本方針

標準ライブラリは、MQL5の取引関数や情報取得関数をクラスとして扱いやすくしたものです。EA開発では便利ですが、クラスを使うことと、注文結果を正しく検証することは別です。

CTrade

CTradeは、MQL5標準ライブラリの取引操作用クラスです。成行発注、決済、注文変更、注文削除、SL/TP変更などを、OrderSendを直接組み立てるより簡潔に扱えます。

CTradeを使う場合でも、BuyやSellの戻り値、ResultRetcode、ResultComment、ResultOrder、ResultDealを確認してください。発注関数を呼び出したことと、取引サーバーで期待どおり処理されたことは同じではありません。

CTradeで確認すること

CPositionInfo

CPositionInfoは、保有中ポジションの情報を確認するための標準ライブラリクラスです。PositionGetInteger、PositionGetDouble、PositionGetStringを直接使う代わりに、クラスメソッドでポジション情報を取得できます。

COrderInfo

COrderInfoは、注文情報を扱うための標準ライブラリクラスです。現在の未約定注文や履歴注文の確認で使います。PositionやDealとは確認対象が異なるため、Order、Position、Dealを分けて扱うことが重要です。

CDealInfo

CDealInfoは、約定履歴を扱うための標準ライブラリクラスです。売買損益、決済履歴、Magic Number別履歴、EA別集計、日次集計を行う時に使います。

Deal履歴では、BUY / SELLだけで新規・決済を断定しないようにします。DEAL_TYPE、DEAL_ENTRY、DEAL_PROFIT、DEAL_MAGIC、DEAL_COMMENTなどを組み合わせて確認します。

CSymbolInfo

CSymbolInfoは、銘柄仕様や現在価格を扱うための標準ライブラリクラスです。ロット条件、point、digits、spread、StopsLevel、FreezeLevel、Bid、Askなどを確認する時に使います。

CAccountInfo

CAccountInfoは、口座情報を扱う標準ライブラリクラスです。残高、有効証拠金、余剰証拠金、証拠金維持率、レバレッジ、口座通貨などを確認できます。

Buy / Sell / PositionClose

Buy、Sell、PositionCloseは、CTradeで特によく使うメソッドです。EAの基本的な新規発注と決済に関係するため、戻り値とResultRetcodeをセットで確認します。

確認ポイント：Buy / Sell / PositionCloseの戻り値がtrueでも、期待どおりに約定・決済されたかはResultRetcode、ResultDeal、Position状態、History履歴で確認してください。

ResultRetcodeとCheckResult

ResultRetcodeは、CTradeで取引操作を行った後に、取引サーバーから返された結果コードを確認するために使います。CheckResultは、OrderCheckによる発注前確認結果を確認するために使います。

OrderSend直接実装との違い

CTradeは便利ですが、内部では取引リクエストを組み立てて取引操作を行います。細かい制御や詳細なrequestログを重視する場合は、MqlTradeRequest、MqlTradeResult、OrderSend、OrderCheckを直接使う設計もあります。

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

EAが発注しない、決済しない、注文エラーが出る、ポジションが選択されない、履歴集計が合わない場合は、標準ライブラリの使い方そのものよりも、戻り値、retcode、対象ticket、symbol、magic、銘柄仕様、口座状態の確認が重要です。

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

MQL5開発では、標準ライブラリを使う場合でも、signal、execution、risk、exit、history、symbol spec、account stateを分けて設計することが重要です。

実装時の注意点

• CTradeの戻り値だけで成功判定を完結しない
• ResultRetcode、ResultComment、ResultOrder、ResultDealをログに残す
• Buy / Sell前にvolume、price、SL/TP、spread、filling方式を確認する
• PositionCloseではticket指定とsymbol指定の違いを確認する
• CPositionInfoではOrderやDealとticketを混同しない
• CDealInfoではDEAL_TYPEとDEAL_ENTRYをセットで確認する
• CSymbolInfoでpoint、digits、lot step、StopsLevelを確認する
• CAccountInfoでBalanceとEquityを混同しない
• CheckResultは発注前確認であり、実発注成功とは別に扱う
• 標準ライブラリを使う場合でも、ExpertsログとJournalログを必ず確認する

標準ライブラリ主要クラス・メソッド辞典表

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

標準ライブラリ、CTrade、Position確認、Order確認、Deal履歴、銘柄仕様、口座情報まわりの不具合調査や改修依頼を行う場合は、次の情報を整理してください。

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

関連するMQL5技術辞典

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

確認ポイント：標準ライブラリでは、CTradeの戻り値だけで判断せず、ResultRetcode、ResultComment、Position状態、Order履歴、Deal履歴、CSymbolInfo、CAccountInfoをセットで確認してください。

関連する技術講座

FAQ

CTradeを使えばOrderSendを理解しなくてもよいですか？

基本的な発注はCTradeで扱いやすくなりますが、OrderSend、MqlTradeRequest、MqlTradeResultの考え方も理解しておくと、不具合調査や詳細なログ確認がしやすくなります。

BuyやSellの戻り値がtrueなら発注成功ですか？

trueだけで期待どおりの約定と断定しないでください。ResultRetcode、ResultDeal、ResultOrder、Position状態、History履歴を確認する必要があります。

PositionCloseで決済できない場合は何を確認しますか？

対象ticket、symbol、position type、volume、現在価格、spread、ResultRetcode、ResultComment、Journalログを確認してください。hedging口座とnetting口座の違いも確認対象です。

CPositionInfoとCOrderInfoは何が違いますか？

CPositionInfoは保有中ポジションを確認するためのクラスです。COrderInfoは注文情報、特に未約定注文や注文履歴を確認するためのクラスです。PositionとOrderは別の概念として扱います。

CDealInfoは何に使いますか？

約定履歴の確認に使います。決済損益、EA別履歴、Magic別集計、日次損益確認などで使います。DEAL_TYPEだけでなくDEAL_ENTRYも確認してください。

CSymbolInfoでは何を確認しますか？

Bid、Ask、Point、Digits、最小ロット、ロット刻み、StopsLevel、Spreadなどを確認します。発注前のvalidationやINVALID_VOLUME、INVALID_STOPSの原因確認に重要です。

CAccountInfoでは何を確認しますか？

Balance、Equity、Margin、FreeMargin、MarginLevel、Currencyなどを確認します。残高と有効証拠金、口座全体損益とEA別損益を混同しないようにしてください。

CheckResultは実発注結果ですか？

CheckResultは発注前確認の結果です。証拠金や注文条件の事前確認には使えますが、実際のOrderSendやCTrade実行結果とは別に扱います。

標準ライブラリと直接OrderSend実装はどちらがよいですか？

一般的なEAではCTradeが扱いやすい場合が多いです。特殊な発注制御、詳細なrequestログ、独自retry、細かいfilling制御が必要な場合は、OrderSend直接実装も検討します。

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

EA名、バージョン、対象機能、銘柄、時間足、注文条件、ResultRetcode、Expertsログ、Journalログ、setファイル、スクリーンショット、再現手順を整理してください。

まとめ

MQL5標準ライブラリでは、CTrade、CPositionInfo、COrderInfo、CDealInfo、CSymbolInfo、CAccountInfoを目的別に使い分けることが重要です。

CTradeは発注や決済を簡潔に扱える便利なクラスですが、Buy、Sell、PositionCloseの戻り値だけで成功判定を完結しないようにしてください。ResultRetcode、ResultComment、ResultOrder、ResultDeal、Position状態、History履歴を確認します。

CPositionInfo、COrderInfo、CDealInfoは、それぞれPosition、Order、Dealを確認するためのクラスです。ticket、type、state、entry、magic、commentなどを混同しないようにしてください。

CSymbolInfoとCAccountInfoは、発注前validationやrisk確認に重要です。point、digits、lot step、StopsLevel、spread、Balance、Equity、FreeMargin、MarginLevelを整理して確認してください。

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