既刊のUninitializeReasonの記事で、

REASON_PROGRAM(0)の説明として、

「ExpertRemove()を呼んで自ら終了」と一行だけ書きました。

ただ、ExpertRemove()自体の使い方は、

その記事では解説していませんでした。

この関数には「呼んだ瞬間に止まる」という、

直感とは違う仕様があります。

この記事では、証拠金維持率が危険水域に達したら、

全決済してEA自体を完全に停止する実装を例に、

ExpertRemove()の正しい使い方を解説します。

この記事で分かること
・ExpertRemove()が『即座に止まらない』理由
・呼び出し後に何が起きて、何が起きないか
・既刊の全決済EAとの違い(ポジションを閉じるvs自分自身を止める)
・実際に動くコード全文とよくある誤解

ExpertRemoveとは何か

まず、この関数が解決する問題を整理します。

既刊記事での扱いと欠けていた点

既刊UninitializeReasonの記事は、

OnDeinit()が呼ばれた「理由」を解説しましたが、

その理由を自分から作り出す側のExpertRemove()は、

名前が出てきただけで終わっていました。

ExpertRemoveが解決する問題

補足
・EAはreturnしてOnTickを抜けても、次のティックでまた動き出す
・「もう二度と動かしたくない」場面では、returnだけでは不十分
・ExpertRemove()はEA自体をチャートから完全に外す関数

危険な口座状態を検知した後も、

EAが黙って動き続けてしまうと、

意図しない追加発注のリスクが残ります。

シグネチャと呼び出し後の仕様

公式リファレンスで仕組みを確認します。

シグネチャ

公式リファレンス(ExpertRemove)によると、シグネチャは次の通りです。

void ExpertRemove();

引数は無く、戻り値もありません。

呼ぶだけで意味を持つ関数です。

即座には停止しないという仕様

注意
・呼び出した瞬間にEAが止まるわけではない
・停止を示す「フラグ」が立つだけ
・次のイベント以降は処理されなくなり、OnDeinit()が呼ばれてアンロードされる

公式リファレンスは、

「ExpertRemove()を呼んでも即座に停止せず、

EAの動作を止めるフラグだけが設定される」

と明記しています。

REASON_PROGRAMとの関係

このフラグが立った後に呼ばれるOnDeinit()では、

既刊UninitializeReasonの記事の通り、

引数reasonにREASON_PROGRAM(0)が渡されます。

既刊の全決済EAとの違い

既刊margin-level-stop-ea-mt4.mdと比較します。

ポジションを閉じるだけでは終わらない

既刊の記事は、

証拠金維持率が危険水域に達したら、

OrderCloseのループで全ポジションを決済します。

EA自体は稼働を続けてしまう

ポジションを閉じても、

OnTick()自体は次のティックでまた呼ばれるため、

同じ条件で再び新規発注してしまう可能性が残ります。

ExpertRemoveでEA自体を止める

全決済した直後にExpertRemove()を呼べば、

次のティック以降はOnTick()自体が呼ばれなくなり、

EAがチャートから完全に外れます。

実際に動くコード全体:危険水域で自己停止するEA

証拠金維持率が危険水域に達したら、

全決済してEA自体を停止します。

//+------------------------------------------------------------------+
//|                                   MarginGuardExpertRemove.mq4     |
//|                     Copyright 2026, FX-EA System Project Creator |
//|                        https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property strict

input double InpDangerLevel = 150.0; //危険とみなす証拠金維持率(%)

//+------------------------------------------------------------------+
int OnInit()
  {
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
void OnTick()
  {
   if(AccountMargin() <= 0.0)
      return; //保有ポジションなし

   double level = AccountEquity() / AccountMargin() * 100.0;

   if(level >= InpDangerLevel)
      return; //まだ危険水域ではない

   CloseAllOrders();
   Print("危険水域(維持率", level, "%)のため自己停止します");
   ExpertRemove();
   //この行の直後も、この関数が終わるまでの処理は実行される
  }

//+------------------------------------------------------------------+
void CloseAllOrders()
  {
   for(int i = OrdersTotal() - 1; i >= 0; i--)
     {
      if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
         continue;
      if(OrderType() > OP_SELL)
         continue; //保留注文は対象外

      RefreshRates();
      double price = (OrderType() == OP_BUY) ? Bid : Ask;
      OrderClose(OrderTicket(), OrderLots(), price, 3);
     }
  }

//+------------------------------------------------------------------+
void OnDeinit(const int reason)
  {
   if(reason == REASON_PROGRAM)
      Print("ExpertRemove()による自己停止でOnDeinitが呼ばれました");
  }
//+------------------------------------------------------------------+

入力パラメータ

InpDangerLevelは、

既刊margin-level-stop-ea-mt4.mdと同じ考え方の、

「自分で決めた危険水域(%)」です。

OnTickでの判定順序

全決済を先に実行し、

その後でExpertRemove()を呼ぶ順序にしています。

逆にすると、フラグが立った後の処理が、

意図通りに実行されるか保証できないためです。

MetaEditorでの実行手順

実際に動かして停止の挙動を確認する手順です。

  1. MetaEditorで新規EA「MarginGuardExpertRemove」を作成し、上のコードを貼り付ける
  2. F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  3. デモ口座のチャートに適用し、InpDangerLevelを現在の維持率より高い値に一時的に設定する
  4. 「エキスパート」タブに停止ログが出力され、EAがチャートから自動的に外れることを確認する

よくあるエラーと注意点

実装時につまずきやすい点をまとめます。

即時停止だと誤解しない

ExpertRemove()の行より後に書いたコードも、

同じ関数呼び出しの中であれば実行されてしまいます。

発注など重要な処理は、

ExpertRemove()より前に済ませておく必要があります。

ストラテジーテスターでの挙動

MQL5公式リファレンスには、

OnInit()内で呼ぶとテストが初期化エラー扱いになり、

OnInit()より後で呼ぶと正常終了として、

取引統計が取得される、と明記されています。

この挙動はMQL5ドキュメントでの説明であり、

MQL4公式ページには同じ明記が見当たらなかったため、

MQL4でも全く同じとは断定せず、参考情報として開示します。

MQL5でも同名・同シグネチャで使える

MQL5にも同名のExpertRemove()があり、

引数なし・戻り値voidという仕様も共通です。

よくある質問

ExpertRemoveについて、よく検索される疑問に回答します。

カスタムインジケーターでも使えますか?

公式リファレンスはExpert Advisor向けの関数として説明しており、

インジケーターでの動作は本サイトでは未検証のため、

インジケーターへの使用は避けることをおすすめします。

呼び出しが失敗したか確認できますか?

戻り値がvoidのため、

成功・失敗を関数の戻り値から判定する方法は、

公式リファレンスに示されていません。

GetLastError()と併用すべきですか?

ExpertRemove()自体がエラーコードを残すとは、

公式リファレンスに明記されていないため、

停止したかどうかはPrint()等のログで確認するのが確実です。

【MQL4】ExpertRemove関数でEAを安全に停止する方法について解説してみた(呼び出し後も即停止しない仕様に注意):まとめ

ExpertRemove()は、呼んだ瞬間に止まる関数ではなく、

「停止フラグ」を立てるだけの関数です。

既刊margin-level-stop-ea-mt4.mdのようにポジションを閉じても、

EA自体はOnTick()のたびに動き続けてしまうため、

本当に完全停止させたい場面では、

全決済のあとにExpertRemove()を呼ぶ必要があります。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事