朝日奈りさ

iMA関数とは？

ゴールデンクロスやデッドクロスを手法にしている方は、ぜひiMA関数をマスターしましょう！

iMA関数は、移動平均線の値を取得する関数です。

移動平均線の値が取得できれば、if文やfor文と組みわせることで、クロスの判定ができます。

しかし、iMA関数を使いこなすのは難しいため、挫折してしまうかたもいらっしゃいます。

なぜ難しいのかというと、返り値（戻り値）と引数を入力する必要があるからです。

特に引数はとても複雑なので、しっかり把握するようにしましょう！

またiMA関数は、MQLに標準で組み込まれている関数なので、自分でプログラミングしなくてOKです！

いつでも使うことができます。

if文やfor文がわからない方は、以下の記事が参考になります。

【MQLプログラミング基礎】条件分岐をif文で書いてみよう！プログラム例あり

目次 条件分岐とは？if文の書き方プログラム例if else文の書き方プログラム例条件式の種類と使い方プログラム例まとめ 条件分岐とは？ プログラムは自分で考えることができません。 そのため、プログラムを実行するかしない

mql-programing.com

【MQLプログラミング基礎】繰り返し文を書いてみよう！プログラム例あり

目次 繰り返しとは？for文の書き方変数の初期化条件式変数の更新for文のプログラム例while文の書き方while文のプログラム例サンプルプログラムまとめ 繰り返しとは？ MQLプログラミングでは、全く同じ処理を、何度

mql-programing.com

iMA関数の書き方

iMA関数は難しいと言っても、基本的には関数の使い方と同じなので、まずは関数の基礎をマスターしましょう。

関数についてはこちらの記事にまとめておりますので、参考になると思います。

【MQLプログラミング基礎】関数は難しい？関数の使い方を理解しよう！プログラム例あり

関数とは？ 「プログラムは、何度も同じことを書かないといけない」 と思っている方、ぜひ関数を使ってみてください。 関数とは、何度も繰り返すプログラムを、まとめた状態のものです。 事前に、まとまりを作っておくことで、同じプ

mql-programing.com

基本的な書き方

iMA関数の基本的な書き方は、以下の通りです。

分かりやすいように、引数は省略しています。

double ma = iMA(①, ②, ③, ④, ⑤, ⑥, ⑦);

このように返り値はdouble型です。

さらに７つの引数を入力します。

引数の数を見るだけでも、うんざりしてしまいますね…

まずは返り値、次に引数について、詳しく見ていきましょう。

iMA関数の返り値（戻り値）

iMA関数の返り値はdouble型です。

値が１つだけ返ってきます。

つまり、移動平均「線」ではなく、移動平均「点」が返ってくるのです。

例えばドル円で使ってみると、「107.000」のような値が返ってきます。

また、iMA関数は１つのロウソク足に対して、１つだけ値を返します。

そして、返ってきた値を繋げることで、移動平均「線」として処理することができるようになります。

iMA関数の引数

ここからは、iMA関数の引数について詳しく見ていきます。

難しいので、ゆっくり理解していくと良いと思います。

下記の通り、iMA関数は７つの引数があります。

double ma = iMA(①, ②, ③, ④, ⑤, ⑥, ⑦);

一覧で見ると、このようになります。

１つずつ見ていきましょう。

①symbol　（通貨ペアを設定）

symbolは、移動平均を取得する通貨ペアを設定します。

例えばドル円の場合、「USDJPY」という値になります。

ですが、具体的に通貨ペアを設定する必要はありません。

というのもMQLには便利なものがあり、「Symbol」または「NULL」と書くだけで、現在の通貨ペアを設定できます。

そのため通常は、下記のように入力すれば大丈夫です。

double ma = iMA(NULL, ②, ③, ④, ⑤, ⑥, ⑦);

②timeframe　（時間足を設定）

timeframeは、移動平均を取得する時間足を設定します。

「0」を入力すると、表示されている時間足になりますので、通常は「0」を入力すれば問題ありません。

double ma = iMA(NULL, 0, ③, ④, ⑤, ⑥, ⑦);

別の時間足を設定する方法

もし、表示されている時間足ではない値を取得したい場合は、以下の値を入力することで、別の時間足を設定できます。

③ma_period　（計算期間を設定）

３つ目は、移動平均の計算期間を設定します。

計算期間とは、ロウソク足の本数のことです。

過去何本のロウソク足に対して、移動平均を計算するのかを設定します。

一般的には「７」、「１４」、「２５」という値がよく使われます。

「７」なら、過去７本のロウソク足に対して計算します。

ロジックに合わせた数値を入力すると良いでしょう。

