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

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

MQL5での開発において、ChartIndicatorAddは「作成済みのインジケーターハンドルを、指定したチャートウィンドウに表示させる」ための関数です。

実務レベルのEA開発では、iMAやiRSIといった関数でインジケーターの値を計算しますが、これだけではバックテスト中や実際の稼働中にチャート上にインジケーターが表示されません。開発者が「EAが今、どの指標に基づいて売買判断をしているのか」を視覚的にデバッグしたり、ユーザーに対してロジックの透明性を示したりするために、この関数は極めて重要です。

初心者が特につまずきやすいのは、「インジケーターの作成（ハンドル取得）」と「表示」は別物であるという点です。iMAを呼んだだけでは計算の準備が整っただけであり、ChartIndicatorAddを呼び出して初めて、我々の目に映るチャート上に描画されることになります。

2. 構文と戻り値

ChartIndicatorAddの構文は非常にシンプルです。

bool ChartIndicatorAdd(
   long  chart_id,         // チャートID（0は現在のチャート）
   int   sub_window,       // サブウィンドウ番号（0はメインウィンドウ）
   int   indicator_handle  // 表示させたいインジケーターのハンドル
);

パラメーターの解説

1. chart_id: 操作対象のチャートを識別するIDです。通常、EAが動いているチャートであれば 0 を指定します。
2. sub_window: どのエリアに表示するかを指定します。
   • 0: ローソク足があるメインウィンドウ（移動平均線など）。
   • 1以上: オシレーターなどが表示されるサブウィンドウ。
   • ChartWindowsTotal()を使用することで、新しいサブウィンドウを自動生成して表示させるテクニックもあります。
3. indicator_handle: iMAやiRSI、iCustomなどの関数で事前に取得しておいたハンドルを指定します。

戻り値

• 成功した場合は true、失敗した場合は false を返します。失敗の理由は GetLastError() 関数で確認できます。

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

以下のコードは、EAの初期化時に「20期間の移動平均線（MA）」をメインウィンドウに、「14期間のRSI」を新しいサブウィンドウに自動的に追加する実践的なサンプルです。

//+------------------------------------------------------------------+
//|                                              SampleIndicator.mq5 |
//+------------------------------------------------------------------+
int handleMA = INVALID_HANDLE;
int handleRSI = INVALID_HANDLE;

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
{
    // 1. 移動平均線のハンドルを取得（20期間、シンプル）
    handleMA = iMA(_Symbol, _Period, 20, 0, MODE_SMA, PRICE_CLOSE);

    // 2. RSIのハンドルを取得（14期間）
    handleRSI = iRSI(_Symbol, _Period, 14, PRICE_CLOSE);

    // ハンドルの取得に失敗していないかチェック
    if(handleMA == INVALID_HANDLE || handleRSI == INVALID_HANDLE)
    {
        Print("ハンドルの取得に失敗しました。");
        return(INIT_FAILED);
    }

    // --- 実践：チャートへの描画 ---

    // 3. メインウィンドウ(0)に移動平均線を追加
    if(!ChartIndicatorAdd(0, 0, handleMA))
    {
        Print("MAの追加に失敗。エラーコード:", GetLastError());
    }

    // 4. 新しいサブウィンドウにRSIを追加
    // 現在のウィンドウ総数を指定することで、一番下に新しいウィンドウが作成される
    int subWindow = (int)ChartGetInteger(0, CHART_WINDOWS_TOTAL);
    if(!ChartIndicatorAdd(0, subWindow, handleRSI))
    {
        Print("RSIの追加に失敗。エラーコード:", GetLastError());
    }

    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| Expert deinitialization function                                 |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    // EA停止時にはハンドルを解放してメモリを節約
    IndicatorRelease(handleMA);
    IndicatorRelease(handleRSI);
}

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

1. 描画と計算の混同に注意
   ChartIndicatorAddを使わなくても、CopyBufferを使えばインジケーターの値は取得できます。「値を計算したいだけ」ならこの関数は不要です。あくまで「画面に出したいとき」だけ使いましょう。

2. サブウィンドウの指定ミス
   RSIやMACDなどのオシレーター系を sub_window = 0（メイン）に追加してしまうと、価格のスケール（150円など）とオシレーターのスケール（0〜100）が混ざり、チャートが極端に圧縮されて見えなくなる「表示崩れ」がよく発生します。

3. ハンドルの有効性
   iMAなどで取得したハンドルが INVALID_HANDLE である場合、ChartIndicatorAddは必ず失敗します。必ずハンドル取得の直後にエラーチェックを行う癖をつけてください。

4. ストラテジーテスターでの挙動
   バックテスト（可視化モード）でもこの関数は動作しますが、テスト終了後にチャートからインジケーターが消えない場合があります。これはMQL5の仕様に近い挙動ですが、コード内で管理を徹底しましょう。

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

アルゴリズムトレーダーとして最も警戒すべきは、プログラムのバグ以上に「物理的な遅延（レイテンシ）」です。自宅のPCや一般的な光回線でEAを稼働させることは、クオンツの視点では極めてリスクの高い行為と言わざるを得ません。為替相場は1ミリ秒（1000分の1秒）単位で価格が変動しており、自宅PCから海外にある証券会社のサーバーへ注文を飛ばすと、ネットワークの物理的な距離により数十〜数百ミリ秒の遅延が発生します。この遅延が原因で、プログラムが意図した価格から乖離して約定する「スリッページ」が発生し、期待期待値を大幅に削り取ってしまうのです。

たとえChartIndicatorAddで完璧な可視化を行い、素晴らしいロジックを組み上げたとしても、実行環境が貧弱であれば勝つことは不可能です。プロの現場では、証券会社のサーバーに物理的に近いデータセンターに設置された「専用のVPS（仮想専用サーバー）」を利用するのが常識です。安定した電源、24時間の稼働保証、そして極限まで短縮された約定スピード。これらを備えたVPS環境を構築して初めて、あなたのアルゴリズムは本来のポテンシャルを発揮することができます。自動売買で真剣に利益を追求するなら、インフラへの投資を惜しんではいけません。