MQL5 OrderCalcMargin / OrderCalcProfitの使い方｜必要証拠金と想定損益の確認

MQL5でEAの発注前チェックを作る時は、注文を送る前に必要証拠金と想定損益を確認できるようにしておくと、注文失敗や想定外のロット、SL幅、証拠金不足を切り分けやすくなります。

その時に使う代表的な関数が、OrderCalcMargin と OrderCalcProfit です。OrderCalcMargin は指定した注文条件で必要証拠金を計算し、OrderCalcProfit は指定したエントリー価格と決済価格から想定損益を計算します。

ただし、この2つは実際に注文を送る関数ではありません。発注前の見積もり・検証・ログ確認に使う関数です。実際の注文可否、retcode、口座状態、銘柄仕様、SL/TP距離、取引許可状態を確認するには、OrderCheck、OrderSend、SymbolInfoDouble、SymbolInfoInteger などと組み合わせて確認します。

この記事では、MQL5の OrderCalcMargin / OrderCalcProfit の役割、必要証拠金と想定損益の確認方法、OrderCheckとの違い、EAの発注前チェックへ組み込む時の考え方、GOLD / XAUUSDのような銘柄で注意したい点、バックテストやログ確認で見るべき項目を整理します。

なお、本記事はMT5 / MQL5 EA開発における技術的な確認事項を整理するものです。特定の売買判断、推奨ロット、推奨銘柄、利益、勝率、損失回避、運用成績を示すものではありません。

この記事で確認すること

OrderCalcMarginとは

OrderCalcMargin は、指定した注文種別、銘柄、ロット、価格で注文した場合に必要となる証拠金を計算するための関数です。

EAで注文前チェックを作る時、現在の残高や余剰証拠金に対して、その注文を出せるかどうかを事前に確認したい場面があります。その時に、ロットと銘柄仕様をもとに必要証拠金を見積もる役割を持つのが OrderCalcMargin です。

ただし、OrderCalcMargin は「注文が必ず通る」と判断する関数ではありません。あくまで必要証拠金を計算する関数です。取引許可、StopLevel、FreezeLevel、ロット刻み、最大ロット、最小ロット、スプレッド、口座状態、trade allowedなどは、別途確認が必要です。

OrderCalcProfitとは

OrderCalcProfit は、指定した注文種別、銘柄、ロット、エントリー価格、決済価格から想定損益を計算するための関数です。

EAでは、SLまでの想定損失、TPまでの想定利益、ATR幅に応じた損益、リスク許容額に対するロット調整などを確認したい場面があります。その時に、価格差とロットから想定損益を計算するために OrderCalcProfit を使います。

ただし、OrderCalcProfit で計算できるのは理論上の損益です。実運用では、スプレッド、約定価格、スリッページ、手数料、スワップ、口座仕様、銘柄仕様の影響を受けるため、実際の損益と完全一致するとは限りません。

OrderCalcMargin / OrderCalcProfit / OrderCheckの違い

発注前チェックでは、OrderCalcMargin、OrderCalcProfit、OrderCheck を混同しないことが重要です。

OrderCalcMargin は必要証拠金の見積もり、OrderCalcProfit は指定価格差に対する想定損益の見積もり、OrderCheck はMqlTradeRequestに対する注文前チェックです。役割が違うため、どれか1つだけで発注可否を完全に判断するのではなく、責務を分けて使います。

OrderCheck の基本は、MQL5 OrderCheckの使い方で整理しています。証拠金・ロット・StopLevelをより実務的に確認したい場合は、MQL5 OrderCheckで証拠金・ロット・StopLevelを確認する方法も確認してください。

OrderCalcMarginの基本コード

以下は、BUY注文の必要証拠金を確認する最小構成の例です。実際のEAでは、銘柄、ロット、価格、エラー処理、ログ出力を関数化して使う方が管理しやすくなります。

double margin = 0.0;
double volume = 0.10;
double price  = SymbolInfoDouble(_Symbol, SYMBOL_ASK);

bool ok = OrderCalcMargin(
   ORDER_TYPE_BUY,
   _Symbol,
   volume,
   price,
   margin
);

if(!ok)
{
   Print("OrderCalcMargin failed. error=", GetLastError());
}
else
{
   Print("required margin=", margin);
}

このコードでは、SYMBOL_ASK を使ってBUY注文の計算価格を取得し、OrderCalcMargin で必要証拠金を計算しています。失敗時には GetLastError() をログに出しています。

実務では、必要証拠金が取得できたかどうかだけでなく、現在の余剰証拠金、ロット値、銘柄仕様、取引許可状態も合わせて確認します。