double ma = iMA(NULL, 0, 7, ④, ⑤, ⑥, ⑦);

④ma_shift　（表示移動の設定）

移動平均線の表示を、左右に移動させることができます。

ですが、こちらも設定する必要はなく、「0」を入力します。

もし「3」を入力した場合、ロウソク足３本分だけ右に移動します。

マイナスなら左に移動します。

double ma = iMA(NULL, 0, 7, 0, ⑤, ⑥, ⑦);

移動するのは表示だけです。iMAの取得値が移動するのではないので、注意してください。

⑤ma_method　（計算方法の設定）

計算方法の設定です。

移動平均線の計算方法は、主に４つあります。以下の通りです。

「難しい！」という方は、単純移動平均（MODE_SMA）を入力してください。

なぜなら、移動平均線のインジケータは、単純移動平均になっているからです。

そうすれば、Moving Averageインジケータの表示通りに、値を取得できるはずです。

double ma = iMA(NULL, 0, 7, 0, MODE_SMA, ⑥, ⑦);

⑥applied_price　（適用価格の設定）

適用価格とは、ロウソク足の「終値」「始値」「高値」「底値」のことです。

移動平均の計算を、どの値で計算するのかを設定します。

以下の通り設定できるのですが、「終値」（PRICE_CLOSE）で設定して問題ありません。

double ma = iMA(NULL, 0, 7, 0, MODE_SMA, PRICE_CLOSE, ⑦);

⑦shift　（先行・遅行の設定）

最後にshiftの設定です。

先行線や遅行線の設定をします。

簡単に言うと、どのくらい過去の移動平均線の値を取得するかです。

プラスの数値を入力した場合、その数値分だけ過去のロウソク足の、移動平均線の値を取得します。

移動平均線を１本だけ使う場合は、「0」で良いのですが、２本使う場合（ゴールデンクロスやデッドクロス）は、このshiftを使います。

double ma = iMA(NULL, 0, 7, 0, MODE_SMA, PRICE_CLOSE, 0);

ここまでで、iMAの書き方は完了です。

上記のように記述すれば、移動平均線の値を取得することができます。

iMA関数の具体的な使い方（サンプルあり）

もう少し具体的な使い方を見ていきましょう。

iMAを使う時、大体２通りの使い方があります。

• ③ma_period（計算期間の設定）を変える方法
• ⑦shift（先行・遅行の設定）を変える方法

それぞれ見ていきましょう。

③ma_period（計算期間）を変える方法

ゴールデンクロスやデッドクロスを判定する場合、短期移動平均線と長期移動平均線の２本が必要です。

この場合、③ma_period（計算期間）を変えることで、短期と長期の移動平均線の値を取得できます。

例えば、短期を「7」、長期を「25」に設定する場合は以下の通りです。

// 短期移動平均線（期間7）
double ma_short = iMA(NULL, 0, 7, 0, MODE_SMA, PRICE_CLOSE, 0);

// 長期移動平均線（期間25）
double ma_long = iMA(NULL, 0, 25, 0, MODE_SMA, PRICE_CLOSE, 0);

このように③の部分だけを変えることで、短期と長期の値を別々に取得できます。

⑦shift（先行・遅行）を変える方法

ゴールデンクロスやデッドクロスの判定には、現在の値と１本前の値を比較する必要があります。

この場合、⑦shift（先行・遅行の設定）を変えることで、過去の移動平均線の値を取得できます。

例えば、現在のロウソク足と１本前のロウソク足の移動平均を取得する場合は以下の通りです。

// 現在のロウソク足の移動平均（shift=0）
double ma_current = iMA(NULL, 0, 7, 0, MODE_SMA, PRICE_CLOSE, 0);

// 1本前のロウソク足の移動平均（shift=1）
double ma_prev = iMA(NULL, 0, 7, 0, MODE_SMA, PRICE_CLOSE, 1);

⑦の部分を「0」にすると現在のロウソク足、「1」にすると1本前のロウソク足の値を取得します。

サンプルプログラム（ゴールデンクロス・デッドクロス判定）

ここからは、iMA関数を使った実践的なサンプルプログラムを紹介します。

ゴールデンクロスとデッドクロスを判定するEA（自動売買プログラム）のサンプルです。

ゴールデンクロス・デッドクロスの判定ロジック

ゴールデンクロスとデッドクロスの判定は、以下のように考えます。

【ゴールデンクロス】

• 1本前：短期MA ＜ 長期MA（短期が下にある）
• 現在　：短期MA ＞ 長期MA（短期が上に抜けた）

【デッドクロス】

• 1本前：短期MA ＞ 長期MA（短期が上にある）
• 現在　：短期MA ＜ 長期MA（短期が下に抜けた）

