iAlligator関数とは？なぜトレンド判定に使われるのか

アリゲーター（Alligator）はビル・ウィリアムズが考案したインジケーターです。移動平均線を時間軸でずらした3本のラインで構成されており、ラインが開くとトレンド発生、収束するとレンジ相場という状態を示します。

MQL4では iAlligator() 関数でこの3本のライン値をリアルタイムに取得できるため、「トレンドが発生しているときだけエントリーする」というフィルターロジックをEAに組み込めます。

iAlligator() の構文と引数

double iAlligator(
    string symbol,          // 通貨ペア（NULLで現在のチャート）
    int    timeframe,       // 時間足（0で現在の時間足）
    int    jaw_period,      // 顎の期間（デフォルト13）
    int    jaw_shift,       // 顎のシフト（デフォルト8）
    int    teeth_period,    // 歯の期間（デフォルト8）
    int    teeth_shift,     // 歯のシフト（デフォルト5）
    int    lips_period,     // 唇の期間（デフォルト5）
    int    lips_shift,      // 唇のシフト（デフォルト3）
    int    ma_method,       // 移動平均の種類（MODE_SMMA推奨）
    int    applied_price,   // 適用価格（PRICE_MEDIAN推奨）
    int    mode,            // 取得するライン
    int    shift            // 何本前のバーか（0=現在）
);

mode の値

基本的な使い方：3本のライン値を取得する

iAlligator関数でアリゲーターの各ラインを取得する最もシンプルなコードです。

// アリゲーターのデフォルト設定で3本のライン値を取得
double jaw   = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORJAW,   1);
double teeth = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORTEETH, 1);
double lips  = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORLIPS,  1);

Print("顎(Jaw): ",   jaw);
Print("歯(Teeth): ", teeth);
Print("唇(Lips): ",  lips);

実践例1：アリゲーターでトレンドフィルターを作る

アリゲーターの3本のラインの並び順でトレンドを判定します。唇 > 歯 > 顎なら上昇トレンド、顎 > 歯 > 唇なら下降トレンドと判断できます。

// トレンド判定関数
// 戻り値: 1=上昇トレンド / -1=下降トレンド / 0=レンジ（睡眠中）
int GetAlligatorTrend()
{
    double jaw   = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORJAW,   1);
    double teeth = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORTEETH, 1);
    double lips  = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORLIPS,  1);

    // 唇 > 歯 > 顎 → 上昇トレンド
    if(lips > teeth && teeth > jaw)
        return 1;

    // 顎 > 歯 > 唇 → 下降トレンド
    if(jaw > teeth && teeth > lips)
        return -1;

    // それ以外 → レンジ（アリゲーターが眠っている状態）
    return 0;
}

void OnTick()
{
    int trend = GetAlligatorTrend();
    if(trend == 1)
        Comment("アリゲーター: 上昇トレンド");
    else if(trend == -1)
        Comment("アリゲーター: 下降トレンド");
    else
        Comment("アリゲーター: レンジ（様子見）");
}

実践例2：アリゲーターをフィルターにしたEA

iAlligator関数のトレンド判定と iMA（移動平均）のゴールデンクロスを組み合わせた実践的なEAです。アリゲーターがトレンドを示しているときだけエントリーするため、ダマシを減らせます。

extern int    MagicNumber = 20001;
extern double Lots        = 0.1;
extern int    FastMA      = 5;
extern int    SlowMA      = 20;

void OnTick()
{
    // ラインが3本とも開いているか（絶対値で判定）
    double jaw   = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORJAW,   1);
    double teeth = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORTEETH, 1);
    double lips  = iAlligator(NULL, 0, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN, MODE_GATORLIPS,  1);

    bool upTrend   = (lips > teeth && teeth > jaw);
    bool downTrend = (jaw  > teeth && teeth > lips);

    // MAクロス判定
    double fastMA_cur  = iMA(NULL, 0, FastMA, 0, MODE_EMA, PRICE_CLOSE, 1);
    double fastMA_prev = iMA(NULL, 0, FastMA, 0, MODE_EMA, PRICE_CLOSE, 2);
    double slowMA_cur  = iMA(NULL, 0, SlowMA, 0, MODE_EMA, PRICE_CLOSE, 1);
    double slowMA_prev = iMA(NULL, 0, SlowMA, 0, MODE_EMA, PRICE_CLOSE, 2);

    bool goldenCross = (fastMA_prev < slowMA_prev && fastMA_cur > slowMA_cur);
    bool deadCross   = (fastMA_prev > slowMA_prev && fastMA_cur < slowMA_cur);

    if(OrdersTotal() > 0) return;

    // アリゲーターが上昇トレンド ＋ ゴールデンクロス → 買い
    if(upTrend && goldenCross)
    {
        OrderSend(Symbol(), OP_BUY, Lots, Ask, 20, 0, 0,
                  "Alligator+MA", MagicNumber, 0, clrBlue);
    }

    // アリゲーターが下降トレンド ＋ デッドクロス → 売り
    if(downTrend && deadCross)
    {
        OrderSend(Symbol(), OP_SELL, Lots, Bid, 20, 0, 0,
                  "Alligator+MA", MagicNumber, 0, clrRed);
    }
}

iAlligator使用時の注意点

• シフトに注意：アリゲーターは各ラインが未来方向にシフトされるため、チャート上の表示位置とバーインデックスがずれます。shift=1（1本前）を使って確定済みのバーを参照するのが基本です。
• レンジ相場では使わない：3本のラインが絡み合っている（アリゲーターが眠っている）状態でのエントリーはダマシが増えます。必ず上記のトレンド判定と組み合わせてください。
• applied_price はPRICE_MEDIAN：ビル・ウィリアムズのオリジナル設定は中値（(High+Low)/2）です。PRICE_CLOSEで計算するとチャートの表示と一致しないことがあります。

まとめ

iAlligator関数は、アリゲーターインジケーターの顎・歯・唇の3本のライン値をMQL4から直接取得できる関数です。ラインの並び順を見るだけでトレンドの有無・方向を判定できるため、EA開発のフィルターとして非常に使いやすいのが特徴です。

レンジ相場（アリゲーターが眠っている状態）ではエントリーを避け、トレンドが明確に出たときだけ他のシグナルと組み合わせるのがiAlligator活用のポイントです。

投稿 【MQL4関数】iAlligator関数の使い方！アリゲーターでトレンド判定EAを作ろう は 自動売買を作ろう！ に最初に表示されました。

ライン定数は、ロジック関数の引数として使用します。

ロジック関数（iMACD関数など）は、取得するラインを設定することができます。

その設定をするために、ライン定数を使うと良いでしょう。

例えば、iMACD関数で使うと、取得する値はメインラインなのか、シグナルラインなのかを設定をすることができます。

それぞれ、mode引数の入力値として、ライン定数を使うことができます。

iMACD関数、iRVI関数、iStochastic関数で使用

iADX関数で使用

iBands関数、iEnvelopes関数、iEnvelopesOnArray関数、iFractals関数、iGator関数で使用

iAlligator関数で使用

iIchimoku関数で使用

ライン定数（MODE）の使い方

主に、ロジック関数で使用されます。

それぞれ、mode引数の入力値として、ライン定数を使うことができます。

上記の定数を入力しましょう。

すると、その定数に対応したラインの値を取得することができます。

例えば、以下のように使用します。

  //iMACD関数
  //メインラインのMACDの値を取得する
   double macd = iMACD(Symbol(), PERIOD_CURRENT, 14, 25, 9, PRICE_CLOSE, MODE_MAIN, 0);

プログラム例

以下は、ライン定数を使って複数のインジケーター値を取得するプログラム例です。