OrderCalcProfitの基本コード

以下は、BUY注文でエントリー価格からSL価格まで下がった場合の想定損失を確認する例です。ロットと価格差に対する損益を確認することで、リスク額やSL幅の妥当性を見やすくなります。

double profit = 0.0;
double volume = 0.10;
double entry_price = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
double sl_price = entry_price - 1000 * _Point;

bool ok = OrderCalcProfit(
   ORDER_TYPE_BUY,
   _Symbol,
   volume,
   entry_price,
   sl_price,
   profit
);

if(!ok)
{
   Print("OrderCalcProfit failed. error=", GetLastError());
}
else
{
   Print("estimated profit/loss=", profit);
}

BUY注文では、決済価格がエントリー価格より下にある場合、損失方向になります。上記の例では、SL価格まで下がった場合の想定損失を確認しています。

SELL注文では価格方向が逆になります。SELLでは、エントリー価格より上にSL価格がある場合、損失方向になります。BUYとSELLで価格の向きが違うため、注文方向を必ずログに出して確認してください。

発注前チェックで確認する順序

EAの発注前チェックでは、いきなり OrderSend へ進むのではなく、シグナル、フィルター、銘柄仕様、ロット、証拠金、SL/TP距離、OrderCheck、OrderSend結果を段階的に確認すると原因を追いやすくなります。

特に、バックテストで注文が出ない、リアル運用で注文が失敗する、GOLD / XAUUSDでロットやStopLevelが合わない、証拠金不足になる、といった相談では、どの段階で止まったかをログで確認できることが重要です。

発注前チェック全体の考え方は、MQL5でEAの発注前チェックを作る考え方で整理しています。

ロットと証拠金の関係を見る

OrderCalcMargin は、ロットが変わると必要証拠金も変わります。そのため、固定ロット、残高比率、リスク割合、ナンピン追加ロット、マーチン倍率などを使うEAでは、ロット計算後に必要証拠金を確認することが重要です。

ロットが銘柄仕様に合っていない場合、注文前に失敗します。最小ロット、最大ロット、ロット刻み、volume limitを確認し、計算ロットをそのまま注文に使わないようにします。

銘柄仕様の取得方法は、MQL5 SymbolInfoDouble / SymbolInfoIntegerの使い方も参考にしてください。

SL/TP幅と想定損益を確認する

OrderCalcProfit は、SLまでの想定損失やTPまでの想定利益を確認する時に使えます。特に、ATR幅、固定pips、直近高値安値、ボラティリティに応じたSL/TPを使うEAでは、価格幅と損益額の関係を確認しておくと安全です。

ただし、SL/TP価格がStopLevelに違反している場合や、FreezeLevelに近い場合、想定損益が計算できても注文自体は通らない可能性があります。損益計算と注文可否は分けて確認してください。

OrderCheckと組み合わせる

OrderCalcMargin と OrderCalcProfit は、必要証拠金と想定損益を確認するための関数です。一方で、注文前の総合的なチェックには OrderCheck を使います。

OrderCheck では、MqlTradeRequestを渡して、注文前にretcode、comment、margin、balance、equity、margin_freeなどを確認できます。実際の注文結果とは異なりますが、発注前に問題を見つけるための重要な情報になります。

実務では、OrderCalcMarginで必要証拠金を概算し、OrderCalcProfitでリスク額を確認し、MqlTradeRequestを組み立てた後にOrderCheckで最終確認し、それからOrderSendまたはCTradeへ進める構造が扱いやすくなります。

OrderSendの結果ログについては、MQL5 OrderSend結果ログを実コードで解説で整理しています。

発注前チェック関数の構成例

以下は、必要証拠金とSL到達時の想定損失を確認する発注前チェック関数の簡易例です。実際のEAでは、銘柄仕様、スプレッド、時間条件、最大ポジション数、Magic Number、OrderCheck結果なども含めて責務を分けると保守しやすくなります。

bool CheckMarginAndRisk(
   string symbol,
   ENUM_ORDER_TYPE orderType,
   double volume,
   double entryPrice,
   double slPrice
)
{
   double requiredMargin = 0.0;
   double estimatedLoss = 0.0;

   if(!OrderCalcMargin(orderType, symbol, volume, entryPrice, requiredMargin))
   {
      Print("OrderCalcMargin failed. symbol=", symbol,
            " volume=", volume,
            " error=", GetLastError());
      return false;
   }

   if(!OrderCalcProfit(orderType, symbol, volume, entryPrice, slPrice, estimatedLoss))
   {
      Print("OrderCalcProfit failed. symbol=", symbol,
            " volume=", volume,
            " error=", GetLastError());
      return false;
   }

   double freeMargin = AccountInfoDouble(ACCOUNT_MARGIN_FREE);

   Print("PRECHECK margin=", requiredMargin,
         " freeMargin=", freeMargin,
         " estimatedLoss=", estimatedLoss);

   if(requiredMargin > freeMargin)
   {
      Print("PRECHECK_BLOCK reason=NOT_ENOUGH_MARGIN");
      return false;
   }

   return true;
}

