atr-trailing-stop-ea-mt4.mdや、
parabolic-sar-trailing-stop-ea.mdなど、
このサイトのトレーリングストップ系EAの記事では、
これまで`OrderModify()`を当たり前のように使ってきました。
ですが、この関数自体のシグネチャや、
なぜ時々失敗するのかを単独で解説した記事はまだありませんでした。
この記事では、`OrderModify()`の6つの引数、
開いているポジションに対して`price`に何を渡すべきかという落とし穴、
そして「エラー1」が実際に何を意味するのかを、
公式リファレンスの記載に基づいて整理します。
- なぜOrderModify()は使われてきたのに単独記事が無かったのか
- OrderModify()のシグネチャと6つの引数
- 落とし穴①:開いているポジションのpriceには何を渡すべきか
- 落とし穴②:エラー1(ERR_NO_RESULT)が出る本当の理由
- 落とし穴③:ストップレベルとフリーズレベルによる失敗
- 実際に動くコード全体:SLを建値+Nポイントへ安全に移動するEA
- コピペしてコンパイルが通らない・SLが動かないときに確認すること
- よくある質問
- 【MQL4】OrderModify()でストップロス・テイクプロフィットを書き換える方法について解説してみた(エラー1の正体とpriceパラメータの落とし穴):まとめ
なぜOrderModify()は使われてきたのに単独記事が無かったのか
まず、この記事が解決する範囲を整理します。
既刊記事群での使われ方
Parabolic SARトレーリングストップEAの記事では、
計算済みの新しいストップロス価格を、
`OrderModify()`に渡して注文を書き換える、
という使い方を解説してきました。
この記事が解決する範囲:関数そのものの仕様
本記事では、個別のトレーリング戦略ではなく、
`OrderModify()`という関数そのものの、
引数の意味・戻り値・代表的な失敗パターンに絞って解説します。
この記事で分かること: 開いているポジションの`price`に何を渡すべきか、
「エラー1」が出る本当の理由、
MODE_STOPLEVEL・MODE_FREEZELEVELによる、
変更禁止ゾーンの3点です。
OrderModify()のシグネチャと6つの引数
ここから、関数の中身を見ていきます。
シグネチャ全文
公式リファレンス(OrderModify)によると、シグネチャは次の通りです。
bool OrderModify( int ticket, //修正したい注文のチケット番号 double price, //保留注文の新しい開始価格(開いているポジションでは変更不可) double stoploss, //新しいストップロス double takeprofit, //新しいテイクプロフィット datetime expiration, //保留注文の有効期限(開いているポジションでは無視される) color arrow_color //チャート上の矢印の色、CLR_NONEなら非表示 );
各引数の役割
| 引数 | 開いているポジション | 保留注文 |
|---|---|---|
| price | 変更不可(後述) | 新しい開始価格に変更できる |
| stoploss | 新しいSLに変更できる | 新しいSLに変更できる |
| takeprofit | 新しいTPに変更できる | 新しいTPに変更できる |
| expiration | 無視される | 新しい有効期限に変更できる |
戻り値とGetLastError()
戻り値は、変更に成功すれば`true`、
失敗すれば`false`です。
失敗した理由を知るには、
直後に`GetLastError()`を呼んで確認します。
GetLastError()の記事で解説した通り、
一度取得したエラーコードは次の取引関数呼び出しまでリセットされないため、
`OrderModify()`が`false`を返した直後に呼ぶ必要があります。
落とし穴①:開いているポジションのpriceには何を渡すべきか
最初につまずきやすいのが、`price`引数です。
保留注文と開いているポジションで意味が違う
保留注文(Buy Limit等)に対して`price`を渡す場合、
それは「新しい開始価格」として扱われ、
実際にその価格へ変更されます。
ところが、すでに約定済みの、
開いているポジションに対して同じ`price`引数を渡しても、
挙動が全く異なります。
公式リファレンスの明記:開始価格は変更できない
注意: 公式リファレンス(OrderModify)には、
開いているポジションに対して`price`は変更できないこと、
開始価格と有効期限は「保留注文のみ」変更可能であることが明記されています。
さらに、変更されない値(現在と同じ値)を渡すと、
エラー1が生成されるとも明記されています。
対処:OrderOpenPrice()をそのまま渡す
このため、開いているポジションのSL・TPだけを変更したい場合は、
`price`に`OrderOpenPrice()`(その注文の現在の開始価格)を、
そのまま渡すのが実務上の定石です。
//開いているポジションのSLだけを安全に書き換える例
bool ok = OrderModify(
OrderTicket(),
OrderOpenPrice(), //開始価格は変更しないのでそのまま渡す
newStopLoss,
OrderTakeProfit(),
0,
clrNONE
);
補足: 公式リファレンスは、
「開いているポジションの`price`は変更できない」と明記していますが、
渡す値そのものに何を使うべきかまでは断定していません。
`OrderOpenPrice()`を渡す書き方は、
コミュニティで広く使われている定石であり、
本記事もこれに従いますが、公式の断定ではない点は開示しておきます。
落とし穴②:エラー1(ERR_NO_RESULT)が出る本当の理由
次によく遭遇するのが、エラー1です。
エラー1の正式な説明
公式リファレンス(エラーコード)によると、
エラー1の正式名称は`ERR_NO_RESULT`で、
説明文は、
「No error returned,
but the result is unknown」
(エラーは返されていないが、結果が不明)です。
「変更なし」を検知してから呼ぶ防御的な書き方
前の節で見た通り、`OrderModify()`は、
渡した値が現在の値と同じ(=実質的に変更が無い)場合に、
このエラー1を返す仕様です。
これはバグではなく、
「変更する必要が無い呼び出しだった」ことを示すコードだと理解しておくと、
不要なアラートやログを減らせます。
//現在値と同じなら呼ばない、という防御的な書き方
if(MathAbs(OrderStopLoss() - newStopLoss) > Point)
{
OrderModify(OrderTicket(), OrderOpenPrice(), newStopLoss, OrderTakeProfit(), 0, clrNONE);
}
既刊エラーコード一覧記事との関係
エラーコード一覧の記事では、
番号帯でのカテゴリ分類を解説しましたが、
エラー1個別の「変更なし」という実務的な意味までは、
掘り下げていませんでした。
本記事はその個別記事という位置づけになります。
落とし穴③:ストップレベルとフリーズレベルによる失敗
値自体を変えていても失敗するケースがあります。
MODE_STOPLEVEL:現在値との最小距離
`MODE_STOPLEVEL`は「Stop level in points」
(ポイント単位のストップレベル)で、
現在値からSL・TPまでの最小距離を表します。
この距離より近い位置にSL・TPを設定しようとすると、
エラー130(`ERR_INVALID_STOPS`)になります。
MODE_FREEZELEVEL:変更禁止ゾーン
同じページによると、`MODE_FREEZELEVEL`は、
「実行価格がこの範囲内にある場合、注文は変更・取消・決済ができない」、
というもう1つの距離の制限です。
ストップレベルとは別に、
現在値に近すぎるタイミングでの変更そのものがブロックされる、
という点が異なります。
用語の違い: STOPLEVELは「どこまで近づけてよいか」、
FREEZELEVELは「今このタイミングで変更してよいか」を判定する値です。
フリーズレベル内での変更時に具体的に何番のエラーが返るかは、
公式リファレンスに明記が無いため、本記事では断定しません。
既刊ATRトレーリングストップEAとの接続
ATRトレーリングストップEAの記事のように、
ティックごとにSLを動かし続けるEAでは、
この2つの距離チェックを呼び出し前に行っておくことで、
無駄な`OrderModify()`呼び出しと、
それに伴うエラーログの増加を減らせます。
実際に動くコード全体:SLを建値+Nポイントへ安全に移動するEA
ここまでの要素をまとめた、実際にMetaEditorでコンパイルできるコードです。
//+------------------------------------------------------------------+
//| SafeBreakevenModify.mq4 |
//| Copyright 2026, FX-EA System Project Creator |
//| https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property copyright "Copyright 2026, FX-EA System Project Creator"
#property link "https://creator.fx-ea-system-project.com/"
#property version "1.00"
#property strict
input int InpTriggerPips = 10;//このpipsだけ利益が出たらSLを動かす
input int InpLockPips = 2; //建値からこのpipsだけ有利な位置にSLを置く
//+------------------------------------------------------------------+
//| ストップレベル・フリーズレベルを満たしているか確認する |
//+------------------------------------------------------------------+
bool IsSafeDistance(double newStopLoss)
{
double minDistance = MarketInfo(Symbol(), MODE_STOPLEVEL) * Point;
double freezeDistance = MarketInfo(Symbol(), MODE_FREEZELEVEL) * Point;
double dist = MathAbs(Bid - newStopLoss);
return(dist > minDistance && dist > freezeDistance);
}
//+------------------------------------------------------------------+
//| 1件のBuyポジションを、条件を満たせば建値+ロックpipsへ移動する |
//+------------------------------------------------------------------+
void TryMoveToBreakeven()
{
for(int i = 0; i < OrdersTotal(); i++)
{
if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
continue;
if(OrderSymbol() != Symbol() || OrderType() != OP_BUY)
continue;
double profitPips = (Bid - OrderOpenPrice()) / Point;
if(profitPips < InpTriggerPips)
continue;
double newSl = OrderOpenPrice() + InpLockPips * Point;
//現在のSLと変わらないなら呼ばない(エラー1の予防)
if(MathAbs(OrderStopLoss() - newSl) <= Point)
continue;
if(!IsSafeDistance(newSl))
{
Print("ストップ/フリーズレベルに近すぎるため今回は見送りました");
continue;
}
bool ok = OrderModify(
OrderTicket(),
OrderOpenPrice(), //開いているポジションなので開始価格はそのまま渡す
newSl,
OrderTakeProfit(),
0,
clrNONE
);
if(!ok)
Print("OrderModifyに失敗しました。エラーコード=", GetLastError());
}
}
//+------------------------------------------------------------------+
//| Expert tick function |
//+------------------------------------------------------------------+
void OnTick()
{
TryMoveToBreakeven();
}
//+------------------------------------------------------------------+
補足: このサンプルは`OP_BUY`のみを対象にしています。
`OP_SELL`に対応させる場合は、
`profitPips`の計算式を、
`(OrderOpenPrice() – Bid) / Point`に、
`newSl`の計算式を、
`OrderOpenPrice() – InpLockPips * Point`に、
それぞれ符号を反転させれば同じ構造のまま拡張できます。
MetaEditorで実際に動かす手順
- MT4の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
- 「ファイル」→「新規作成」→「Expert Advisor(テンプレートを使用)」を選び、名前を「SafeBreakevenModify」にして作成する
- テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
- F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- デモ口座でBuyポジションを1つ持った状態でチャートへドラッグ&ドロップし、一定pipsの利益が出た時点でSLが建値付近へ動くことを確認する
コピペしてコンパイルが通らない・SLが動かないときに確認すること
- コンパイルエラーになる: 引数の順番(ticket/price/stoploss/takeprofit/expiration/arrow_color)を公式シグネチャ通りに渡しているか確認する
- SLが全く動かない: `profitPips`が`InpTriggerPips`を超えているか、OrderSymbol()が現在のチャートのSymbol()と一致しているかを確認する
- エラー1がログに出る: 渡した`newSl`が既存のSLと実質的に同じ値になっていないか確認する(本記事の落とし穴②)
- エラー130が出る: `MarketInfo(Symbol(), MODE_STOPLEVEL)`の値より近い位置にSLを設定しようとしていないか確認する
- 開始価格が変わってしまう・意図せず失敗する: 開いているポジションに対して`price`に`OrderOpenPrice()`以外の値を渡していないか確認する
よくある質問
OrderModify()についてよく検索されている疑問を、3つにまとめて回答します。
保留注文の開始価格も同じ関数で変更できますか?
できます。保留注文(Buy Limit・Sell Stop等)に対しては、
`price`引数を新しい開始価格として渡すことで、
開始価格そのものを変更できます。
この点が、開いているポジションとの最大の違いです。
フリーズレベル内で変更しようとすると何が起こりますか?
公式リファレンスには「変更・取消・決済ができない」とだけ明記されており、
具体的に返るエラー番号までは記載がありません。
本記事ではこの点を断定せず、
フリーズレベルの距離を自分で先にチェックしておく設計を推奨します。
MQL5にもOrderModify()という同名関数はありますか?
MQL5には`OrderModify()`という同名関数はありません。
開いているポジションのSL・TP変更は`PositionModify()`、
保留注文の変更は`OrderSend()`に、
`MqlTradeRequest`構造体を渡す方式に分かれています。
MQL5版の損益分岐点ストップを解説しています。
【MQL4】OrderModify()でストップロス・テイクプロフィットを書き換える方法について解説してみた(エラー1の正体とpriceパラメータの落とし穴):まとめ
この記事では、既刊のトレーリングストップ系EA群で、
これまで「使うだけ」だった`OrderModify()`を単独で解説しました。
ポイントは、開いているポジションの`price`には、
`OrderOpenPrice()`をそのまま渡すこと、
エラー1は「変更が実質無かった」ことを示す仕様であること、
MODE_STOPLEVEL・MODE_FREEZELEVELという2つの距離制限を、
呼び出し前に自分でチェックしておくと安全なことの3点です。
既刊のトレーリングストップ系EAを読んだ後に、
この記事で関数自体の仕様を押さえておくと、
エラーログが出たときの原因特定が速くなります。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント