MQL4MQL5 MQL4 の注文関数
OrderSend()
- できること
- 新規注文（成行・指値・逆指値）を出す
- 対応
- MQL4・MQL5
OrderSend() とは
新しい注文を出す関数です。MQL4 では銘柄・売買の種類・ロット数・価格・損切り・利確などを引数に並べて呼び出し、成功すると注文のチケット番号が返ります。MQL5 では MqlTradeRequest 構造体に注文内容を入れて渡し、結果は MqlTradeResult 構造体で受け取ります。
OrderSend() の書式と引数
MQL4 の場合MT4
int OrderSend(
string symbol,
int cmd,
double volume,
double price,
int slippage,
double stoploss,
double takeprofit,
string comment=NULL,
int magic=0,
datetime expiration=0,
color arrow_color=clrNONE
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
symbol | string | 必須 | 注文する銘柄名。チャートの銘柄なら Symbol() または _Symbol。 |
cmd | int | 必須 | 注文の種類。OP_BUY（成行買い）、OP_SELL（成行売り）、OP_BUYLIMIT、OP_SELLLIMIT、OP_BUYSTOP、OP_SELLSTOP。 |
volume | double | 必須 | ロット数。口座の最小ロット・刻み幅に合わせた値にします。 |
price | double | 必須 | 注文価格。成行買いは Ask、成行売りは Bid。待機注文はその注文価格。 |
slippage | int | 必須 | 許容するスリッページ（ポイント単位）。5桁口座で 30 なら 3pips。 |
stoploss | double | 必須 | 損切り価格。付けないときは 0。 |
takeprofit | double | 必須 | 利確価格。付けないときは 0。 |
comment | string | NULL | 注文のコメント。ブローカーによって書き換えられることがあります。 |
magic | int | 0 | マジックナンバー。EA が自分の注文を見分けるための番号です。 |
expiration | datetime | 0 | 待機注文の有効期限。使わないときは 0。 |
arrow_color | color | clrNONE | チャートに表示する矢印の色。clrNONE なら表示しません。 |
戻り値（MQL4）
成功すると注文のチケット番号、失敗すると -1 を返します。失敗の理由は直後に GetLastError() で確認します。
MQL5 の場合MT5
bool OrderSend(
const MqlTradeRequest &request,
MqlTradeResult &result
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
request | const MqlTradeRequest & | 必須 | 注文内容を入れた構造体。action（TRADE_ACTION_DEAL など）、symbol、volume、type、price、sl、tp、deviation、magic、type_filling などを設定します。 |
result | MqlTradeResult & | 必須 | 結果を受け取る構造体。retcode（リターンコード）、order（注文チケット）、deal（約定チケット）、price（約定価格）などが入ります。 |
戻り値（MQL5）
リクエストの基本的なチェックに通って送信できれば true を返します。true でも注文が成立したとは限らないため、必ず result.retcode が TRADE_RETCODE_DONE（10009）または TRADE_RETCODE_PLACED（10008）かを確認します。
OrderSend() の使い方（コード例）
MQL4
// 成行で買い、損切り 20pips・利確 40pips を付ける
double pip = (_Digits == 3 || _Digits == 5) ? _Point * 10 : _Point;
double sl = NormalizeDouble(Bid - 20 * pip, _Digits);
double tp = NormalizeDouble(Bid + 40 * pip, _Digits);
int ticket = OrderSend(_Symbol, OP_BUY, 0.1, Ask, 30, sl, tp, "my EA", 12345, 0, clrBlue);
if(ticket < 0)
Print("OrderSend 失敗 error=", GetLastError());
else
Print("注文成功 ticket=", ticket);MQL5
// 成行で買い、損切り 20pips・利確 40pips を付ける
double pip = (_Digits == 3 || _Digits == 5) ? _Point * 10 : _Point;
double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
MqlTradeRequest req = {};
MqlTradeResult res = {};
req.action = TRADE_ACTION_DEAL; // 成行
req.symbol = _Symbol;
req.volume = 0.1;
req.type = ORDER_TYPE_BUY;
req.price = ask;
req.sl = NormalizeDouble(bid - 20 * pip, _Digits);
req.tp = NormalizeDouble(bid + 40 * pip, _Digits);
req.deviation = 30; // スリッページ（ポイント）
req.magic = 12345;
req.type_filling = ORDER_FILLING_IOC; // 銘柄が対応している執行タイプにする
if(!OrderSend(req, res) || (res.retcode != TRADE_RETCODE_DONE && res.retcode != TRADE_RETCODE_PLACED))
Print("注文失敗 retcode=", res.retcode, " ", res.comment);
else
Print("注文成功 order=", res.order, " deal=", res.deal);OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。
OrderSend() の注意点
- 損切り・利確はストップレベル（最小距離）より現在値から離す必要があります。近すぎると MT4 はエラー130、MT5 はリターンコード10016 になります。
- 価格は NormalizeDouble(価格, _Digits) で銘柄の桁数に丸めてから渡します。
- ロット数は最小ロット・最大ロット・刻み幅に合わせます。合っていないと MT4 はエラー131、MT5 は10014 になります。
- MT5 の成行注文では、銘柄が対応している執行タイプ（type_filling）を指定しないとリターンコード10030 になります。CTrade クラスを使うと自動で合わせてくれます。
- 自動売買が許可されていないと注文できません（MT4 はエラー4109、MT5 は10027）。
MQL4 と MQL5 の違い
MQL4 の OrderSend() は引数を11個並べて呼び、戻り値がチケット番号です。MQL5 の OrderSend() は MqlTradeRequest 構造体を渡し、戻り値は bool、結果は MqlTradeResult 構造体で受け取ります。
MQL5 で MQL4 に近い書き方をしたい場合は、CTrade クラスの Buy()・Sell() を使うと1行で発注できます。
