【MQL5入門】OrderSendの構造体を毎回書くのは冗長?CTradeクラスのBuy()/Sell()で発注を1行にする方法

MQL5で成行注文を送るとき、前回の記事では`MqlTradeRequest`構造体に`action`や`symbol`、

`type_filling`まで1つずつフィールドを埋めてから`OrderSend(request, result)`を呼ぶ、

という手順を解説しました。

これは公式の書き方として間違いではありませんが、毎回同じ初期化コードを書くのは正直面倒ですし、

フィールドを1つ埋め忘れただけで発注が拒否される、というミスも起きがちです。

実はMQL5の標準ライブラリには、この構造体を毎回自分で組み立てなくても、

`Buy()`や`Sell()`のようなメソッドを1行呼ぶだけで発注できる`CTrade`クラスが最初から用意されています。

この記事では、`CTrade`クラスを使って発注・決済を簡潔に書く方法を、

生の`OrderSend()`との対比で解説します。

CTradeクラスとは何か

`CTrade`は、MQL5をインストールすると`Include\Trade\Trade.mqh`に標準で同梱されているクラスです。

中身は結局のところ`MqlTradeRequest`/`MqlTradeResult`を組み立てて`OrderSend()`を呼んでいるだけなのですが、

その組み立て部分をクラスの内部に隠蔽し、開発者からは`Buy()`/`Sell()`/`PositionClose()`のようなメソッド呼び出しだけで済むようにしたものです。

“`
#include

CTrade trade;//グローバルスコープでインスタンス化するのが一般的
“`

`#include`でヘッダーを読み込み、`CTrade`型の変数(インスタンス)を1つ用意するだけで準備が完了します。

構造体を毎回`={}`で初期化する手間がなくなる点が、まず生の`OrderSend()`との一番の違いです。

発注前に一度だけ設定する項目

`CTrade`インスタンスには、発注のたびに指定しなくてよいように、

あらかじめ設定しておけるプロパティがいくつかあります。

`OnInit()`など、EAの初期化処理の中で1回呼んでおくのが定石です。

void OnInit()
  {
   trade.SetExpertMagicNumber(123456);          //マジックナンバー
   trade.SetDeviationInPoints(10);               //許容スリッページ(ポイント単位)
   trade.SetTypeFilling(ORDER_FILLING_FOK);       //注文執行方式
   trade.SetTypeFillingBySymbol(_Symbol);         //銘柄の対応状況から執行方式を自動選択(推奨)
  }

生の`OrderSend()`では`request.magic`や`request.type_filling`を毎回のリクエストに書いていましたが、

`CTrade`ではこれらを一度セットしておけば、以降の`Buy()`/`Sell()`呼び出しすべてに自動的に適用されます。

特に`SetTypeFillingBySymbol()`は、

その銘柄・ブローカーが対応している執行方式を自動判定してくれるメソッドで、

前回の記事で扱った「retcode 10030(Unsupported filling mode)」

のようなミスを未然に防ぎやすくなります。

主要メソッド: Buy() / Sell() / PositionClose()

発注・決済に使う主要メソッドは以下のとおりです。

CTradeの主なメソッド
  bool Buy(double volume, string symbol=NULL, double price=0, double sl=0, double tp=0, string comment=NULL)
  bool Sell(double volume, string symbol=NULL, double price=0, double sl=0, double tp=0, string comment=NULL)
  bool PositionClose(string symbol, ulong deviation=ULONG_MAX)
  bool PositionClose(ulong ticket, ulong deviation=ULONG_MAX)
  bool PositionModify(string symbol, double sl, double tp)
  bool OrderSend(const MqlTradeRequest &request, MqlTradeResult &result)  //生のリクエストも渡せる

`Buy()`/`Sell()`は`volume`(ロット数)だけが必須引数で、

`symbol`を省略すると現在のチャートの通貨ペアが使われ、

`price`を省略(0のまま)すると現在の成行価格で自動発注されます。

生の`OrderSend()`では`request.price = SymbolInfoDouble(_Symbol, SYMBOL_ASK)`のように自分で価格を取得する必要がありましたが、

`CTrade`ではその処理も内部で行われます。

//成行買い、0.01ロット、SL/TPは価格から100ポイント分
double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
double sl  = ask - 100 * _Point;
double tp  = ask + 100 * _Point;

if(!trade.Buy(0.01, _Symbol, 0, sl, tp))
  {
   Print("Buy()が失敗しました。retcode=", trade.ResultRetcode());
   return;
  }

生の`OrderSend()`では`MqlTradeRequest`・`MqlTradeResult`という2つの構造体を用意し、

