マジックナンバーとは｜EA複数運用で必須の設定と命名規則の作り方

マジックナンバーは、EAが「どの注文を自分が出したのか」を見分けるための整数IDです。1本だけEAを動かしているうちは意識しなくても動いてしまうため、後回しにされがちな設定です。しかし複数のEAを1つの口座で動かした瞬間、この番号が重複しているかどうかが損益を左右します。この記事では、マジックナンバーの役割、重複したときに何が壊れるのか、そして実際の命名規則と一覧表の作り方を整理します。

結論：マジックナンバーは「自分の注文の目印」

導入手順全体の中では、マジックナンバーの設定は EAの入れ方（導入9手順28ステップ） の手順7にあたります。ファイルの配置や自動売買の許可がまだの場合は、先にそちらを確認してください。

マジックナンバーとは何か

EAが発注するとき、注文には「どのプログラムが出したか」を示す整数を添えられます。これがマジックナンバーです。MetaTraderはこの値を注文・ポジションの属性として保存するため、EAは後から自分の注文だけを抽出できます。

EAの内部処理は、おおむね次の流れで動いています。

1. 現在保有しているポジションを一覧で取得する
2. マジックナンバーが自分の値と一致するものだけを残す
3. 残った件数・ロット・含み損益をもとに、追加エントリーや決済を判断する

つまりマジックナンバーは、2番目のフィルタで使われる唯一の手がかりです。ここが狂うと、3番目の判断がすべて狂います。

MT4での扱い

MT4では OrderSend() の magic 引数で番号を指定します。読み取りは OrderMagicNumber() です。注文プールを OrderSelect() で走査し、OrderMagicNumber() == MagicNumber かつ OrderSymbol() == Symbol() の条件で絞り込む書き方が一般的です。

MT5での扱い

MT5では MqlTradeRequest 構造体の magic メンバーに値をセットして発注します。保有ポジションから読み取る場合は PositionGetInteger(POSITION_MAGIC) を使います。MT4とはAPIが根本的に異なりますが、マジックナンバーの役割そのものは同じです。

重複すると何が壊れるのか

マジックナンバーが重複すると、EAは他のEAのポジションを自分のものとして数えます。壊れるのは1か所ではなく、連鎖的に複数の処理です。

複数EAを1口座で運用する前提そのものについては、 EAは何本まで同時に動かせるか と EAポートフォリオの組み方 もあわせて確認してください。

0を避ける理由

マジックナンバー0は、手動で出した注文に付く値です。MetaTraderの画面から自分でクリックして発注したポジションは、マジックナンバーが0として記録されます。

EAのマジックナンバーを0のままにすると、EAは手動ポジションと自分のポジションを区別できません。裁量トレードとEAを同じ口座で併用している場合、EAが手動ポジションを決済する、あるいは手動ポジションを自分の段数として数えるといった動作が起こり得ます。

通貨ペアごとに別の値にする理由

同じEAをUSDJPYとEURUSDの2つのチャートに適用する場合でも、マジックナンバーは分けます。理由は、多くのEAがポジションを絞り込むときに通貨ペアの条件を併用するとは限らないためです。

通貨ペアで絞っていないEAでは、USDJPY担当のインスタンスがEURUSDのポジションも自分のものとして数えます。通貨ペアで絞っているEAでも、番号が同じだと後からログを追うときに区別できません。どちらの意味でも、分けておくほうが安全です。

命名規則の作り方

番号は自由に決められますが、思いつきの連番にすると、半年後にログを見たときにどれがどのEAか分からなくなります。桁ごとに意味を割り当てておくと、番号を見るだけで内容を読み取れます。

代表的な作り方が「EA種別2桁＋通貨ペア2桁＋時間足1桁」という並べ方です。例として 120501 という番号を分解します。

この例では 120501 は「グリッド系EA・XAUUSD・M15」を意味します。時間足の桁は、扱う時間足が9本以内なら1桁、余裕を持たせるなら2桁にしてください。対応表そのものは自分で決めて構いません。重要なのは、決めた対応表をEA一覧と同じ場所に残しておくことです。

マジックナンバー一覧表のテンプレート

稼働前に、次の形式の表を作ってください。番号の重複はこの表を作る段階で気づけます。

「想定最大ポジション数」の列を入れておくのがポイントです。この列の合計が、業者の保有ポジション数上限を超えていないかを事前に確認できます。EAの組み合わせが自分の資金や方針に合っているかを整理したい場合は、 EA適性診断 も使えます。

保有数の上限に関係するエラーコード

マジックナンバーを分けても、口座単位の上限は共有されます。上限に達したときのコードは次の通りです。

出典: MQL4 Error Codes / MQL5 Trade Server Return Codes （確認日 2026年9月24日）

ナンピン・グリッド系EAを複数通貨ペアで動かすと、この上限には簡単に到達します。事前に「EA数 × 想定最大ポジション数」を計算し、業者の上限内に収まるかを確認してください。上限値は業者・口座タイプによって異なるため、公式ドキュメントで確認してください。

MT4固有：146 Trade context is busy

MT4のトレードコンテキストはプロセス全体で1つしかありません。複数EAが同時に発注しようとすると衝突し、146 ERR_TRADE_CONTEXT_BUSY（"Trade context is busy"）が発生します。マジックナンバーの設計とは別の問題ですが、複数EA運用では必ず付いてくる論点です。

対処は2段階です。EA側では IsTradeContextBusy() をチェックし、Sleep() で待つループを入れます。根本的に避けるなら、EAごとに別フォルダへMT4をインストールし、別プロセスとして起動します。手順は MT4を複数起動して運用する方法 にまとめています。MT5はマルチスレッドのため、この問題は発生しません。

よくある失敗

1. チャートに適用するたびに番号を変えるのを忘れる。 2本目以降のインスタンスで初期値のまま OK を押してしまうパターンです。適用直後に、パラメータ画面を開き直して値を確認してください。
2. セットファイルを使い回して番号ごとコピーする。 .set ファイルにはマジックナンバーも含まれます。読み込んだ後に必ず番号を書き換えてください。
3. ポジションを持ったまま番号を変更する。 変更前のポジションがEAから見えなくなり、決済されずに残ります。停止・全決済してから変更してください。
4. 一覧表を作らずに記憶で運用する。 EAが3本を超えると記憶では管理できません。表にして、口座情報と同じ場所に保存してください。

発注が拒否されている場合は、 MT4/MT5の注文エラーコード一覧 でコードの意味を確認できます。EAが動いているのに取引しない場合は EAが動かないときのチェックリスト が出発点になります。

まとめ

マジックナンバーは、EAが自分の注文を識別するための整数IDです。守るルールは「ユニークにする」「0を使わない」「通貨ペアごとに分ける」の3つで、これを稼働前の一覧表で担保します。

重複したときに壊れるのはカウント処理だけではありません。ロット計算、段数判定、決済ロジックまで連鎖して狂い、しかもログ上は正常に見えます。だからこそ、稼働後に気づくのではなく、稼働前の表で潰しておく種類の設定です。

複数EA運用を前提にするなら、あわせて EAは何本まで同時に動かせるか で本数の考え方を、 EAを停止する判断基準 で撤退ルールを決めておいてください。導入手順全体は EAの入れ方 に戻って確認できます。