MQL4が書ける人向け、標準ライブラリーを使ったMQL5プログラミング、注文編

11459 ワード
MT5 MQL5 MQL4 CTrade MT4 MQL4 テキストリンク

　この記事ではMT4からMT5へ移行を考えている開発者に向けて、MT5で注文を出すプログラムの書き方の一つの例を紹介しています。MQL5で通常使われる専用構造体を使った注文方法ではなく、これまでMQL4だけを書いてきたプログラマーにとっては比較的にわかりやすい方法かなと思う標準ライブラリーを使った注文方法を解説します。

MQL4とMQL5の注文の出し方の違い

MQL4で注文を出す書き方は

対してMQL5で注文を出す書き方は
※今回は覚える必要はありません

   MqlTradeRequest Request;
   MqlTradeResult Result;

   ZeroMemory(Request);
   ZeroMemory(Result);

   Request.action = TRADE_ACTION_DEAL;                   // 取引の種類
   Request.magic = Magic;                                // マジックナンバー
   Request.symbol = _Symbol;                             // 通貨ペア
   Request.volume = Lots;                                // ロット数
   Request.type = ORDER_TYPE_BUY;                        // 注文タイプ
   Request.price = SymbolInfoDouble(_Symbol,SYMBOL_ASK); // 価格
   Request.sl = 0;                                       // sl
   Request.tp = 0;                                       // tp
   Request.deviation = Slippage;                         // スリッページ
   Request.comment = NULL;                               // コメント
   Request.type_filling = OrderTypeFilling;              // 注文実行の種類

   OrderSend(Request,Result);

　MQL5の方が細かい設定ができたり慣れると便利ですが、MQL4に慣れている人にとっては、使いづらさを感じる仕様になっているようにも思います。

MQL5で標準ライブラリーを使った注文の出し方


　このように標準ライブラリーを使用するとMQL4に近い感覚で注文コードを書くことができます。

　それでは詳しく注文を出す手順を確認していきましょう。

　今回はMT5に標準ライブラリーとして用意されているCTradeというクラスを呼び出して注文を出すプログラムを書いていきます。CTradeにはMQL4に近いタイプの注文関数が多く用意されています。

　まずクラスを呼ぶためにCTradeが書かれたファイルTrade.mqhを#includeで読み込みます。

 #include <Trade\Trade.mqh>

　次に通常のクラスの使い方と同じく、クラス名を指定してオブジェクトを生成します。オブジェクト名は任意でOKです。

　これで『オブジェクト名.関数』という形でCTrade内のメンバ関数を使えるようになるわけですが、


　MQL4の注文関数と比較するとMQL5のCTrade関数にはマジックナンバーとスリッページを指定する引数がないです。CTradeの仕様でマジックナンバーとスリッページはプログラム内で一度だけ設定すれば、その後の注文すべてに適応することになっています。

　マジックナンバーやスリッページは注文ごとに値を変更することは基本的にしないのでこの方が便利ですね。

次に決済するための関数について

　決済は主にこの関数を使います。1ポジションしか持たないEAであれば、ポジションチケットを指定する代わりに通貨ペアを書くだけでOKです。

　分割決済する場合は

　こっちの関数を使います。

実際に動作させてみる

　今回は動作確認のため
「EAを起動させるとすぐに買いポジションを持って、ローソク終値が確定すると決済する」
というプログラムを書いています。

#include <Trade\Trade.mqh>

sinput ulong  Magic = 12345;  // マジックナンバー
sinput ulong  Slippage = 20;  // スリッページ
sinput double Lots = 0.1;     // ロット数

CTrade ExtTrade; // オブジェクト生成

int OnInit()
  {
   // EAの初期設定
   ExtTrade.SetExpertMagicNumber(Magic);    // マジックナンバーの設定
   ExtTrade.SetDeviationInPoints(Slippage); // スリッページの設定

   // 新規注文
   ExtTrade.PositionOpen(_Symbol,ORDER_TYPE_BUY,Lots,SymbolInfoDouble(_Symbol,SYMBOL_ASK),0,0,NULL);

   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   // ローソク終値が確定したら決済
   static datetime time = iTime(_Symbol,PERIOD_CURRENT,0);

   if(time != iTime(_Symbol,PERIOD_CURRENT,0))
      ExtTrade.PositionClose(_Symbol,Slippage);
  }


　正しく動作しました。

MQL5の仕様の注意点

　MQL4のOrderSend関数は戻り値がチケット番号でしたが、MQL5の注文関数の戻り値は注文が成功したときにtrue、失敗したときにfalseとなります。

　MT5ではMT4でいうチケット番号が
1. オーダーチケット
2. ディールチケット
3. ポジションチケット

この3つに該当します。MT5からディールというものが追加されたことによるためですが、それぞれどう違うのかというと

　端末から送信された注文はまだ約定するかどうかわからない状態で、実際は価格が少しずれたり、分割して約定したりすることもあるので、ここを厳密にするためディールというものが新たに追加されています。

上で動作させたEAで
1. オーダーチケット
2. ディールチケット
3. ポジションチケット
がそれぞれどうなっていたかを確認してみます。


　新規注文のオーダーチケットとポジションチケットは同じで、他はすべて別々の番号が割り振られています。ポジションチケットを取得する方法はいろいろありますが、CTradeでは直近の注文のオーダーチケットを取得する関数が用意されているので、ポジションチケットが必要な場合は、それを利用するのもいいかもしれません。

　最後にCTradeの公式のリファレンスサイトのURLを貼っておきます。この記事で紹介したもの以外にもたくさん関数が用意されているので使う人には必須のサイトです。

続きの記事はこちら↓