`action`/`symbol`/`volume`/`type`/`price`/`sl`/`tp`/`deviation`/`magic`/`type_filling`と10個近いフィールドを埋めてから呼び出す必要がありました。

`CTrade`の`Buy()`は、それと同じ処理を1行にまとめています。

決済も同様に、ポジションを保有している通貨ペア名かチケット番号を渡すだけです。

//保有中のUSDJPYポジションを決済
if(!trade.PositionClose(_Symbol))
  {
   Print("PositionClose()が失敗しました。retcode=", trade.ResultRetcode());
  }

前回の記事(`position-select.md`)で扱った「決済は`type`を反対売買にして`position`フィールドにチケットを指定する」

という手順も、`CTrade`では`PositionClose()`の呼び出し1行に置き換わります。

結果の確認: ResultRetcode()を必ずチェックする

`Buy()`/`Sell()`が`true`を返しても、生の`OrderSend()`と同じく「サーバーに送信できた」

ことを保証するだけで、実際に約定したかどうかは別途確認が必要です。

`CTrade`では、直前の取引結果を`ResultRetcode()`や`ResultRetcodeDescription()`で取得できます。

if(!trade.Buy(0.01))
  {
   PrintFormat("Buy()自体が失敗しました。retcode=%d (%s)",
               trade.ResultRetcode(), trade.ResultRetcodeDescription());
   return;
  }

if(trade.ResultRetcode() != TRADE_RETCODE_DONE)
  {
   PrintFormat("注文は拒否されました。retcode=%d (%s)",
               trade.ResultRetcode(), trade.ResultRetcodeDescription());
   return;
  }

PrintFormat("成行買い成立: order=%d deal=%d price=%.5f",
            (int)trade.ResultOrder(), (int)trade.ResultDeal(), trade.ResultPrice());

生の`OrderSend()`では`result.retcode`や`result.comment`のように`MqlTradeResult`構造体のフィールドを直接参照していましたが、

`CTrade`では`ResultRetcode()`/`ResultRetcodeDescription()`/`ResultOrder()`/`ResultDeal()`/`ResultPrice()`といったメソッド呼び出しに置き換わります。

`ResultRetcodeDescription()`はretcodeの数値だけでなく人間が読める説明文字列も返してくれるため、

ログを見たときに原因を把握しやすくなる点は生の構造体にはない利点です。

CTradeを使うと安全になる理由、生OrderSendで陥りがちなミス

生の`OrderSend()`を直接使う場合、`MqlTradeRequest`を`={}`で0初期化し忘れる、

`action`フィールドの指定漏れ、`type_filling`にブローカー非対応の値を指定してしまう、

といった「構造体を手組みするからこそ起きるミス」が発生します。

特に決済処理では、`request.position`にチケット番号を指定し忘れたまま`TRADE_ACTION_DEAL`を送ってしまい、

決済のつもりが新規の逆ポジションを建ててしまう、という事故が起きやすいポイントです。

`CTrade`の`PositionClose()`は、内部で該当ポジションのチケットを自動的に解決してから決済リクエストを組み立てるため、

この種の「決済のつもりが新規発注になっていた」というミスが構造的に起きません。

もちろん`CTrade`は万能ではなく、複雑な条件分岐(部分決済の数量計算、

複数の予約注文を組み合わせた両建て戦略など)を書く場合は、結局内部で何が起きているかを理解しておく必要があります。

その意味で、前回の記事で解説した生の`OrderSend()`とMqlTradeRequest構造体の知識は無駄になりません。

「まず`CTrade`で書き、`CTrade`のメソッドでは表現できない特殊なリクエストが必要になったときだけ生の`OrderSend()`に降りる」

という使い分けが実務的です。

実際に動くコード全体

ここまでの内容をまとめた、成行買い注文を1回送信し、保有ポジションがあれば決済する、

実際にMetaEditorでコンパイルできるスクリプトです。

実際に注文を送信・決済するコードのため、動作確認は必ずデモ口座で行ってください。

//+------------------------------------------------------------------+
//|                                             CTradeDemo.mq5        |
//|                     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 script_show_confirm

#include 

input double Lots        = 0.01;//ロット数
input int    SlPoints    = 100;//損切り幅(ポイント)
input int    TpPoints    = 100;//利確幅(ポイント)
input int    Deviation   = 10;//許容スリッページ(ポイント)
input long   MagicNumber = 123456;//マジックナンバー
input bool   CloseAfter  = false;//trueにすると発注直後に同じ銘柄のポジションを決済する

CTrade trade;