void OnTick()
{
   //-------------------------------------------
   // iMACD関数でライン定数を使用する例
   //-------------------------------------------
   // メインライン（MACD線）の値を取得
   double macdMain = iMACD(Symbol(), PERIOD_CURRENT, 12, 26, 9, PRICE_CLOSE, MODE_MAIN, 0);
   // シグナルラインの値を取得
   double macdSignal = iMACD(Symbol(), PERIOD_CURRENT, 12, 26, 9, PRICE_CLOSE, MODE_SIGNAL, 0);

   // メインラインがシグナルラインを上抜けた場合
   if(macdMain > macdSignal)
   {
      Print("MACDゴールデンクロス: メイン=", macdMain, " シグナル=", macdSignal);
   }

   //-------------------------------------------
   // iStochastic関数でライン定数を使用する例
   //-------------------------------------------
   // メインライン（%K）の値を取得
   double stochMain = iStochastic(Symbol(), PERIOD_CURRENT, 5, 3, 3, MODE_SMA, 0, MODE_MAIN, 0);
   // シグナルライン（%D）の値を取得
   double stochSignal = iStochastic(Symbol(), PERIOD_CURRENT, 5, 3, 3, MODE_SMA, 0, MODE_SIGNAL, 0);

   Print("Stochastic: %%K=", stochMain, " %%D=", stochSignal);

   //-------------------------------------------
   // iBands関数でライン定数を使用する例
   //-------------------------------------------
   // メインライン（中央線）の値を取得
   double bandsMain  = iBands(Symbol(), PERIOD_CURRENT, 20, 2, 0, PRICE_CLOSE, MODE_MAIN, 0);
   // 上ラインの値を取得
   double bandsUpper = iBands(Symbol(), PERIOD_CURRENT, 20, 2, 0, PRICE_CLOSE, MODE_UPPER, 0);
   // 下ラインの値を取得
   double bandsLower = iBands(Symbol(), PERIOD_CURRENT, 20, 2, 0, PRICE_CLOSE, MODE_LOWER, 0);

   Print("Bands: 上=", bandsUpper, " 中央=", bandsMain, " 下=", bandsLower);

   //-------------------------------------------
   // iIchimoku関数でライン定数を使用する例
   //-------------------------------------------
   // 転換線の値を取得
   double tenkan  = iIchimoku(Symbol(), PERIOD_CURRENT, 9, 26, 52, MODE_TENKANSEN, 0);
   // 基準線の値を取得
   double kijun   = iIchimoku(Symbol(), PERIOD_CURRENT, 9, 26, 52, MODE_KIJUNSEN, 0);
   // 先行スパンAの値を取得
   double spanA   = iIchimoku(Symbol(), PERIOD_CURRENT, 9, 26, 52, MODE_SENKOUSPANA, 0);
   // 先行スパンBの値を取得
   double spanB   = iIchimoku(Symbol(), PERIOD_CURRENT, 9, 26, 52, MODE_SENKOUSPANB, 0);
   // 遅行スパンの値を取得
   double chikou  = iIchimoku(Symbol(), PERIOD_CURRENT, 9, 26, 52, MODE_CHIKOUSPAN, 0);

   Print("一目均衡表: 転換線=", tenkan, " 基準線=", kijun);

   //-------------------------------------------
   // iAlligator関数でライン定数を使用する例
   //-------------------------------------------
   // 顎ライン（Jaw）の値を取得
   double jaw  = iAlligator(Symbol(), PERIOD_CURRENT, 13, 8, 8, 5, 5, 3, MODE_SMA, PRICE_MEDIAN, MODE_GATORJAW, 0);
   // 歯ライン（Teeth）の値を取得
   double teeth = iAlligator(Symbol(), PERIOD_CURRENT, 13, 8, 8, 5, 5, 3, MODE_SMA, PRICE_MEDIAN, MODE_GATORTEETH, 0);
   // 口ライン（Lips）の値を取得
   double lips  = iAlligator(Symbol(), PERIOD_CURRENT, 13, 8, 8, 5, 5, 3, MODE_SMA, PRICE_MEDIAN, MODE_GATORLIPS, 0);

   Print("Alligator: 顎=", jaw, " 歯=", teeth, " 口=", lips);
}

上記のプログラムでは、各インジケーター関数のmode引数にライン定数を指定することで、それぞれ対応するラインの値を取得しています。

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

はじめに この記事は、MQLプログラミング基礎を理解している方向けに作成しております。 もしMQLプログラミングがわからないという方は、先に以下の記事を読んでおくことをオススメします。 カテゴリー：MQLプログラミング基

mql-programing.com

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

mql-programing.com

投稿 【MQL4定数】ライン定数（MODE） は 自動売買を作ろう！ に最初に表示されました。