CTrade::Buy() の使い方・引数・戻り値（MQL5）

CTrade::Buy() とは

CTrade クラスで、成行の買い注文を出すメソッドです。ロット数だけ指定すれば、チャートの銘柄を現在の Ask で買います。MQL4 の OrderSend() に近い感覚で、1行で発注できます。

CTrade::Buy() の書式と引数

bool CTrade::Buy(
   const double volume,
   const string symbol=NULL,
   double price=0.0,
   const double sl=0.0,
   const double tp=0.0,
   const string comment=""
)

戻り値

CTrade::Buy() の使い方（コード例）

#include <Trade\Trade.mqh>

CTrade trade;
trade.SetExpertMagicNumber(12345);
trade.SetDeviationInPoints(30);

double pip = (_Digits == 3 || _Digits == 5) ? _Point * 10 : _Point;
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
double sl  = NormalizeDouble(bid - 20 * pip, _Digits);
double tp  = NormalizeDouble(bid + 40 * pip, _Digits);

if(trade.Buy(0.1, _Symbol, 0.0, sl, tp, "my EA") && trade.ResultRetcode() == TRADE_RETCODE_DONE)
   Print("買い成功 deal=", trade.ResultDeal(), " 価格=", trade.ResultPrice());
else
   Print("買い失敗 ", trade.ResultRetcode(), " ", trade.ResultRetcodeDescription());

OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。

CTrade::Buy() の注意点

• マジックナンバーは事前に SetExpertMagicNumber() で設定しておきます。設定しないと 0 になります。
• Trade.mqh の CTrade は、成行注文の執行タイプ（FOK・IOC）を銘柄に合わせて自動で選ぶため、10030 エラーが出にくくなっています。
• 失敗するとエキスパートタブに CTrade::OrderSend のログが出ます。

MQL4 と MQL5 の違い

CTrade::Buy() でよく出るエラー

• MT5エラー10030注文の執行タイプ（フィリングモード）が銘柄に対応していない
• MT5エラー10016損切り・利確（ストップ）の価格が不正
• MT5エラー10014ロット数（取引数量）が不正
• MT5エラー10019証拠金が不足している
• MT5エラー10027MT5側で自動売買（アルゴリズム取引）が無効になっている

関連する関数

• CTrade::Sell()成行で売り注文を出す
• CTrade::PositionClose()ポジションを決済する
• CTrade::SetExpertMagicNumber()発注に付けるマジックナンバーを設定する
• CTrade::ResultRetcode()直前の注文のリターンコードを取得する
• OrderSend()新規注文（成行・指値・逆指値）を出す

CTrade クラス（MQL5）の関数一覧

• CTrade::Buy
• CTrade::Sell
• CTrade::BuyLimit
• CTrade::SellLimit
• CTrade::BuyStop
• CTrade::SellStop
• CTrade::PositionOpen
• CTrade::PositionClose
• CTrade::PositionClosePartial
• CTrade::PositionModify
• CTrade::OrderModify
• CTrade::OrderDelete
• CTrade::SetExpertMagicNumber
• CTrade::SetDeviationInPoints
• CTrade::SetTypeFilling
• CTrade::SetTypeFillingBySymbol
• CTrade::ResultRetcode
• CTrade::ResultRetcodeDescription
• CTrade::ResultOrder

← MQL関数リファレンスで、ほかの関数を探す