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

int iEnvelopes(
   string              symbol,            // 通貨ペア名（NULLなら現在のチャート）
   ENUM_TIMEFRAMES     period,            // 時間軸（PERIOD_CURRENTなら現在の足）
   int                 ma_period,         // 平均期間
   int                 ma_shift,          // 平均線のシフト（右方向へのずらし）
   ENUM_MA_METHOD      ma_method,         // 平均線の種類（SMA, EMAなど）
   ENUM_APPLIED_PRICE  applied_price,     // 適用価格（クローズ価格など）
   double              deviation          // 乖離率（パーセント。例：0.1なら0.1%）
);

//+------------------------------------------------------------------+
//|                                              EnvelopeSample.mq5  |
//|                                  Copyright 2023, Quant Engineer  |
//+------------------------------------------------------------------+
#property strict

// 入力パラメーター
input int      InpMAPeriod = 14;       // 移動平均の期間
input double   InpDeviation = 0.1;     // 乖離率 (%)
input ENUM_MA_METHOD InpMethod = MODE_SMA; // 平均計算手法

// グローバル変数
int handleEnv; // エンベロープのハンドルを格納

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
{
    // 1. エンベロープのハンドルを取得
    handleEnv = iEnvelopes(_Symbol, _Period, InpMAPeriod, 0, InpMethod, PRICE_CLOSE, InpDeviation);

    // ハンドル取得失敗時のエラーチェック
    if(handleEnv == INVALID_HANDLE)
    {
        Print("iEnvelopesの作成に失敗しました。エラーコード:", GetLastError());
        return(INIT_FAILED);
    }
    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
{
    double upperBand[]; // 上限値を格納する配列
    double lowerBand[]; // 下限値を格納する配列

    // 配列を時系列（最新の足がインデックス0）に設定
    ArraySetAsSeries(upperBand, true);
    ArraySetAsSeries(lowerBand, true);

    // 2. CopyBufferを使って最新の2本分のデータを取得
    // バッファ番号: 0 = UPPER_LINE (上限), 1 = LOWER_LINE (下限)
    if(CopyBuffer(handleEnv, 0, 0, 2, upperBand) < 0 || 
       CopyBuffer(handleEnv, 1, 0, 2, lowerBand) < 0)
    {
        Print("データのコピーに失敗しました。");
        return;
    }

    // 現在の終値を取得
    double closePrice = iClose(_Symbol, _Period, 0);

    // 3. 簡単な判定ロジック
    if(closePrice > upperBand[0])
    {
        Print("価格がエンベロープの上限を上抜けました。");
    }
    else if(closePrice < lowerBand[0])
    {
        Print("価格がエンベロープの下限を下抜けました。");
    }
}

//+------------------------------------------------------------------+
//| Expert deinitialization function                                 |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    // 使用したハンドルを解放してメモリを節約
    IndicatorRelease(handleEnv);
}