【MQL5】CalendarEventByCurrency関数の使い方と自動売買実装コード

1. CalendarEventByCurrency関数の概要と実務での活用法

MQL5に搭載された「経済指標カレンダー」機能は、外部サイトからスクレイピングすることなく、MetaTrader 5（MT5）内部で直接ニュースデータを取得できる非常に強力なツールです。その中でも CalendarEventByCurrency は、特定の通貨（USD、JPYなど）に関連する「イベント定義」をまとめて取得する関数です。

実務での活用シーン

実務トレードにおいて、この関数は主に以下の目的で使用されます。
* イベントIDの特定: 特定のニュース（例：米雇用統計）がどのようなIDで管理されているかを知る。
* 動的なフィルタリング: 「USD」や「EUR」に関連する指標だけを抽出し、その重要度（Importance）に応じてEAの稼働を停止させるロジックの土台を作る。

開発者がつまずきやすいポイント

多くの初心者は、この関数だけで「明日の21時30分に指標がある」という具体的なスケジュール（日時）まで取得できると誤解しがちです。しかし、この関数が返すのはあくまで「イベントのカタログ（定義）」です。「いつ、その指標が発表されるか」という具体的な数値やスケジュールを取得するには、後述する別の関数（CalendarValueHistoryなど）と組み合わせて使用する必要があります。

2. 構文と戻り値

CalendarEventByCurrency 関数の基本的な構造は以下の通りです。

構文

bool  CalendarEventByCurrency(
   const string           currency,      // 通貨名 (例: "USD", "JPY", "EUR")
   MqlCalendarEvent&      events[]       // イベント構造体を受け取る配列
   );

パラメーター

1. currency: 取得したい通貨のコードを文字列で指定します。空文字を指定した場合は、全ての通貨のイベントが対象となります。
2. events[]: MqlCalendarEvent 型の動的配列を渡します。関数が成功すると、この配列に該当するイベントの情報が格納されます。

戻り値

• true: データの取得に成功した場合。
• false: 失敗した場合。エラーの詳細は GetLastError() で確認します。

MqlCalendarEvent構造体の主な中身

この構造体には、イベントのID、通貨、重要度（ENUM_CALENDAR_EVENT_IMPORTANCE）、イベント名などが含まれています。

3. 具体的な使い方・実践サンプルコード

以下は、特定の通貨（例：USD）に関連する経済指標のリストを取得し、その「イベント名」と「重要度」をエキスパートログに出力するシンプルなスクリプト形式のコードです。

//+------------------------------------------------------------------+
//|                                     CheckCalendarEvents.mq5      |
//|                                  Copyright 2024, Quant Engineer  |
//+------------------------------------------------------------------+
void OnStart()
{
   // 1. イベント情報を格納するための動的配列を宣言
   MqlCalendarEvent events[];

   // 2. 指定した通貨（例：USD）のイベントカタログを取得
   // 成功するとevents配列にデータが入り、戻り値がtrueになる
   if(CalendarEventByCurrency("USD", events))
   {
      PrintFormat("USDに関連するイベントを %d 件取得しました。", ArraySize(events));

      // 3. 取得したイベントの一部（最初の10件）をループで確認
      int displayCount = MathMin(10, ArraySize(events));
      for(int i = 0; i < displayCount; i++)
      {
         string importanceStr = EnumToString(events[i].importance);

         // ログに出力
         PrintFormat("ID: %lld | 名前: %s | 重要度: %s", 
                     events[i].id, 
                     events[i].name, 
                     importanceStr);
      }
   }
   else
   {
      // 失敗した場合はエラーコードを表示
      Print("カレンダーデータの取得に失敗しました。エラーコード: ", GetLastError());
   }
}

実践的なアドバイス

このサンプルで取得した events[i].id をメモしておき、CalendarValueHistory 関数などの引数に渡すことで、その特定の指標が「過去にいつ発表されたか」「将来いつ発表されるか」という具体的な日時データを取得できるようになります。

4. 使用上の注意点とよくあるエラー

① カレンダーデータの同期遅延

MT5を起動した直後は、内部の経済指標データベースがサーバーと同期されていないことがあります。この状態で関数を呼び出すと、配列のサイズが 0 で返ってくることがあります。EAに組み込む際は、データが取得できるまで数回リトライするロジックを含めるのが安全です。

② 「イベント」と「バリュー」の混同

先述の通り、CalendarEventByCurrency は「米雇用統計とは何か」というマスター情報を取るためのものです。「次回の雇用統計は何時か？」を知りたい場合は、この関数で得た event_id を使って CalendarValueHistoryByEvent を呼び出す必要があります。 この2段構えのステップを理解することが、MQL5カレンダー制御の最大の壁です。

③ 通貨コードの指定ミス

"usd"（小文字）ではなく "USD"（大文字）で指定するのが無難です。また、存在しない通貨コードを指定してもエラーにはなりませんが、配列サイズが 0 で返ってくるため、必ず ArraySize() でチェックを行いましょう。

5. 【重要】自動売買における約定スピードと環境の罠

経済指標を利用したロジックや、指標時のボラティリティを回避するロジックを組む際、コードの正確さと同じくらい重要なのが「ネットワークの物理的な距離」です。自宅のPCや一般的な光回線で自動売買を行う場合、どんなに優れたアルゴリズムであっても、数ミリ秒から数百ミリ秒の遅延（レイテンシ）が発生します。

指標発表時は一瞬でスプレッドが拡大し、価格が飛ぶように動きます。このとき、ネットワーク遅延がある環境では「意図した価格で約定しない（スリッページ）」「リクオート（再指値）でチャンスを逃す」といった事態が頻発し、バックテストの結果とはかけ離れた致命的な損失を招くリスクがあります。極限まで約定スピードを高め、プロ水準のトレード環境を構築するには、証券会社のサーバーに近いデータセンターに設置された「専用のVPS」を利用することが不可欠です。インフラを整えることは、もはやテクニカル指標の選定以上に、システムトレードの勝率を左右する決定的な要因といえます。