この例では、必要証拠金が余剰証拠金を超えている場合に発注前で止めています。実際には、証拠金に余裕を持たせる、margin levelを確認する、最大DDや1回あたりリスク額を制限するなど、EAの仕様に応じて条件を追加します。

また、estimatedLoss は損失方向の場合にマイナス値になることがあります。ログでは符号を含めて確認し、必要なら絶対値でリスク額として扱うなど、仕様を明確にしてください。

GOLD / XAUUSDで注意すること

GOLD / XAUUSDでは、通貨ペアと比べて値幅、point、digits、tick value、contract size、必要証拠金、スプレッドが大きく異なることがあります。

そのため、OrderCalcMarginやOrderCalcProfitを使っていても、銘柄仕様の確認が不足していると、想定より大きな必要証拠金や損益額になる場合があります。

GOLD / XAUUSD対応EAでは、ロット・SL幅・損益額・必要証拠金を必ず銘柄仕様とセットで確認してください。

バックテストで注文が出ない時の確認

バックテストで注文が出ない場合、シグナルが出ていないだけでなく、発注前チェックで止まっている可能性があります。特に、証拠金不足、ロット不正、スプレッド上限超過、StopLevel違反、取引時間外、最大ポジション数到達などを確認します。

OrderCalcMarginやOrderCalcProfitをログに出しておくと、必要証拠金や想定損失が原因で発注を止めているのか、シグナル自体が成立していないのかを切り分けやすくなります。

ログに残すべき項目

発注前チェックでは、計算した値をログに残すことで、後から注文が出ない原因を確認しやすくなります。

特に、OrderCalcMarginやOrderCalcProfitの結果は、EA内部で判定に使っていても、ログに出ていないと確認できません。検証用ログでは、数値とブロック理由を分けて出すと追跡しやすくなります。

よくある失敗

OrderCalcMargin / OrderCalcProfitを使う時は、関数の役割を誤解したり、価格方向やロット仕様を誤ったりしないよう注意が必要です。

関連ページ

OrderCalcMargin / OrderCalcProfitは、発注前チェック、OrderCheck、OrderSend結果ログ、銘柄仕様確認と合わせて整理すると理解しやすくなります。

OrderCalcMargin / OrderCalcProfitの実務チェック表

よくある質問

OrderCalcMarginを使えば注文できるか分かりますか？

必要証拠金の見積もりはできますが、注文が必ず通るかまでは分かりません。注文前の総合確認にはOrderCheck、実際の注文結果確認にはOrderSendやCTradeの結果ログが必要です。

OrderCalcProfitは将来の損益予測ですか？

将来の損益予測ではありません。指定した価格差とロットに対する理論上の想定損益を計算するための関数です。実運用ではスプレッド、約定、手数料、スワップなどの影響があります。

BUYとSELLでOrderCalcProfitの使い方は変わりますか？

注文種別と価格方向が変わります。BUYは価格上昇が利益方向、SELLは価格下落が利益方向です。SL/TP価格の位置を間違えないように、注文方向と価格をログに出してください。

証拠金不足かどうかは何を見ればよいですか？

OrderCalcMarginで必要証拠金を計算し、AccountInfoDoubleの余剰証拠金と比較します。さらにOrderCheckのretcode、margin、margin_free、commentも確認してください。

GOLD / XAUUSDで損益計算がずれる原因は何ですか？

digits、point、tick value、contract size、ロット刻み、ブローカーごとの銘柄仕様差が原因になることがあります。SymbolInfoDouble / SymbolInfoIntegerで銘柄仕様を確認してください。

OrderCalcMarginで確認できることと確認できないこと

OrderCalcMargin は、指定した銘柄、注文方向、ロット、価格で必要証拠金を見積もるための関数です。発注前に証拠金目安を出す目的では有効ですが、この関数だけで注文可否を最終判断することはできません。

実際のEAでは、必要証拠金の計算に加えて、銘柄の取引可否、ロット最小値、ロット最大値、ロット刻み、StopLevel、FreezeLevel、スプレッド、取引時間、口座の取引許可状態、既存ポジション数、同一Magic Numberの状態を分けて確認します。

