iMA() の使い方・引数・戻り値（MQL4／MQL5）

iMA() とは

移動平均線（単純・指数・平滑・加重）を計算する関数です。MQL4 では指定したバーの移動平均の値が直接返ります。MQL5 ではハンドルが返り、CopyBuffer() で値を読み出します。

iMA() の書式と引数

MQL4 の場合MT4

double iMA(
   string symbol,
   int timeframe,
   int ma_period,
   int ma_shift,
   int ma_method,
   int applied_price,
   int shift
)

戻り値（MQL4）

MQL5 の場合MT5

int iMA(
   string symbol,
   ENUM_TIMEFRAMES period,
   int ma_period,
   int ma_shift,
   ENUM_MA_METHOD ma_method,
   int applied_price
)

戻り値（MQL5）

iMA() の使い方（コード例）

MQL4

// 短期 MA(5) が長期 MA(20) を上抜けたか（確定足で判定）
double fast1 = iMA(_Symbol, 0, 5, 0, MODE_SMA, PRICE_CLOSE, 1);
double fast2 = iMA(_Symbol, 0, 5, 0, MODE_SMA, PRICE_CLOSE, 2);
double slow1 = iMA(_Symbol, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 1);
double slow2 = iMA(_Symbol, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 2);
if(fast2 <= slow2 && fast1 > slow1)
   Print("ゴールデンクロス");

MQL5

int hFast = INVALID_HANDLE, hSlow = INVALID_HANDLE;

int OnInit()
{
   hFast = iMA(_Symbol, PERIOD_CURRENT, 5, 0, MODE_SMA, PRICE_CLOSE);
   hSlow = iMA(_Symbol, PERIOD_CURRENT, 20, 0, MODE_SMA, PRICE_CLOSE);
   if(hFast == INVALID_HANDLE || hSlow == INVALID_HANDLE)
      return INIT_FAILED;
   return INIT_SUCCEEDED;
}

void OnDeinit(const int reason)
{
   IndicatorRelease(hFast);
   IndicatorRelease(hSlow);
}

void OnTick()
{
   double fast[], slow[];
   ArraySetAsSeries(fast, true);   // [0] を最新にする
   ArraySetAsSeries(slow, true);
   // 1本前と2本前（確定足）の値を読む
   if(CopyBuffer(hFast, 0, 1, 2, fast) < 2 || CopyBuffer(hSlow, 0, 1, 2, slow) < 2)
      return;
   if(fast[1] <= slow[1] && fast[0] > slow[0])
      Print("ゴールデンクロス");
}

OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。

iMA() の注意点

• MQL5 では値ではなく「ハンドル」（インジケーターの番号）が返ります。ハンドルは OnInit() で1回だけ作り、OnTick() などで CopyBuffer() を使って値を読み出します。毎ティック作り直すと動作が重くなります。
• クロスの判定は、確定した足（shift=1 と 2）で行うと、足の途中でサインが出たり消えたりしません。

MQL4 と MQL5 の違い

iMA() でよく出るエラー

• MT5エラー4802インジケーターを作成できない（ハンドルを取得できない）
• MT5エラー4806インジケーターのデータがまだない
• MT5エラー4807インジケーターのハンドルが不正

関連する関数

• CopyBuffer()インジケーターのハンドルから値を配列に読み出す
• IndicatorRelease()使い終わったインジケーターのハンドルを解放する
• iRSI()RSI（相対力指数）の値を取得する
• iMACD()MACD のメインライン・シグナルラインの値を取得する
• iCustom()カスタムインジケーターの値を取得する

テクニカル指標の関数一覧

• iMA
• iRSI
• iMACD
• iBands
• iStochastic
• iATR
• iCCI
• iADX
• iMomentum
• iSAR
• iIchimoku
• iCustom
• CopyBuffer
• BarsCalculated
• IndicatorRelease

← MQL関数リファレンスで、ほかの関数を探す