サンプルコード

以下がゴールデンクロス・デッドクロスを判定し、アラートを表示するサンプルプログラムです。

//+------------------------------------------------------------------+
//| iMA関数サンプル - ゴールデンクロス・デッドクロス判定             |
//+------------------------------------------------------------------+

// 入力パラメータ
input int ShortPeriod = 7;    // 短期移動平均の期間
input int LongPeriod  = 25;   // 長期移動平均の期間

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
{
   // 現在のロウソク足の短期・長期移動平均を取得
   double ma_short_current = iMA(NULL, 0, ShortPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
   double ma_long_current  = iMA(NULL, 0, LongPeriod,  0, MODE_SMA, PRICE_CLOSE, 0);

   // 1本前のロウソク足の短期・長期移動平均を取得
   double ma_short_prev = iMA(NULL, 0, ShortPeriod, 0, MODE_SMA, PRICE_CLOSE, 1);
   double ma_long_prev  = iMA(NULL, 0, LongPeriod,  0, MODE_SMA, PRICE_CLOSE, 1);

   // ゴールデンクロス判定
   if(ma_short_prev < ma_long_prev && ma_short_current > ma_long_current)
   {
      Alert("ゴールデンクロスが発生しました！");
   }

   // デッドクロス判定
   if(ma_short_prev > ma_long_prev && ma_short_current < ma_long_current)
   {
      Alert("デッドクロスが発生しました！");
   }
}

サンプルコードの解説

上記のサンプルコードを順番に解説します。

①入力パラメータの設定

input int ShortPeriod = 7;    // 短期移動平均の期間
input int LongPeriod  = 25;   // 長期移動平均の期間

inputをつけることで、EAの設定画面から期間を変更できるようになります。

②現在と1本前の移動平均線の値を取得

// 現在のロウソク足（shift=0）
double ma_short_current = iMA(NULL, 0, ShortPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
double ma_long_current  = iMA(NULL, 0, LongPeriod,  0, MODE_SMA, PRICE_CLOSE, 0);

// 1本前のロウソク足（shift=1）
double ma_short_prev = iMA(NULL, 0, ShortPeriod, 0, MODE_SMA, PRICE_CLOSE, 1);
double ma_long_prev  = iMA(NULL, 0, LongPeriod,  0, MODE_SMA, PRICE_CLOSE, 1);

③ma_periodと⑦shiftの両方を変えて、合計4つの値を取得しています。

③ゴールデンクロス・デッドクロスの判定

// ゴールデンクロス判定
if(ma_short_prev < ma_long_prev && ma_short_current > ma_long_current)
{
   Alert("ゴールデンクロスが発生しました！");
}

if文を使って、1本前では短期が長期より下にあり、現在は短期が長期より上にある場合を、ゴールデンクロスと判定しています。

デッドクロスは、この逆の条件で判定しています。

iMA関数を使う時の注意点

最後に、iMA関数を使う時の注意点をまとめておきます。

注意点①：返ってくるのは「点」であること

先ほども説明しましたが、iMA関数は移動平均「線」ではなく、移動平均「点」を返します。

1回の呼び出しで、1つのロウソク足に対する1つの値しか取得できません。

複数の値が必要な場合は、⑦shiftの値を変えて複数回呼び出す必要があります。

注意点②：④ma_shiftと⑦shiftの違い

④ma_shiftと⑦shiftは混同しやすいので注意が必要です。

• ④ma_shift：表示を移動させるだけ（取得する値は変わらない）
• ⑦shift：取得するロウソク足の位置を変える（実際に取得する値が変わる）

通常は④ma_shiftは「0」のままで、⑦shiftを使って過去の値を取得するようにしましょう。

注意点③：計算期間より少ないデータしかない場合

例えばma_periodを「25」に設定した場合、最低でも25本のロウソク足のデータが必要です。

データが不足している場合、正しい値が返ってこない可能性があるので注意してください。

まとめ

iMA関数について解説しました。ポイントをまとめます。

• iMA関数は移動平均線の値を取得する関数
• 返り値はdouble型で、1つの値（移動平均「点」）が返ってくる
• 引数は7つあるが、よく変更するのは③ma_periodと⑦shift
• ゴールデンクロス・デッドクロスの判定には、③ma_periodと⑦shiftを組み合わせて使う
• ④ma_shiftと⑦shiftの違いに注意する

iMA関数は引数が多く最初は難しく感じますが、慣れてしまえば簡単に使えるようになります。

ぜひサンプルコードを参考に、実際に動かしてみてください！

投稿 【MQL4関数】iMA関数（移動平均線）の使い方とサンプルプログラム は 自動売買を作ろう！ に最初に表示されました。