OrderCalcMarginの戻り値が正常でも、OrderSendが必ず成功するわけではありません。価格が変動した、StopLevelに抵触した、取引時間外になった、許容スプレッドを超えた、既存ポジション制限に達した、といった理由で発注を見送ることがあります。

そのため、OrderCalcMarginは「発注前チェックの一部」として扱い、OrderCheckやOrderSend結果ログと組み合わせて使います。ログ上も、MARGIN、ORDER_CHECK、ORDER_SENDを別のreason_codeとして分けておくと、停止理由を追いやすくなります。

OrderCalcProfitで確認できることと確認できないこと

OrderCalcProfit は、指定した注文方向、銘柄、ロット、建値、決済価格を使って想定損益を計算するための関数です。SL到達時の想定損失、TP到達時の想定利益、任意価格まで動いた場合の損益目安をログへ残す時に使いやすい関数です。

ただし、OrderCalcProfitの結果は「指定価格で決済された場合の計算値」です。実運用では、約定価格、スリッページ、手数料、スワップ、部分決済、複数ポジション、通貨換算のタイミングなどにより、最終損益と完全一致しない場合があります。

EA開発では、OrderCalcProfitの値を「将来損益の予測」としてではなく、「現在の入力条件でどの程度の損益幅になるかを確認する診断ログ」として扱うのが安全です。

BUYとSELLで価格方向を分けて確認する

OrderCalcProfitを使う時は、BUYとSELLで損益方向が反対になる点に注意します。BUYでは、決済価格が建値より上なら利益方向、下なら損失方向です。SELLでは、決済価格が建値より下なら利益方向、上なら損失方向です。

SL価格やTP価格を計算する時に方向を取り違えると、想定損失と想定利益が逆になります。とくに、内部でpoint幅からSL/TP価格を作るEAでは、direction、entry、sl、tp、price_closeを必ずログに出してください。

想定損益ログで正負が意図と逆になっている場合は、注文方向、SL/TP価格、価格桁、point換算、銘柄仕様のいずれかを確認してください。

ロット正規化後に計算する

OrderCalcMarginやOrderCalcProfitへ渡すvolumeは、実際に発注するロットと一致させます。EA内部で算出した仮ロットをそのまま使うのではなく、銘柄の最小ロット、最大ロット、ロット刻みに合わせて正規化した後の値で計算することが重要です。

たとえば、ロット刻みが0.01の銘柄で0.123ロットを計算に使い、実際の発注では0.12に丸める場合、計算ログと注文結果がずれます。証拠金や想定損益をログへ出す場合は、正規化前ロットと正規化後ロットを分けて残すと確認しやすくなります。

OrderCalcMargin / OrderCalcProfitをログ設計に組み込む

発注前チェックでは、単に計算関数を呼ぶだけではなく、どの入力値で計算し、どの結果になり、どの理由で発注を許可または停止したかをログに残します。

ログ設計では、SIGNAL、GATE、SPREAD、LOT、MARGIN、SLTP、ORDER_CHECK、ORDER_SENDを分けると、バックテストで注文が出ない時や、実運用で注文エラーが出た時に原因を追いやすくなります。

このように分けておくと、「シグナルは出たが証拠金で止まった」「証拠金は足りたがOrderCheckで止まった」「OrderCheckは通ったがOrderSendでretcodeが返った」といった状態を確認できます。

バックテストで確認する時の注意点

Strategy TesterでOrderCalcMarginやOrderCalcProfitを確認する時は、実口座の約定やサーバー条件を完全に再現しているわけではない点に注意します。バックテストでは、EA内部のロット計算、価格指定、SL/TP設定、想定損益ログが意図どおり出ているかを確認します。

一方、実運用では、取引時間、価格変動、約定方式、リクオート、スリッページ、ブローカー側の制限、口座タイプ、VPSや通信状態が関係します。OrderCalc系の計算ログは、実運用での注文結果ログと合わせて比較してください。

OrderCalcMargin / OrderCalcProfitの実務チェック表

まとめ

OrderCalcMargin は必要証拠金の見積もり、OrderCalcProfit は指定価格差に対する想定損益の見積もりに使う関数です。

この2つは注文を送る関数ではなく、発注前チェックやログ確認のために使う補助関数です。実際の注文可否は、銘柄仕様、ロット、SL/TP距離、取引許可状態、OrderCheck、OrderSend結果ログと合わせて確認してください。

EAの発注前チェックでは、必要証拠金、余剰証拠金、想定損益、ロット、StopLevel、retcode、commentをログに残すことで、バックテストや実運用で注文が出ない時の原因を追いやすくなります。