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

2026.03.03

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

MQL5のAlert関数は、メタトレーダー（MT5）の画面上にポップアップウィンドウを表示し、同時にアラート音を鳴らしてユーザーに特定の事象を通知するための関数です。

実務開発において、Alert関数は主に以下の2つのシーンで活用されます。

  1. 売買シグナルの通知: インジケーター開発において、条件が一致した瞬間に音と画面でユーザーに知らせます。裁量トレードの補助ツールとして非常に強力です。
  2. 異常事態の検知: EA（エキスパートアドバイザー）の運用中、予期せぬエラーや証拠金不足、致命的なスプレッドの拡大などが発生した際に、即座に人間に介入を促すための「緊急アラーム」として機能します。

初心者が陥りやすいミスとして、デバッグ（プログラムの修正）目的でAlertを多用してしまうことがあります。しかし、ポップアップが頻繁に出ると取引の邪魔になるため、内部的な動作確認にはターミナルの「操作履歴」にのみ記録されるPrint関数を使い、「人間が今すぐ知るべき重要な情報」にのみAlertを使うのがクオンツ流のスマートな設計です。

2. 構文と戻り値

Alert関数の仕様は非常にシンプルです。

構文

void Alert(
   argument,     // 最初の値（任意のデータ型）
   ...           // 追加の値（任意のデータ型）
);

パラメーター

  • argument: 表示したい内容を記述します。文字列（string）、数値（int/double）、論理値（bool）など、ほぼ全ての型をそのまま渡せます。
  • …（可変長引数）: カンマ区切りで複数のデータを渡すと、それらを連結して一つのメッセージとして表示します。

戻り値

  • なし (void): 実行して完了するだけの関数のため、戻り値はありません。

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

以下のコードは、短期移動平均線と長期移動平均線がゴールデンクロスした際に、一度だけアラートを鳴らす実戦的なEAのサンプルです。

//+------------------------------------------------------------------+
//|                                              AlertSample_EA.mq5  |
//|                                  Copyright 2024, Quant Engineer  |
//+------------------------------------------------------------------+
#property strict

// 入力パラメーター
input int FastMAPeriod = 10;  // 短期MA期間
input int SlowMAPeriod = 20;  // 長期MA期間

// グローバル変数
int fastMAHandle;
int slowMAHandle;
datetime lastAlertTime; // 多発防止用の時間管理変数

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
{
    // インジケーターのハンドルを取得
    fastMAHandle = iMA(_Symbol, _Period, FastMAPeriod, 0, MODE_SMA, PRICE_CLOSE);
    slowMAHandle = iMA(_Symbol, _Period, SlowMAPeriod, 0, MODE_SMA, PRICE_CLOSE);

    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
{
    double fastMA[2], slowMA[2];

    // 最新と1つ前のMA値を取得
    if(CopyBuffer(fastMAHandle, 0, 0, 2, fastMA) < 2) return;
    if(CopyBuffer(slowMAHandle, 0, 0, 2, slowMA) < 2) return;

    // ゴールデンクロスの判定（1つ前で短期 < 長期、かつ現在 短期 > 長期）
    if(fastMA[0] < slowMA[0] && fastMA[1] > slowMA[1])
    {
        // 同一足で何度も鳴らさないための制御
        datetime currentBarTime = iTime(_Symbol, _Period, 0);
        if(lastAlertTime != currentBarTime)
        {
            // Alert関数の実行
            Alert("ゴールデンクロス発生！ 通貨ペア: ", _Symbol, " 価格: ", Close[0]);

            lastAlertTime = currentBarTime; // 通知済み時間を更新
        }
    }
}

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

  1. ループ内での実行に注意: for文やwhile文の中で条件分岐を誤ると、一瞬で数百個のポップアップが表示され、MT5がフリーズ（ハングアップ）する原因になります。必ず「一度だけ実行する」フラグ管理を行いましょう。
  2. バックテスト中の挙動: 戦略テスターでEAを走らせている間、Alert関数は機能しません（アラート窓は出ません）。テスト中の動作確認をしたい場合は、Print関数を併用して操作履歴ログを確認するようにしてください。
  3. 音設定の確認: Alertは鳴っているはずなのに音が聞こえない場合、MT5の「ツール」→「オプション」→「イベント」タブで、「有効にする」にチェックが入っているか、アラート音が正しく設定されているかを確認してください。

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

アルゴリズムトレードにおいて、プログラムが売買シグナルを検知してから、その注文が証券会社のサーバーに届くまでの「コンマ数秒の遅延」が、収益性を劇的に悪化させることをご存知でしょうか。自宅のPCでEAを稼働させる場合、一般的なプロバイダー経由のインターネット回線では、ネットワークのゆらぎや物理的な距離による数ミリ秒から数百ミリ秒のレイテンシ（遅延）が避けられません。この遅延の間に価格が滑る（スリッページが発生する）ことで、バックテスト通りの利益が出ないという事態が頻発します。

プロのクオンツエンジニアが自宅PCでの運用を避け、専用のVPS（仮想専用サーバー）を利用するのは、単に24時間稼働させるためだけではありません。証券会社の取引サーバーに物理的に近いデータセンター内に設置されたVPSを利用することで、ネットワーク遅延を極限まで抑え、機関投資家に匹敵する約定スピードを確保するためです。わずかな遅延による損失を回避し、システムのポテンシャルを最大限に引き出すためには、自動売買に特化した低遅延なVPS環境の構築が不可欠といえます。

💡 この記事の内容を実運用で活かすには？

この記事の内容を実運用で活かすには、正しい環境が必要です。
特にVPSを使わないと、このロジックは再現できません。

コメント

タイトルとURLをコピーしました