//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
   trade.SetExpertMagicNumber(MagicNumber);
   trade.SetDeviationInPoints(Deviation);
   trade.SetTypeFillingBySymbol(_Symbol);//銘柄が対応する執行方式を自動選択

   double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
   double sl  = ask - SlPoints * _Point;
   double tp  = ask + TpPoints * _Point;

   if(!trade.Buy(Lots, _Symbol, 0, sl, tp))
     {
      PrintFormat("Buy()自体が失敗しました。retcode=%d (%s)",
                  trade.ResultRetcode(), trade.ResultRetcodeDescription());
      return;
     }

   if(trade.ResultRetcode() != TRADE_RETCODE_DONE)
     {
      PrintFormat("注文は拒否されました。retcode=%d (%s)",
                  trade.ResultRetcode(), trade.ResultRetcodeDescription());
      return;
     }

   PrintFormat("成行買い成立: order=%d deal=%d price=%.5f",
               (int)trade.ResultOrder(), (int)trade.ResultDeal(), trade.ResultPrice());

   if(CloseAfter)
     {
      if(!trade.PositionClose(_Symbol))
        {
         PrintFormat("PositionClose()が失敗しました。retcode=%d (%s)",
                     trade.ResultRetcode(), trade.ResultRetcodeDescription());
         return;
        }
      Print("ポジションを決済しました。");
     }
  }
//+------------------------------------------------------------------+

MetaEditorで実際に動かす手順

1. MetaTrader 5の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
2. 「ファイル」→「新規作成」→「スクリプト」を選び、名前を「CTradeDemo」にして作成する(中身は空のテンプレートで構いません)
3. テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
4. F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する(`#include `はMT5に標準同梱のため、追加のダウンロードは不要です)
5. MT5でデモ口座を選択していることを確認したうえで、ナビゲーターパネルからスクリプトをチャートへドラッグ&ドロップする(入力パラメーターの確認画面が出るので、決済まで試したい場合は`CloseAfter`をtrueにしてOKを押す)
6. 「表示」→「ツールボックス」の「取引」タブに新規ポジションが表示されれば成功です

よくあるエラーと対処

• コンパイルエラー「’Trade.mqh’ file not found」: `#include`のパス区切りが正しいか確認してください。`#include `のように、Windows形式のバックスラッシュを使う必要があります(スラッシュでも動く場合がありますが、公式サンプルに合わせてバックスラッシュを推奨します)
• retcodeが「10030(Unsupported filling mode)」: `SetTypeFillingBySymbol()`を呼ばずに`SetTypeFilling()`で固定の執行方式を指定していると起きやすいミスです。特別な理由がなければ`SetTypeFillingBySymbol(_Symbol)`を使ってください
• `PositionClose()`が`false`を返すのに保有ポジションはある: ヘッジ口座で同じ通貨ペアに複数ポジションがある場合、`PositionClose(string symbol)`はどれか一方しか決済できないことがあります。前回の記事(`position-select.md`)で解説した`PositionGetTicket()`でチケットを特定し、`PositionClose(ulong ticket)`のチケット版を使ってください
• `trade.ResultRetcode()`が常に0を返す: `Buy()`/`Sell()`を一度も呼んでいない状態で`ResultRetcode()`だけ呼んでも意味のある値は返りません。必ず発注メソッドの直後に確認してください

まとめ

MQL5の`CTrade`クラスを使うと、生の`OrderSend()`で毎回必要だった`MqlTradeRequest`/`MqlTradeResult`構造体の組み立てが、

`Buy()`/`Sell()`/`PositionClose()`のメソッド1行に置き換わります。

`SetExpertMagicNumber()`や`SetTypeFillingBySymbol()`で発注前の共通設定をまとめて済ませられる点、

`ResultRetcodeDescription()`で人間が読めるエラー説明を取得できる点も、

生の構造体にはない実務上のメリットです。

一方で、`CTrade`のメソッドで表現しきれない特殊な発注(複雑な部分決済・両建て戦略など)では、

結局は前回の記事で扱った生の`OrderSend()`とMqlTradeRequest構造体の知識が必要になります。

まずは`CTrade`で書き始め、必要になったときだけ生の`OrderSend()`に降りる、

という使い分けを意識してください。

関連記事

• 【MQL5入門】OrderSendの引数が1個の構造体に?MqlTradeRequestで新規注文を送信する方法(MQL4版との違い)
• 【MQL5入門】MQL4のOrderSelectは使えない?ポジション情報を取得するPositionSelect・PositionGetDouble/PositionGetIntegerの使い方
• 【MQL言語入門】MQL4とMQL5の違いや移植・変換方法についてまとめてみた