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を作ろう は 自動売買を作ろう！ に最初に表示されました。

MQL4では iEnvelopes() 関数を使ってエンベロープの値を取得できます。

iEnvelopes() の構文

double iEnvelopes(
    string  symbol,       // 通貨ペア（NULLで現在のチャート）
    int     timeframe,    // 時間足（0で現在の時間足）
    int     ma_period,    // 移動平均の期間
    int     ma_method,    // 移動平均の種類
    int     ma_shift,     // 移動平均のシフト
    int     applied_price,// 適用価格
    double  deviation,    // 偏差（%）
    int     mode,         // バンドの種類（上・下）
    int     shift         // 何本前のバーか（0=現在）
);

引数の詳細

mode の値

基本的な使い方

// 20期間SMA、偏差0.2%のエンベロープを取得する
double upperBand = iEnvelopes(NULL, 0, 20, MODE_SMA, 0, PRICE_CLOSE, 0.2, MODE_UPPER, 0);
double lowerBand = iEnvelopes(NULL, 0, 20, MODE_SMA, 0, PRICE_CLOSE, 0.2, MODE_LOWER, 0);

Print("上バンド: ", upperBand);
Print("下バンド: ", lowerBand);

実践例1：エンベロープのブレイクアウトでエントリー

価格が上バンドを上抜けたら買い、下バンドを下抜けたら売りのシグナルとして使う例です。

extern int    MagicNumber = 11001;
extern double Lots        = 0.1;
extern int    MA_Period   = 20;
extern double Deviation   = 0.2;  // バンド幅（%）

//+------------------------------------------------------------------+
//| エンベロープ ブレイクアウトEA                                       |
//+------------------------------------------------------------------+
void OnTick()
{
    // すでにポジションがある場合はスキップ
    if(OrdersTotal() > 0) return;

    double upperBand = iEnvelopes(NULL, 0, MA_Period, MODE_SMA, 0, PRICE_CLOSE, Deviation, MODE_UPPER, 1);
    double lowerBand = iEnvelopes(NULL, 0, MA_Period, MODE_SMA, 0, PRICE_CLOSE, Deviation, MODE_LOWER, 1);
    double prevClose = iClose(NULL, 0, 2);  // 2本前の終値
    double lastClose = iClose(NULL, 0, 1);  // 1本前の終値

    // 上バンドを上抜け → 買いエントリー
    if(prevClose < upperBand && lastClose > upperBand)
    {
        OrderSend(Symbol(), OP_BUY, Lots, Ask, 20, 0, 0,
                  "Envelope Breakout", MagicNumber, 0, clrBlue);
    }

    // 下バンドを下抜け → 売りエントリー
    if(prevClose > lowerBand && lastClose < lowerBand)
    {
        OrderSend(Symbol(), OP_SELL, Lots, Bid, 20, 0, 0,
                  "Envelope Breakout", MagicNumber, 0, clrRed);
    }
}

実践例2：エンベロープをトレンドフィルターとして使う

価格が上バンドより上にある＝上昇トレンドと判断し、他のシグナルと組み合わせるフィルターとして活用する例です。

// トレンドフィルター関数
// 戻り値: 1=上昇トレンド / -1=下降トレンド / 0=レンジ
int GetTrend()
{
    double upperBand = iEnvelopes(NULL, 0, 20, MODE_SMA, 0, PRICE_CLOSE, 0.2, MODE_UPPER, 1);
    double lowerBand = iEnvelopes(NULL, 0, 20, MODE_SMA, 0, PRICE_CLOSE, 0.2, MODE_LOWER, 1);
    double lastClose = iClose(NULL, 0, 1);

    if(lastClose > upperBand) return  1;  // 上昇トレンド
    if(lastClose < lowerBand) return -1;  // 下降トレンド
    return 0;                             // レンジ（バンド内）
}

void OnTick()
{
    int trend = GetTrend();

    if(trend == 1)
        Comment("トレンド: 上昇（買いシグナルのみ有効）");
    else if(trend == -1)
        Comment("トレンド: 下降（売りシグナルのみ有効）");
    else
        Comment("トレンド: レンジ（様子見）");
}

実践例3：反転狙い（逆張り）

価格がバンドに触れたら反転を狙う逆張り戦略です。

extern int    MagicNumber = 11002;
extern double Lots        = 0.1;
extern int    MA_Period   = 30;
extern double Deviation   = 0.3;

void OnTick()
{
    if(OrdersTotal() > 0) return;

    double upperBand = iEnvelopes(NULL, 0, MA_Period, MODE_EMA, 0, PRICE_CLOSE, Deviation, MODE_UPPER, 1);
    double lowerBand = iEnvelopes(NULL, 0, MA_Period, MODE_EMA, 0, PRICE_CLOSE, Deviation, MODE_LOWER, 1);
    double high1     = iHigh(NULL, 0, 1);
    double low1      = iLow(NULL, 0, 1);

    // 上バンドに高値が触れた → 売り（反転狙い）
    if(high1 >= upperBand)
    {
        OrderSend(Symbol(), OP_SELL, Lots, Bid, 20, 0, 0,
                  "Envelope Mean Reversion", MagicNumber, 0, clrRed);
    }

    // 下バンドに安値が触れた → 買い（反転狙い）
    if(low1 <= lowerBand)
    {
        OrderSend(Symbol(), OP_BUY, Lots, Ask, 20, 0, 0,
                  "Envelope Mean Reversion", MagicNumber, 0, clrBlue);
    }
}

偏差（deviation）の目安

偏差が小さすぎるとノイズが多くなり、大きすぎるとシグナルが少なくなります。バックテストで最適な値を見つけましょう。

まとめ

• iEnvelopes() は移動平均の上下にバンドを描くインジケーター関数
• MODE_UPPER で上バンド、MODE_LOWER で下バンドの値を取得
• ブレイクアウト（トレンドフォロー）と反転狙い（逆張り）の両方に応用できる
• deviation パラメーターはバックテストで通貨ペアに合わせて調整する

投稿 【MQL4関数】iEnvelopes関数の使い方！エンベロープでトレンドフィルターEAを作ろう は 自動売買を作ろう！ に最初に表示されました。

EA（自動売買）やカスタムインジケーターを作成するとき、「現在のスプレッドはいくつ？」「最小ロット数は？」「ストップレベルは？」など、通貨ペア（シンボル）のさまざまな情報をプログラムから取得したい場面がたくさんあります。

MQL4では、こうした通貨ペアの情報を取得するためにSymbolInfoInteger関数とSymbolInfoDouble関数が用意されています。そして、それぞれの関数で「何の情報を取得するか」を指定するために使うのが、ENUM_SYMBOL_INFO_INTEGERとENUM_SYMBOL_INFO_DOUBLEという列挙型（enum）の定数です。

この記事では、これらの定数と関数の使い方を、実践的なコードサンプルを交えてわかりやすく解説します。

SymbolInfoInteger関数とENUM_SYMBOL_INFO_INTEGERとは

関数の基本構文

SymbolInfoInteger関数は、指定した通貨ペアの整数型（long型）のプロパティ情報を取得する関数です。2つの書き方があります。

// 書き方① 戻り値で直接値を受け取る
long SymbolInfoInteger(
   string symbol,                        // 通貨ペア名
   ENUM_SYMBOL_INFO_INTEGER prop_id       // 取得したいプロパティの識別子
);

// 書き方② 成功/失敗をboolで受け取り、値は第3引数に格納
bool SymbolInfoInteger(
   string symbol,                        // 通貨ペア名
   ENUM_SYMBOL_INFO_INTEGER prop_id,      // 取得したいプロパティの識別子
   long & var                             // 値を受け取る変数
);

書き方②では、関数の戻り値がbool（true/false）になり、取得に成功したかどうかを判定できます。エラーハンドリングを丁寧に行いたい場合はこちらがおすすめです。

よく使うENUM_SYMBOL_INFO_INTEGERの定数一覧

以下に、EA開発で特によく使う定数をまとめました。

SymbolInfoIntegerの使用例

SymbolInfoInteger関数では、SYMBOL_DIGITS で小数点以下の桁数、SYMBOL_SPREAD でスプレッド、SYMBOL_TRADE_STOPS_LEVEL でストップレベル、SYMBOL_TRADE_FREEZE_LEVEL でフリーズレベルなどの情報を取得できます。以下にコードサンプルを示します。

#property strict

void OnInit()
{
   string symbol = Symbol();

   // 小数点以下の桁数を取得
   int digits = (int)SymbolInfoInteger(symbol, SYMBOL_DIGITS);
   Print("小数点以下の桁数: ", digits);

   // 現在のスプレッドを取得
   int spread = (int)SymbolInfoInteger(symbol, SYMBOL_SPREAD);
   Print("スプレッド: ", spread, " ポイント");

   // ストップレベルを取得
   int stopLevel = (int)SymbolInfoInteger(symbol, SYMBOL_TRADE_STOPS_LEVEL);
   Print("ストップレベル: ", stopLevel, " ポイント");

   // フリーズレベルを取得
   int freezeLevel = (int)SymbolInfoInteger(symbol, SYMBOL_TRADE_FREEZE_LEVEL);
   Print("フリーズレベル: ", freezeLevel, " ポイント");

   // 変動スプレッドかどうか
   bool isFloatSpread = (bool)SymbolInfoInteger(symbol, SYMBOL_SPREAD_FLOAT);
   Print("変動スプレッド: ", isFloatSpread ? "はい" : "いいえ");
}

ポイント：SymbolInfoIntegerの戻り値はlong型なので、intやboolとして使いたい場合は、上記のようにキャスト（型変換）を行いましょう。ENUM_SYMBOL_TRADE_EXECUTIONなどの列挙型の返り値を受け取る場合は、返り値を対応する列挙型にキャスト（型変換）して変数に代入します。

SymbolInfoDouble関数とENUM_SYMBOL_INFO_DOUBLEとは

関数の基本構文

SymbolInfoDouble関数は、指定した通貨ペアに関するプロパティ情報(double型)を取得します。この関数で取得する通貨ペアのプロパティ情報の識別子は ENUM_SYMBOL_INFO_DOUBLE 列挙値から選択します。こちらも2つの書き方があります。

// 書き方① 戻り値で直接値を受け取る
double SymbolInfoDouble(
   string symbol,                        // 通貨ペア名
   ENUM_SYMBOL_INFO_DOUBLE prop_id        // 取得したいプロパティの識別子
);

// 書き方② 成功/失敗をboolで受け取り、値は第3引数に格納
bool SymbolInfoDouble(
   string symbol,                        // 通貨ペア名
   ENUM_SYMBOL_INFO_DOUBLE prop_id,       // 取得したいプロパティの識別子
   double & var                           // 値を受け取る変数
);

よく使うENUM_SYMBOL_INFO_DOUBLEの定数一覧

ENUM_SYMBOL_INFO_DOUBLEには、SYMBOL_BID（Bid売値）、SYMBOL_ASK（Ask買値）、SYMBOL_LAST（直近の約定価格）などの価格情報のほか、各種取引条件の定数が含まれています。

SymbolInfoDoubleの使用例

#property strict

void OnInit()
{
   string symbol = Symbol();

   // Bid / Ask を取得
   double bid = SymbolInfoDouble(symbol, SYMBOL_BID);
   double ask = SymbolInfoDouble(symbol, SYMBOL_ASK);
   Print("Bid: ", bid, " / Ask: ", ask);

   // ポイントサイズを取得
   double point = SymbolInfoDouble(symbol, SYMBOL_POINT);
   Print("1ポイント: ", point);

   // ロット関連情報を取得
   double minLot  = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MIN);
   double maxLot  = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MAX);
   double lotStep = SymbolInfoDouble(symbol, SYMBOL_VOLUME_STEP);
   Print("最小ロット: ", minLot, " / 最大ロット: ", maxLot, " / 刻み: ", lotStep);

   // スワップ情報を取得
   double swapLong  = SymbolInfoDouble(symbol, SYMBOL_SWAP_LONG);
   double swapShort = SymbolInfoDouble(symbol, SYMBOL_SWAP_SHORT);
   Print("買いスワップ: ", swapLong, " / 売りスワップ: ", swapShort);
}

MarketInfo関数との違い ― なぜSymbolInfoXXXを使うべきか

MQL4には、古くからMarketInfo()関数が存在し、通貨ペアの情報を取得できました。しかし、SymbolInfoInteger / SymbolInfoDoubleを使うことをおすすめします。その理由は以下の通りです。

• 型の正確性：MarketInfo()はすべての値をdouble型で返しますが、SymbolInfoIntegerはlong型を返すため、整数値の精度が保たれ、型チェックが正確になります。
• MQL5との互換性：MT4とMT5の両方で動作するコードを書きたい場合は、SymbolInfoDouble()を使うほうがよいとされています。MQL4ではMarketInfo関数でも同様にポイントサイズを取得できますが、MQL4/5共通でSymbolInfoDouble関数が使えるので、そちらを使っておけばよいでしょう。
• エラーハンドリング：書き方②（bool戻り値版）を使えば、情報が取得できなかった場合を明確に判定できます。

// ❌ 古い書き方（MarketInfo）
double spread = MarketInfo(Symbol(), MODE_SPREAD);
double point  = MarketInfo(Symbol(), MODE_POINT);

// ✅ 新しい書き方（SymbolInfoXXX）※推奨
int    spread = (int)SymbolInfoInteger(Symbol(), SYMBOL_SPREAD);
double point  = SymbolInfoDouble(Symbol(), SYMBOL_POINT);

【実践】通貨ペア情報を一括表示するサンプルEA

最後に、ここまで学んだ内容を活用して、チャートに適用した通貨ペアの主要情報をログに一括出力するサンプルEAを紹介します。

//+------------------------------------------------------------------+
//| SymbolInfoViewer.mq4                                             |
//| 通貨ペアの主要情報を一括表示するサンプルEA                         |
//+------------------------------------------------------------------+
#property strict

void OnInit()
{
   string sym = Symbol();

   Print("=== ", sym, " の通貨ペア情報 ===");

   // --- Integer型の情報 ---
   Print("小数桁数 (Digits): ",
         (int)SymbolInfoInteger(sym, SYMBOL_DIGITS));

   Print("スプレッド: ",
         (int)SymbolInfoInteger(sym, SYMBOL_SPREAD), " point");

   Print("変動スプレッド: ",
         (bool)SymbolInfoInteger(sym, SYMBOL_SPREAD_FLOAT));

   Print("ストップレベル: ",
         (int)SymbolInfoInteger(sym, SYMBOL_TRADE_STOPS_LEVEL), " point");

   Print("フリーズレベル: ",
         (int)SymbolInfoInteger(sym, SYMBOL_TRADE_FREEZE_LEVEL), " point");

   // 取引実行モードの取得（列挙型へのキャスト）
   ENUM_SYMBOL_TRADE_EXECUTION exeMode
      = (ENUM_SYMBOL_TRADE_EXECUTION)SymbolInfoInteger(sym, SYMBOL_TRADE_EXEMODE);
   Print("取引執行モード: ", EnumToString(exeMode));

   // --- Double型の情報 ---
   Print("Bid: ", SymbolInfoDouble(sym, SYMBOL_BID));
   Print("Ask: ", SymbolInfoDouble(sym, SYMBOL_ASK));
   Print("Point: ", SymbolInfoDouble(sym, SYMBOL_POINT));

   Print("最小ロット: ", SymbolInfoDouble(sym, SYMBOL_VOLUME_MIN));
   Print("最大ロット: ", SymbolInfoDouble(sym, SYMBOL_VOLUME_MAX));
   Print("ロット刻み: ", SymbolInfoDouble(sym, SYMBOL_VOLUME_STEP));
   Print("契約サイズ: ", SymbolInfoDouble(sym, SYMBOL_TRADE_CONTRACT_SIZE));

   Print("TickValue: ", SymbolInfoDouble(sym, SYMBOL_TRADE_TICK_VALUE));
   Print("TickSize: ",  SymbolInfoDouble(sym, SYMBOL_TRADE_TICK_SIZE));

   Print("買いスワップ: ", SymbolInfoDouble(sym, SYMBOL_SWAP_LONG));
   Print("売りスワップ: ", SymbolInfoDouble(sym, SYMBOL_SWAP_SHORT));

   Print("=== 情報取得完了 ===");
}

このEAをチャートにセットすると、「エキスパート」タブにその通貨ペアの主要な情報が一覧で出力されます。自分のブローカーの設定値を確認したり、EA開発時のデバッグに非常に便利です。

注意点とTips

• 気配値表示ウィンドウに注意：ストラテジーテスターの中ではSymbolInfoやMarketInfoが取得できない時があり、気配値表示ウィンドウに表示されていない通貨ペアでは値が0.0になることがあります。マルチ通貨EAを作る場合は、対象通貨ペアが気配値表示に含まれているか事前に確認しましょう。
• ストップレベルが0の場合：一部のブローカーではストップレベルが0に設定されています。この場合、SL/TPの距離制限がないという意味ではなく、スプレッド分は最低限必要になることが多いため、実際のテストで確認しましょう。
• EnumToString関数の活用：ENUM_SYMBOL_TRADE_EXECUTION型などの列挙型を受け取る場合は、SymbolInfoIntegerの返り値を対応する列挙型にキャストして変数に代入します。EnumToString()を使うと定数名が文字列で返されるのでデバッグに便利です。

まとめ

今回は、MQL4で通貨ペア情報を取得するためのENUM_SYMBOL_INFO_INTEGERとENUM_SYMBOL_INFO_DOUBLEの定数、そしてSymbolInfoInteger関数とSymbolInfoDouble関数の使い方を解説しました。

ポイントを整理すると：

• 整数型の情報（桁数、スプレッド、ストップレベルなど）→ SymbolInfoInteger()
• 小数型の情報（価格、ポイント、ロット数、スワップなど）→ SymbolInfoDouble()
• 古いMarketInfo()より型安全でMQL5互換のSymbolInfoXXXを使おう
• bool戻り値版を使えば、エラーハンドリングもしっかり行える

通貨ペアの情報を正確に取得できるようになると、ロット計算やSL/TP設定、スプレッドフィルターなど、EA開発のあらゆる場面で役立ちます。ぜひ今回のサンプルコードを実際に動かして、自分のブローカーの値を確認してみてください！

投稿 【MQL4】通貨ペア情報を取得する定数と関数を完全解説！ENUM_SYMBOL_INFO_INTEGER / ENUM_SYMBOL_INFO_DOUBLEの使い方 は 自動売買を作ろう！ に最初に表示されました。

MQL4では、チャートの見た目や動作を制御するためのチャートプロパティ定数が用意されています。この記事では、ENUM_CHART_PROPERTY_INTEGER、ENUM_CHART_PROPERTY_STRING、ENUM_CHART_PROPERTY_DOUBLEの3種類の列挙型を中心に、チャート設定の操作方法をわかりやすく解説します。

チャートプロパティを操作する関数の全体像

MQL4では、チャートプロパティの値を「設定する関数」と「取得する関数」がデータ型ごとにペアで用意されています。

これらの関数の第1引数にはチャートIDを指定します。0を指定すると現在のチャートを意味します。第2引数に、これから説明する列挙型の定数を渡すことで、どのプロパティを操作するかを指定します。

ENUM_CHART_PROPERTY_INTEGER — 整数型プロパティ

最も種類が多く、よく使うのがこの整数型プロパティです。チャートの表示/非表示の切り替え、色の設定、モードの変更など幅広い操作ができます。

表示モード系のプロパティ

表示要素の ON/OFF 系プロパティ

色の設定用プロパティ

チャートの配色もすべてプログラムから制御できます。color型の値を指定します。

読み取り専用のプロパティ

以下のプロパティは値の取得のみ可能で、プログラムから変更はできません（読み取り専用 = r/o）。

実践サンプル：チャートの配色をカスタマイズする

以下はEAのOnInit()内でチャートの見た目を一括変更する例です。

int OnInit()
{
   // チャート表示をローソク足に変更
   ChartSetInteger(0, CHART_MODE, CHART_CANDLES);
   
   // 背景色をダークブルーに設定
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, clrMidnightBlue);
   
   // グリッドを非表示にする（背景色と同色でも可）
   ChartSetInteger(0, CHART_SHOW_GRID, false);
   
   // 陽線（Bull）の色設定
   ChartSetInteger(0, CHART_COLOR_CANDLE_BULL, clrDodgerBlue);
   ChartSetInteger(0, CHART_COLOR_CHART_UP, clrDodgerBlue);
   
   // 陰線（Bear）の色設定
   ChartSetInteger(0, CHART_COLOR_CANDLE_BEAR, clrMediumOrchid);
   ChartSetInteger(0, CHART_COLOR_CHART_DOWN, clrMediumOrchid);
   
   // Askラインを表示する
   ChartSetInteger(0, CHART_SHOW_ASK_LINE, true);
   
   // 設定を反映
   ChartRedraw();
   
   return(INIT_SUCCEEDED);
}

ポイント：ChartSetInteger()を呼んだだけでは画面にすぐ反映されないことがあります。確実に描画を更新したい場合は、最後にChartRedraw()を呼びましょう。

ENUM_CHART_PROPERTY_DOUBLE — 浮動小数点型プロパティ

Double型のプロパティは数が少なく、主にチャートの価格範囲を取得するために使います。

実践サンプル：現在のチャート価格範囲を取得する

void OnTick()
{
   // 現在チャートに表示されている価格範囲を取得
   double priceMin = ChartGetDouble(0, CHART_PRICE_MIN);
   double priceMax = ChartGetDouble(0, CHART_PRICE_MAX);
   
   Print("表示中の価格範囲: ", priceMin, " ～ ", priceMax);
}

CHART_PRICE_MINとCHART_PRICE_MAXは、画面上に「今見えている」範囲の最小・最大価格です。スクロールやズームに応じて動的に変化するため、現在の表示状態を知りたいときに便利です。

ENUM_CHART_PROPERTY_STRING — 文字列型プロパティ

文字列型のプロパティは現在1つだけです。

実践サンプル：チャートにコメントを表示する

void OnTick()
{
   // ChartSetString でチャートコメントを設定
   string info = "スプレッド: " + IntegerToString(SymbolInfoInteger(_Symbol, SYMBOL_SPREAD))
               + " / Bid: " + DoubleToString(Bid, _Digits);
   
   ChartSetString(0, CHART_COMMENT, info);
   ChartRedraw();
}

// コメントの取得
void ShowCurrentComment()
{
   string currentComment = ChartGetString(0, CHART_COMMENT);
   Print("現在のコメント: ", currentComment);
}

ChartSetString()によるCHART_COMMENTの設定は、Comment()関数と同様にチャート左上にテキストを表示します。Comment()関数との違いは、チャートIDを指定できるため他のチャートウィンドウに対してもコメントを設定できる点です。

応用テクニック：チャートの設定を保存・復元する

EAやインジケーターでチャートの見た目を変更する場合、終了時に元の設定に戻すのがマナーです。以下のパターンを覚えておきましょう。

// グローバル変数に元の設定を保存
color g_origBgColor;
bool  g_origShowGrid;

int OnInit()
{
   // 元の設定を保存
   g_origBgColor  = (color)ChartGetInteger(0, CHART_COLOR_BACKGROUND);
   g_origShowGrid = (bool)ChartGetInteger(0, CHART_SHOW_GRID);
   
   // 新しい設定を適用
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, clrBlack);
   ChartSetInteger(0, CHART_SHOW_GRID, false);
   ChartRedraw();
   
   return(INIT_SUCCEEDED);
}

void OnDeinit(const int reason)
{
   // 元の設定を復元
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, g_origBgColor);
   ChartSetInteger(0, CHART_SHOW_GRID, g_origShowGrid);
   ChartRedraw();
}

こうすることで、EAを取り外したときにチャートが元の見た目に戻ります。ユーザーにとって親切な設計になりますので、ぜひ習慣にしてください。

よくある注意点とつまずきポイント

① ChartRedraw()を忘れない

チャートプロパティを変更する関数は、実際にはイベントキューにコマンドを追加するだけです。画面への即時反映が必要な場合は、ChartRedraw()を明示的に呼びましょう。

② 第1引数のチャートID

第1引数に0を指定すると「現在のチャート」を意味します。別のチャートを操作したい場合は、ChartID()やChartFirst()/ChartNext()で取得したIDを使います。

③ 読み取り専用プロパティに注意

CHART_WIDTH_IN_PIXELSやCHART_PRICE_MINなどの読み取り専用（r/o）プロパティに対してSet関数を呼んでも、値は変更されません。公式リファレンスで「r/o」の表記を確認しましょう。

④ 新しく開いたチャートの操作タイミング

ChartOpen()で新しくチャートを開いた直後は、まだデータが読み込まれていない場合があります。CHART_PRICE_MINやCHART_PRICE_MAXを取得しても0が返ることがあるため、少し待つか、次のティックで取得するようにしましょう。

まとめ

MQL4のチャートプロパティ定数は、大きく3つの列挙型に分類されます。

• ENUM_CHART_PROPERTY_INTEGER：色・表示切替・モード設定など（最も種類が多い）
• ENUM_CHART_PROPERTY_DOUBLE：価格範囲・スケール関連
• ENUM_CHART_PROPERTY_STRING：チャートコメント

操作にはChartSetInteger()/ChartGetInteger()、ChartSetDouble()/ChartGetDouble()、ChartSetString()/ChartGetString()の6つの関数を使い分けます。

特に、EAやインジケーターでチャートの配色カスタマイズや情報表示を行う際に必須の知識となりますので、まずは本記事のサンプルコードを動かして、チャートプロパティの変更を体験してみてください！

投稿 【MQL4】チャート設定定数を完全理解！ENUM_CHART_PROPERTY_INTEGER・STRING・DOUBLEの使い方 は 自動売買を作ろう！ に最初に表示されました。

ObjectCreate関数の第2引数には、このENUM_OBJECTの値を指定して「どの種類のオブジェクトを作るか」を決定します。しかし、オブジェクトタイプは約44種類もあり、「どんな種類があるの？」「どう使い分けるの？」と迷う方も多いのではないでしょうか。

この記事では、ENUM_OBJECTの全種類を一覧表で整理し、よく使うオブジェクトの実践的なコードサンプルもあわせて解説します。

ENUM_OBJECTとは？

ENUM_OBJECTは、MQL4で定義されている列挙型（enum）の一つで、チャート上に作成できるグラフィカルオブジェクトの種類を表す定数をまとめたものです。

オブジェクトを作成するObjectCreate関数のシグネチャは以下のようになっています。

bool ObjectCreate(
   long         chart_id,   // チャートID（0=現在のチャート）
   string       name,       // オブジェクト名（一意の名前）
   ENUM_OBJECT  type,       // オブジェクトタイプ
   int          sub_window, // サブウィンドウ番号（0=メインウィンドウ）
   datetime     time1,      // 1つ目のアンカーポイントの時刻
   double       price1,     // 1つ目のアンカーポイントの価格
   ...                      // 必要に応じて追加のアンカーポイント
);

第3引数のtypeにENUM_OBJECTの定数値を指定することで、水平線・トレンドライン・矢印・テキストラベルなど、目的に合ったオブジェクトを作成できます。

全オブジェクトタイプ一覧（カテゴリ別）

ENUM_OBJECTに含まれるオブジェクトタイプを、カテゴリ別に整理しました。

ライン系オブジェクト

チャネル系オブジェクト

ギャン系オブジェクト

フィボナッチ系オブジェクト

エリオット波動系オブジェクト

図形系オブジェクト

矢印・マーカー系オブジェクト

テキスト・GUI系オブジェクト

※ アンカー数とは、ObjectCreate関数で指定が必要な座標ポイントの数です。たとえばトレンドラインは始点と終点の2つが必要です。

よく使うオブジェクトの実践コード

ここからは、EA開発やインジケーター作成でよく使うオブジェクトタイプを5つ取り上げ、実際のコードとともに解説します。

①水平線（OBJ_HLINE）を描画する

水平線は特定の価格レベルにラインを引くオブジェクトです。サポート・レジスタンスラインの表示などに使います。アンカーポイントはprice1のみで、time1は意味を持ちませんが、引数として0を渡します。

void DrawHLine(string name, double price, color clr)
{
   // すでに同名のオブジェクトがあれば削除
   if(ObjectFind(0, name) >= 0)
      ObjectDelete(0, name);

   // 水平線を作成（time1は0でOK、price1に価格を指定）
   ObjectCreate(0, name, OBJ_HLINE, 0, 0, price);

   // 色を設定
   ObjectSetInteger(0, name, OBJPROP_COLOR, clr);
   // 線のスタイルを点線に
   ObjectSetInteger(0, name, OBJPROP_STYLE, STYLE_DASH);
   // 線の太さ
   ObjectSetInteger(0, name, OBJPROP_WIDTH, 1);
}

// 使用例：現在の価格に赤い水平線を描画
void OnStart()
{
   DrawHLine("SupportLine", Ask - 50 * _Point, clrRed);
}

②垂直線（OBJ_VLINE）を描画する

垂直線は特定の時刻に縦のラインを引くオブジェクトです。セッション区切りや重要なイベント時刻の表示に使います。アンカーポイントはtime1のみで、price1は0を渡します。

void DrawVLine(string name, datetime time, color clr)
{
   if(ObjectFind(0, name) >= 0)
      ObjectDelete(0, name);

   // 垂直線を作成（time1に時刻を指定、price1は0でOK）
   ObjectCreate(0, name, OBJ_VLINE, 0, time, 0);

   ObjectSetInteger(0, name, OBJPROP_COLOR, clr);
   ObjectSetInteger(0, name, OBJPROP_STYLE, STYLE_DOT);
   ObjectSetInteger(0, name, OBJPROP_WIDTH, 1);
}

// 使用例：現在の足の時刻に青い垂直線を描画
void OnStart()
{
   DrawVLine("EventLine", TimeCurrent(), clrBlue);
}

③矢印マーカー（OBJ_ARROW）を表示する

OBJ_ARROWは、Wingdingsフォントの文字コードを使って任意のアイコンを表示できる汎用的な矢印オブジェクトです。OBJPROP_ARROWCODEプロパティでアイコンの種類を変更できます。

void DrawArrow(string name, datetime time, double price, int arrowCode, color clr)
{
   if(ObjectFind(0, name) >= 0)
      ObjectDelete(0, name);

   // 矢印オブジェクトを作成
   ObjectCreate(0, name, OBJ_ARROW, 0, time, price);

   // 矢印コードを設定（例: 233=上矢印, 234=下矢印）
   ObjectSetInteger(0, name, OBJPROP_ARROWCODE, arrowCode);
   ObjectSetInteger(0, name, OBJPROP_COLOR, clr);
   // 矢印のサイズ
   ObjectSetInteger(0, name, OBJPROP_WIDTH, 2);
}

// 使用例：現在の足に上向き矢印を表示
void OnStart()
{
   DrawArrow("BuySignal", Time[0], Low[0] - 10 * _Point, 233, clrLime);
}

よく使われるWingdingsコードの例：233（上向き矢印）、234（下向き矢印）、159（大きな丸）、161（チェックマーク）などがあります。

④トレンドライン（OBJ_TREND）を描画する

トレンドラインは2つのアンカーポイント（始点と終点）を結ぶ直線です。デフォルトでは右方向に延長されるため、延長が不要な場合はOBJPROP_RAY_RIGHTをfalseに設定します。

void DrawTrendLine(string name, datetime time1, double price1,
                   datetime time2, double price2, color clr)
{
   if(ObjectFind(0, name) >= 0)
      ObjectDelete(0, name);

   // 2点を指定してトレンドラインを作成
   ObjectCreate(0, name, OBJ_TREND, 0, time1, price1, time2, price2);

   ObjectSetInteger(0, name, OBJPROP_COLOR, clr);
   ObjectSetInteger(0, name, OBJPROP_WIDTH, 2);
   // 右方向への延長をオフにする
   ObjectSetInteger(0, name, OBJPROP_RAY_RIGHT, false);
}

// 使用例：5本前の安値から現在の安値へトレンドラインを描画
void OnStart()
{
   DrawTrendLine("MyTrend",
                 Time[5], Low[5],
                 Time[0], Low[0],
                 clrOrangeRed);
}

⑤テキストラベル（OBJ_LABEL）をチャート隅に配置する

OBJ_LABELはピクセル座標ベースのテキストオブジェクトです。チャートをスクロールしても位置が固定されるため、情報パネルやステータス表示に最適です。OBJPROP_CORNERで基準コーナーを、OBJPROP_XDISTANCEとOBJPROP_YDISTANCEで位置を調整します。

void DrawLabel(string name, string text, int corner, int x, int y,
               color clr, int fontSize)
{
   if(ObjectFind(0, name) >= 0)
      ObjectDelete(0, name);

   // ラベルオブジェクトを作成（time/priceは不要なので0）
   ObjectCreate(0, name, OBJ_LABEL, 0, 0, 0);

   // 基準コーナーを設定
   // CORNER_LEFT_UPPER=0, CORNER_RIGHT_UPPER=1
   // CORNER_LEFT_LOWER=2, CORNER_RIGHT_LOWER=3
   ObjectSetInteger(0, name, OBJPROP_CORNER, corner);

   // コーナーからの距離（ピクセル）
   ObjectSetInteger(0, name, OBJPROP_XDISTANCE, x);
   ObjectSetInteger(0, name, OBJPROP_YDISTANCE, y);

   // テキスト内容とフォント
   ObjectSetString(0, name, OBJPROP_TEXT, text);
   ObjectSetString(0, name, OBJPROP_FONT, "Arial Bold");
   ObjectSetInteger(0, name, OBJPROP_FONTSIZE, fontSize);
   ObjectSetInteger(0, name, OBJPROP_COLOR, clr);
}

// 使用例：左上にスプレッド情報を表示
void OnStart()
{
   int spread = (int)MarketInfo(Symbol(), MODE_SPREAD);
   string text = "Spread: " + IntegerToString(spread) + " pts";
   DrawLabel("SpreadLabel", text, CORNER_LEFT_UPPER, 20, 30, clrWhite, 12);
}

ObjectCreate使用時の注意点

オブジェクトを使う際に知っておくべきポイントをまとめます。

オブジェクト名のルール

• 最大63文字まで指定できます。
• ラテン文字（英数字）の使用が推奨されています。日本語文字を使うと環境によって文字化けする可能性があります。
• 同じチャート上でオブジェクト名は一意でなければなりません。

同名オブジェクトが既に存在する場合

ObjectCreate関数は、同名のオブジェクトがすでに存在する場合、新規作成はせず、既存オブジェクトの座標を変更しようとします。この場合、関数はfalseを返しますが、エラーではなく座標の更新が行われることがあります。

意図しない動作を防ぐために、作成前にObjectFindで存在確認し、必要に応じてObjectDeleteで削除してから作成するのが安全です。

オブジェクトの後片付け

EA終了時やインジケーター削除時には、作成したオブジェクトを削除するようにしましょう。OnDeinit関数内で処理するのが一般的です。

void OnDeinit(const int reason)
{
   // プレフィックスが "My_" のオブジェクトをすべて削除
   ObjectsDeleteAll(0, "My_");
}

オブジェクト名にプレフィックス（接頭辞）を付けておくと、ObjectsDeleteAllの第2引数にそのプレフィックスを指定するだけで一括削除できるので便利です。

OBJ_TEXT と OBJ_LABEL の違い

OBJ_TEXTはチャートの時刻・価格座標に固定されるため、チャートをスクロールするとテキストも一緒に動きます。一方、OBJ_LABELはチャートウィンドウのピクセル座標に固定されるため、スクロールしても常に同じ位置に表示されます。常時表示したい情報にはOBJ_LABELを使いましょう。

まとめ

この記事では、MQL4のENUM_OBJECT列挙型について、基本的な概念から全種類の一覧、そして実践的なコードサンプルまでを解説しました。

• ENUM_OBJECTは、ObjectCreate関数でオブジェクトの種類を指定するための列挙型
• ライン系・チャネル系・フィボナッチ系・矢印系・テキスト系など、約44種類のオブジェクトタイプがある
• OBJ_HLINE（水平線）とOBJ_VLINE（垂直線）はアンカーポイントが1つだけ
• OBJ_ARROWはWingdingsコードで様々なアイコンを表示可能
• OBJ_LABELはピクセル座標固定で、情報パネルの作成に最適
• オブジェクト名は63文字以内のラテン文字を推奨。プレフィックスを付けて管理すると後片付けが楽になる

まずは水平線やラベルなど、シンプルなオブジェクトから試してみてください。チャート上にカスタム表示を加えることで、EAやインジケーターの使い勝手が大きく向上します。

投稿 【MQL4】ENUM_OBJECTとは？オブジェクトタイプ定数の全種類一覧と使い方をわかりやすく解説 は 自動売買を作ろう！ に最初に表示されました。

「OP_BUYは分かるけど、OP_BUYLIMITとOP_BUYSTOPの違いって何？」「指値と逆指値がごっちゃになる…」という方も多いのではないでしょうか。

この記事では、MQL4の注文タイプ定数 全6種類を一覧表で整理し、それぞれのコードサンプル付きで徹底解説します。これを読めば、すべての注文タイプを自信を持って使い分けられるようになります。

注文タイプ定数の一覧（全6種類）

まずは全体像を把握しましょう。MQL4で使える注文タイプ定数は以下の6つです。

数値の0〜5を直接書いても動作しますが、定数名を使うことで可読性が格段に上がります。必ず定数名を使いましょう。

成行注文：OP_BUY と OP_SELL

成行注文は「今すぐ約定させたい」ときに使う、最も基本的な注文タイプです。

OP_BUY（買い成行注文）

買い注文はAsk（売値）で約定します。買うときはスプレッド分だけ高い価格で約定する点に注意してください。

// 買い成行注文の例
int ticket = OrderSend(
    Symbol(),       // 現在の通貨ペア
    OP_BUY,         // 買い注文
    0.1,            // 0.1ロット
    Ask,            // 買いはAsk価格を指定
    3,              // スリッページ許容（ポイント）
    0,              // ストップロス（0 = なし）
    0,              // テイクプロフィット（0 = なし）
    "Buy Order",    // コメント
    12345,          // マジックナンバー
    0,              // 有効期限（成行では無関係）
    clrBlue         // チャート上の矢印色
);

if(ticket < 0)
{
    Print("買い注文エラー: ", GetLastError());
}
else
{
    Print("買い注文成功！ チケット番号: ", ticket);
}

OP_SELL（売り成行注文）

売り注文はBid（買値）で約定します。OP_BUYとの違いは、指定する価格がBidになる点です。

// 売り成行注文の例
int ticket = OrderSend(
    Symbol(),       // 現在の通貨ペア
    OP_SELL,        // 売り注文
    0.1,            // 0.1ロット
    Bid,            // 売りはBid価格を指定
    3,              // スリッページ許容
    0,              // ストップロス
    0,              // テイクプロフィット
    "Sell Order",   // コメント
    12345,          // マジックナンバー
    0,              // 有効期限
    clrRed          // チャート上の矢印色
);

if(ticket < 0)
{
    Print("売り注文エラー: ", GetLastError());
}

重要ポイント：買いはAsk、売りはBid。これを逆にするとERR_INVALID_PRICE（エラーコード129）が発生します。初心者がつまずきやすいポイントなので、しっかり覚えておきましょう。

指値注文：OP_BUYLIMIT と OP_SELLLIMIT

指値注文は「今より有利な価格になったら約定させたい」ときに使います。逆張りエントリーに向いている注文タイプです。

OP_BUYLIMIT（買い指値注文）

現在のAsk価格より下の価格を指定して、「そこまで下がったら買いたい」という注文です。押し目買いのイメージです。

// 買い指値注文：現在価格より50pips下で買い予約
double entryPrice = Ask - 50 * Point * 10;  // 50pips下（5桁ブローカーの場合）

int ticket = OrderSend(
    Symbol(),
    OP_BUYLIMIT,     // 買い指値注文
    0.1,
    entryPrice,       // 現在のAskより下の価格
    3,
    entryPrice - 30 * Point * 10,  // SL：エントリーから30pips下
    entryPrice + 60 * Point * 10,  // TP：エントリーから60pips上
    "BuyLimit Order",
    12345,
    0,                // 有効期限（0 = 無期限）
    clrBlue
);

if(ticket < 0)
    Print("買い指値注文エラー: ", GetLastError());

OP_SELLLIMIT（売り指値注文）

現在のBid価格より上の価格を指定して、「そこまで上がったら売りたい」という注文です。戻り売りのイメージです。

// 売り指値注文：現在価格より50pips上で売り予約
double entryPrice = Bid + 50 * Point * 10;

int ticket = OrderSend(
    Symbol(),
    OP_SELLLIMIT,     // 売り指値注文
    0.1,
    entryPrice,        // 現在のBidより上の価格
    3,
    entryPrice + 30 * Point * 10,  // SL：エントリーから30pips上
    entryPrice - 60 * Point * 10,  // TP：エントリーから60pips下
    "SellLimit Order",
    12345,
    0,
    clrRed
);

if(ticket < 0)
    Print("売り指値注文エラー: ", GetLastError());

逆指値注文：OP_BUYSTOP と OP_SELLSTOP

逆指値注文は「今より不利な価格になったら約定させたい」ときに使います。一見すると不利に思えますが、ブレイクアウト狙いの順張りには非常に有効です。

OP_BUYSTOP（買い逆指値注文）

現在のAsk価格より上の価格を指定します。「レジスタンスを上抜けたら買いたい」というブレイクアウト戦略で使います。

// 買い逆指値注文：現在価格より50pips上で買い予約（上抜けブレイク狙い）
double entryPrice = Ask + 50 * Point * 10;

int ticket = OrderSend(
    Symbol(),
    OP_BUYSTOP,       // 買い逆指値注文
    0.1,
    entryPrice,        // 現在のAskより上の価格
    3,
    entryPrice - 30 * Point * 10,  // SL
    entryPrice + 60 * Point * 10,  // TP
    "BuyStop Order",
    12345,
    0,
    clrBlue
);

if(ticket < 0)
    Print("買い逆指値注文エラー: ", GetLastError());

OP_SELLSTOP（売り逆指値注文）

現在のBid価格より下の価格を指定します。「サポートを下抜けたら売りたい」というブレイクアウト戦略で使います。

// 売り逆指値注文：現在価格より50pips下で売り予約（下抜けブレイク狙い）
double entryPrice = Bid - 50 * Point * 10;

int ticket = OrderSend(
    Symbol(),
    OP_SELLSTOP,      // 売り逆指値注文
    0.1,
    entryPrice,        // 現在のBidより下の価格
    3,
    entryPrice + 30 * Point * 10,  // SL
    entryPrice - 60 * Point * 10,  // TP
    "SellStop Order",
    12345,
    0,
    clrRed
);

if(ticket < 0)
    Print("売り逆指値注文エラー: ", GetLastError());

注文タイプの分類整理

6つの注文タイプを改めて分類すると、大きく2つのグループに分けられます。

成行注文（即時約定）

• OP_BUY（0）：今すぐ買う
• OP_SELL（1）：今すぐ売る

待機注文（予約注文）

• OP_BUYLIMIT（2）：今より下で買い予約（逆張り）
• OP_SELLLIMIT（3）：今より上で売り予約（逆張り）
• OP_BUYSTOP（4）：今より上で買い予約（順張り）
• OP_SELLSTOP（5）：今より下で売り予約（順張り）

EAのプログラムでは、成行注文だけで十分なケースも多いですが、ブレイクアウトEAや押し目買いEAを作るなら待機注文の理解は必須です。

OrderType()で注文タイプを判定する

注文タイプ定数は、注文を出すときだけでなくポジション管理でも重要です。OrderType()関数を使えば、選択中の注文がどのタイプかを判定できます。

// 自分のEAが持つ買いポジションだけを決済する例
for(int i = OrdersTotal() - 1; i >= 0; i--)
{
    if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
        continue;

    // マジックナンバーと通貨ペアで自分の注文か判定
    if(OrderMagicNumber() != 12345)
        continue;
    if(OrderSymbol() != Symbol())
        continue;

    // 注文タイプで分岐
    if(OrderType() == OP_BUY)
    {
        // 買いポジションを決済
        bool result = OrderClose(OrderTicket(), OrderLots(), Bid, 3, clrBlue);
        if(!result)
            Print("決済エラー: ", GetLastError());
    }
    else if(OrderType() == OP_SELL)
    {
        // 売りポジションを決済
        bool result = OrderClose(OrderTicket(), OrderLots(), Ask, 3, clrRed);
        if(!result)
            Print("決済エラー: ", GetLastError());
    }
}

ここでも買いの決済はBid、売りの決済はAskを使う点に注意してください。注文時と決済時で使う価格が逆になります。

よくある間違いと注意点

1. 価格の指定ミス（AskとBidの混同）

最も多いエラーがERR_INVALID_PRICE（129）です。以下のルールを覚えましょう。

2. ストップレベルの違反

待機注文の価格が現在価格に近すぎるとERR_INVALID_STOPS（130）が発生します。ブローカーごとに「最低限離さなければならない値幅（ストップレベル）」が設定されています。

// ストップレベルを取得して安全な価格を計算する
int stopLevel = (int)MarketInfo(Symbol(), MODE_STOPLEVEL);
double minDistance = stopLevel * Point;

// 例：OP_BUYLIMITの場合、Ask - minDistance より下の価格を指定する
double safePrice = Ask - minDistance - 10 * Point;  // 余裕を持たせる

3. 待機注文の削除はOrderDelete()を使う

初心者がよく間違えるのが、待機注文の削除にOrderClose()を使ってしまうケースです。

• OrderClose()：成行注文（OP_BUY / OP_SELL）の決済に使う
• OrderDelete()：待機注文（LIMIT / STOP系）のキャンセルに使う

// 待機注文を削除する正しい方法
if(OrderType() == OP_BUYLIMIT || OrderType() == OP_SELLLIMIT ||
   OrderType() == OP_BUYSTOP  || OrderType() == OP_SELLSTOP)
{
    bool result = OrderDelete(OrderTicket());
    if(!result)
        Print("待機注文の削除エラー: ", GetLastError());
}

待機注文に対してOrderClose()を使うとERR_INVALID_FUNCTION_PARAMVALUE（4051）などのエラーになるので注意しましょう。

まとめ

MQL4の注文タイプ定数は全部で6種類あり、大きく3つのカテゴリに分類できます。

• 成行注文：OP_BUY（0）/ OP_SELL（1）→ 今すぐ約定
• 指値注文：OP_BUYLIMIT（2）/ OP_SELLLIMIT（3）→ 有利な価格で予約（逆張り向き）
• 逆指値注文：OP_BUYSTOP（4）/ OP_SELLSTOP（5）→ 不利な方向で予約（ブレイクアウト向き）

覚えるべきポイントは以下の3つです。

• 買いはAsk、売りはBidを必ず守る
• 待機注文はストップレベルを考慮した価格を設定する
• 成行注文の決済はOrderClose()、待機注文のキャンセルはOrderDelete()を使う

まずはOP_BUYとOP_SELLの成行注文から始めて、慣れてきたら指値・逆指値注文にも挑戦してみてください。注文タイプを使い分けられれば、EAの戦略の幅が大きく広がります。

投稿 【MQL4】注文タイプ定数を完全解説！OP_BUY・OP_SELL・指値/逆指値の全6種類を一覧で理解しよう は 自動売買を作ろう！ に最初に表示されました。

この「どの価格を使うか」を指定するために用意されているのが、ENUM_APPLIED_PRICE（適用価格の列挙型）です。全部で7種類の定数があり、iMA()やiRSI()などの組み込み関数で頻繁に使われます。

この記事では、7つの価格定数それぞれの意味と計算式、そして実際のコードでの使い方をわかりやすく解説します。

ENUM_APPLIED_PRICEとは？

ENUM_APPLIED_PRICEは、MQL4で定義されている列挙型（enum）のひとつです。テクニカル指標の計算に使う「価格の種類」を指定するために使います。

たとえば、移動平均線を計算するiMA()関数のシグネチャを見てみましょう。

double iMA(
   string       symbol,           // 通貨ペア
   int          timeframe,        // 時間足
   int          ma_period,        // 期間
   int          ma_shift,         // シフト
   int          ma_method,        // 移動平均の種類
   int          applied_price,    // 適用価格 ← ここ！
   int          shift             // バーのインデックス
);

このapplied_priceの部分に、ENUM_APPLIED_PRICEの定数を指定します。どの定数を選ぶかによって、計算結果が変わってくるわけです。

7つの価格定数一覧

ENUM_APPLIED_PRICEには、以下の7つの定数が定義されています。

PRICE_CLOSE（終値）— 値: 0

もっとも一般的に使われる適用価格です。各ローソク足の終値（Close）を使って計算します。特にこだわりがなければ、まずはこれを選んでおけば問題ありません。多くのトレーダーやテクニカル分析の教科書でも、終値ベースの計算がデフォルトとされています。

PRICE_OPEN（始値）— 値: 1

各ローソク足の始値（Open）を使って計算します。始値はバーの開始時点の価格なので、「そのバーが始まった瞬間にわかる値」という特徴があります。バックテストやリアルタイム処理で、確定済みの値だけを使いたい場合に選ばれることがあります。

PRICE_HIGH（高値）— 値: 2

各ローソク足の高値（High）を使って計算します。高値ベースの移動平均線は、レジスタンスライン（上値抵抗線）のような役割として活用できます。

PRICE_LOW（安値）— 値: 3

各ローソク足の安値（Low）を使って計算します。安値ベースの移動平均線は、サポートライン（下値支持線）のような役割として活用できます。PRICE_HIGHと組み合わせて移動平均チャネルを作る使い方が人気です。

PRICE_MEDIAN（中間値）— 値: 4

計算式は (High + Low) / 2 です。ローソク足の高値と安値のちょうど中間の価格、つまりそのバーの「値幅の中心」を使います。終値の偏りを排除し、そのバーの価格帯の中心で計算したいときに使います。

PRICE_TYPICAL（典型値）— 値: 5

計算式は (High + Low + Close) / 3 です。Median Price（中間値）に終値を加えて3で割った値で、中間値よりも実際の値動きの結果（終値）を反映した価格になります。CCI（商品チャネル指数）などのインジケーターでは、このTypical Priceが標準的に使われています。

PRICE_WEIGHTED（加重終値）— 値: 6

計算式は (High + Low + Close + Close) / 4 です。Typical Price（典型値）の計算式で終値を2回カウントすることで、終値により大きな比重を置いた価格です。「値幅全体も考慮したいけど、やっぱり終値を重視したい」という場合に適しています。

この3つの関係性を整理すると、次のようになります。

• Median Price（HL/2）：ローソク足の値幅の中間値
• Typical Price（HLC/3）：中間値に終値を加え、より実際の値動きに近づけた値
• Weighted Close（HLCC/4）：さらに終値の比重を高め、終値に近づけた値

実際のコードでの使い方

iMA関数での基本的な使用例

もっとも基本的な使い方です。20期間の単純移動平均線を終値ベースで計算します。

void OnTick()
{
   // 20期間SMAを終値(PRICE_CLOSE)で計算
   double ma_close = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

   // 20期間SMAを典型値(PRICE_TYPICAL)で計算
   double ma_typical = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_TYPICAL, 0);

   Print("終値ベースSMA: ", ma_close);
   Print("典型値ベースSMA: ", ma_typical);
}

同じ期間・同じ移動平均の種類でも、適用価格を変えるだけで計算結果が変わることがわかります。

iRSI関数での使用例

RSI（相対力指数）でも適用価格を指定できます。

void OnTick()
{
   // 14期間RSIを終値で計算
   double rsi = iRSI(NULL, 0, 14, PRICE_CLOSE, 0);

   if(rsi > 70)
   {
      Print("RSIが70を超えました（買われすぎ）: ", rsi);
   }
   else if(rsi < 30)
   {
      Print("RSIが30を下回りました（売られすぎ）: ", rsi);
   }
}

HIGH/LOWを使った移動平均チャネルの作成例

PRICE_HIGHとPRICE_LOWを組み合わせると、価格を挟み込むようなチャネル（帯）を作ることができます。

void OnTick()
{
   int period = 20;

   // 高値ベースの移動平均（上側バンド）
   double upper = iMA(NULL, 0, period, 0, MODE_SMA, PRICE_HIGH, 0);

   // 安値ベースの移動平均（下側バンド）
   double lower = iMA(NULL, 0, period, 0, MODE_SMA, PRICE_LOW, 0);

   // 終値ベースの移動平均（中央線）
   double middle = iMA(NULL, 0, period, 0, MODE_SMA, PRICE_CLOSE, 0);

   Print("上側: ", upper, " 中央: ", middle, " 下側: ", lower);

   // 現在価格が上側バンドを超えたら
   if(Ask > upper)
   {
      Print("価格が移動平均チャネルの上側を突破！");
   }
   // 現在価格が下側バンドを下回ったら
   if(Bid < lower)
   {
      Print("価格が移動平均チャネルの下側を突破！");
   }
}

このように、適用価格を変えるだけで同じiMA関数から異なる性質のラインを引くことができます。

input変数でユーザーに選ばせる方法

EAやカスタムインジケーターを作るとき、適用価格をユーザーがパラメーター画面から選べるようにしたいですよね。MQL4では、ENUM_APPLIED_PRICEをinput変数の型として使うことで、自動的にドロップダウンリストが表示されます。

// パラメーター設定
input int                 MAPeriod     = 20;            // 移動平均の期間
input ENUM_MA_METHOD      MAMethod     = MODE_SMA;      // 移動平均の種類
input ENUM_APPLIED_PRICE  MAPrice      = PRICE_CLOSE;   // 適用価格

void OnTick()
{
   double ma = iMA(NULL, 0, MAPeriod, 0, MAMethod, MAPrice, 0);
   Print("MA値: ", ma);
}

このように書くだけで、MetaTraderのパラメーター入力画面に「適用価格」のドロップダウンリストが自動生成されます。ユーザーは「Close price」「Open price」「Median Price (HL/2)」…といった選択肢から直感的に選ぶことができます。

int型で宣言してユーザーに数値を手入力させるよりも、はるかに使いやすく、入力ミスも防げる優れた方法です。EAやインジケーターを配布する場合は、ぜひこの書き方を使いましょう。

定数の整数値を直接使う場合の注意

ENUM_APPLIED_PRICEの各定数には整数値（0〜6）が割り当てられているため、数値を直接指定しても動作します。

// 定数名を使う場合（推奨）
double ma1 = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

// 整数値を直接使う場合（非推奨）
double ma2 = iMA(NULL, 0, 20, 0, MODE_SMA, 0, 0);

上の2行はどちらも同じ結果になりますが、整数値を直接書く方法はおすすめしません。理由は以下の通りです。

• 可読性が低い：「0」だけでは何の価格かすぐにわからない
• 保守性が悪い：後から見たとき、あるいは他の人が見たときに意味が伝わらない
• タイプミスに気づきにくい：定数名なら打ち間違えればコンパイルエラーになるが、数値だと範囲外の値でも気づきにくい

常にPRICE_CLOSEやPRICE_TYPICALのような定数名を使うようにしましょう。

どの適用価格を選ぶべきか？

7種類もあると「結局どれを使えばいいの？」と迷いますよね。以下に用途別の目安をまとめます。

迷ったときはPRICE_CLOSEを選んでおけば、まず間違いありません。そこから最適化やバックテストを行って、他の価格定数を試してみるのがよいでしょう。

まとめ

ENUM_APPLIED_PRICEは、テクニカル指標の計算に「どの価格を使うか」を指定するための列挙型です。今回のポイントを振り返りましょう。

• 7種類の定数がある：PRICE_CLOSE（終値）、PRICE_OPEN（始値）、PRICE_HIGH（高値）、PRICE_LOW（安値）、PRICE_MEDIAN（中間値）、PRICE_TYPICAL（典型値）、PRICE_WEIGHTED（加重終値）
• iMA()やiRSI()などの組み込み関数で、applied_priceパラメーターに指定して使う
• input変数の型にENUM_APPLIED_PRICEを使えば、ドロップダウンリストで選択できるようになる
• 整数値の直接指定は動作するが、可読性の観点から定数名を使うべき
• 迷ったらPRICE_CLOSEが最も無難で一般的

適用価格の選択はインジケーターの計算結果に直接影響するため、それぞれの意味を理解しておくことが大切です。この記事を参考に、自分のEAやインジケーターに最適な適用価格を選んでみてください。

投稿 【MQL4】ENUM_APPLIED_PRICE（価格定数）完全ガイド｜PRICE_CLOSEからPRICE_WEIGHTEDまで7種類を徹底解説 は 自動売買を作ろう！ に最初に表示されました。

この記事では、MQL4で使える時間足定数をすべて一覧で紹介し、基本的な使い方からマルチタイムフレーム分析への応用まで、実践的なコード例とともに解説します。

ENUM_TIMEFRAMESとは？

ENUM_TIMEFRAMESは、MetaTraderのチャート時間足を表す列挙型（enum）です。列挙型とは、あらかじめ決められた名前付きの定数をグループ化したもので、「どの時間足か」をプログラム上でわかりやすく指定するために使います。

例えば、1時間足を指定するときに数値の 60 と書くよりも、PERIOD_H1 と書いたほうが圧倒的に読みやすいですよね。これが時間足定数を使う最大のメリットです。

時間足定数の一覧（MQL4）

MQL4で使用できる時間足定数は、特殊な PERIOD_CURRENT を含めて全部で10個です。以下の表にまとめました。

MQL4の整数値は「分」を基準にしています。例えば PERIOD_H1 は60分なので整数値が60、PERIOD_D1 は1440分（24時間×60分）なので1440です。この規則を覚えておくと、値の意味がすぐに理解できます。

MQL5との違いに注意

MQL4からMQL5へコードを移植する際に、最もハマりやすいポイントの一つがこの時間足定数の整数値の違いです。

MQL5ではビットシフトを用いた全く異なる整数値が割り当てられています。

分足（M1〜M30）まではMQL4とMQL5で同じ値ですが、H1以上は完全に異なります。定数名（PERIOD_H1など）を使っていれば問題ありませんが、整数値をハードコードしていると移植時にバグの原因になります。常に定数名を使う習慣をつけましょう。

基本的な使い方

iMA()で別の時間足の移動平均線を取得する

最もよく使うパターンが、iMA() などのテクニカル指標関数に時間足を指定するケースです。

// 現在の通貨ペアの1時間足で、20期間の単純移動平均線を取得
double ma_h1 = iMA(NULL, PERIOD_H1, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

// 日足の20期間移動平均線を取得
double ma_d1 = iMA(NULL, PERIOD_D1, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

第1引数の NULL は現在の通貨ペアを意味し、第2引数に時間足定数を指定します。

iClose()で別の時間足の終値を取得する

// 日足の1本前（昨日）の終値を取得
double yesterday_close = iClose(NULL, PERIOD_D1, 1);

// 4時間足の現在のバーの始値を取得
double h4_open = iOpen(NULL, PERIOD_H4, 0);

Period()で現在の時間足を取得する

// 現在のチャートの時間足を取得
int current_tf = Period();

// 現在の時間足が1時間足かどうか判定
if(Period() == PERIOD_H1)
{
    Print("現在のチャートは1時間足です");
}

Period() 関数は現在のチャートの時間足を整数値で返します。PERIOD_CURRENTを指定したときと同じ時間足のデータが取得されます。

実践テクニック

inputパラメーターでドロップダウン選択にする

EAのパラメーターに ENUM_TIMEFRAMES 型を使うと、MetaTraderのパラメーター設定画面でドロップダウンリストから時間足を選択できるようになります。これは非常に便利なテクニックです。

input ENUM_TIMEFRAMES InpTimeframe = PERIOD_H1; // 分析する時間足
input int             InpMAPeriod  = 20;         // 移動平均線の期間

void OnTick()
{
    double ma = iMA(NULL, InpTimeframe, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
    // ユーザーが選択した時間足のMAを使って売買判断
}

ユーザーが数値を手入力する必要がなく、選択ミスも防げるので、EA配布時にも親切な設計になります。

PeriodSeconds()で時間足を秒数に変換する

// 現在の時間足の1本あたりの秒数を取得
int seconds = PeriodSeconds(PERIOD_H1);
Print("1時間足の1本 = ", seconds, "秒"); // 3600秒

// 引数を省略すると現在のチャートの時間足が使われる
int current_seconds = PeriodSeconds();

時間計算を行う場面（例：「次のバーが生成されるまで何秒か」など）で非常に役立ちます。

マルチタイムフレーム分析のEAサンプル

実践的な例として、日足のトレンド方向を確認してからエントリーする簡易EAのロジックを紹介します。

input ENUM_TIMEFRAMES InpEntryTF  = PERIOD_H1;  // エントリー判断の時間足
input ENUM_TIMEFRAMES InpFilterTF = PERIOD_D1;  // トレンドフィルターの時間足
input int             InpMAPeriod = 20;          // MA期間

void OnTick()
{
    // 上位足（日足）のMAでトレンド方向を判定
    double ma_filter = iMA(NULL, InpFilterTF, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
    double price_filter = iClose(NULL, InpFilterTF, 0);
    
    bool uptrend   = (price_filter > ma_filter);
    bool downtrend = (price_filter < ma_filter);
    
    // エントリー足のMAでエントリーシグナルを判定
    double ma_entry = iMA(NULL, InpEntryTF, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
    double price_entry = iClose(NULL, InpEntryTF, 0);
    
    // 日足が上昇トレンド かつ 1時間足で価格がMAを上抜け → 買いシグナル
    if(uptrend && price_entry > ma_entry)
    {
        // 買い注文のロジック
        Print("買いシグナル検出！");
    }
    
    // 日足が下降トレンド かつ 1時間足で価格がMAを下抜け → 売りシグナル
    if(downtrend && price_entry < ma_entry)
    {
        // 売り注文のロジック
        Print("売りシグナル検出！");
    }
}

このように、時間足定数を活用すればマルチタイムフレーム分析のロジックを簡潔に書くことができます。

よくある注意点・トラブル

整数値の直書きは避ける

以下のように整数値を直接書くのは避けましょう。

// ❌ 悪い例：何を意味しているのかわかりにくい
double ma = iMA(NULL, 60, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

// ✅ 良い例：PERIOD_H1と書けば一目で1時間足とわかる
double ma = iMA(NULL, PERIOD_H1, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

可読性が下がるだけでなく、MQL5へ移植する際にバグの原因になります。

ヒストリーデータ不足に注意

別の時間足のデータを参照するとき、MetaTraderにその時間足のヒストリーデータが十分にダウンロードされていない場合があります。特にバックテスト時に、上位足のデータが不足していると正しい結果が得られません。

必要な時間足のチャートを一度開いてデータを読み込ませるか、スクリプトで事前にデータの存在を確認する処理を入れておくと安心です。

PERIOD_CURRENTと0の違い

PERIOD_CURRENT の整数値は 0 です。関数に 0 を渡しても PERIOD_CURRENT を渡しても同じ動作になりますが、コードの意図を明確にするために PERIOD_CURRENT を使うことをおすすめします。

まとめ

MQL4の時間足定数（ENUM_TIMEFRAMES）について、重要なポイントを整理します。

• PERIOD_M1〜PERIOD_MN1の9つの時間足定数と、PERIOD_CURRENT（現在のチャートの時間足）が使える
• MQL4の整数値は「分」が基準（H1=60, D1=1440など）
• MQL5ではH1以上の整数値が全く異なるため、移植時は必ず定数名を使う
• input ENUM_TIMEFRAMES でパラメーター化すると、ドロップダウン選択が自動生成されて便利
• PeriodSeconds() で時間足を秒数に変換でき、時間計算に活用できる
• マルチタイムフレーム分析では、上位足のデータ（ヒストリー）が十分にあるか確認が必要

時間足定数はEA開発で日常的に使う基本中の基本です。まずは iMA() や iClose() に異なる時間足を指定するところから試してみてください。マルチタイムフレーム分析ができるようになると、EA戦略の幅が大きく広がりますよ！

投稿 【MQL4】時間足定数（ENUM_TIMEFRAMES）完全ガイド｜PERIOD_M1〜PERIOD_MN1の一覧と実践的な使い方 は 自動売買を作ろう！ に最初に表示されました。

この記事では、ターミナルグローバル変数を操作するための主要関数 ── GlobalVariableSet、GlobalVariableGet、GlobalVariableCheck、GlobalVariableDel を中心に、使い方と注意点をわかりやすく解説します。

ターミナルグローバル変数とは？── 2種類の「グローバル変数」に注意

MQL4には「グローバル変数」と呼ばれるものが2種類あります。ここを混同すると大きな混乱のもとになるので、最初にしっかり区別しましょう。

① MQL4プログラム内のグローバル変数

関数の外（OnInit()やOnTick()の外側）で宣言する変数のことです。プログラム全体からアクセスできますが、EAをチャートから外したりMT4を終了すると値は消えます。

// プログラム内グローバル変数の例
int g_tickCount = 0;  // プログラム内のどの関数からもアクセス可能

void OnTick()
{
    g_tickCount++;
    Print("ティック回数: ", g_tickCount);
}

② クライアントターミナルのグローバル変数（本記事の主役）

MT4のメニュー「ツール → グローバル変数」（ショートカット：F3キー）で確認できる変数です。こちらはMT4を終了してもデータが保持されます。さらに、同じMT4上で動作しているすべてのEA・インジケーターからアクセス可能なので、プログラム間のデータ共有にも使えます。

ターミナルグローバル変数の特徴をまとめると、次のとおりです。

• データ型は double 型のみ（文字列や整数を直接格納することはできません）
• 最後のアクセスから4週間保持され、その後は自動的に削除される
• 同一MT4上の全MQL4プログラムからアクセス可能
• GlobalVariable系の専用関数を使って操作する

主要なグローバル変数関数一覧

以下が、ターミナルグローバル変数を操作するための主要関数です。

この中でも特に使用頻度の高い4つの関数を、コード例とともに詳しく見ていきましょう。

GlobalVariableSet() ── 値の設定・新規作成

ターミナルグローバル変数に値を設定する関数です。指定した名前の変数が存在しない場合は、自動的に新しい変数が作成されます。

// 構文
datetime GlobalVariableSet(
    string name,   // グローバル変数名
    double value   // 設定する値
);

戻り値は、成功した場合に最終アクセス時刻（datetime型）、失敗した場合に0が返ります。

void OnInit()
{
    // グローバル変数 "MyEA_BuyPrice" に値を設定
    datetime dt = GlobalVariableSet("MyEA_BuyPrice", 150.250);
    
    if(dt != 0)
        Print("設定成功！ アクセス時刻: ", TimeToString(dt));
    else
        Print("設定失敗。エラー: ", GetLastError());
}

GlobalVariableGet() ── 値の取得

ターミナルグローバル変数から値を読み取る関数です。戻り値はdouble型です。

// 構文
double GlobalVariableGet(
    string name   // グローバル変数名
);

指定した名前の変数が存在しない場合は0が返り、エラーコードがセットされます。

void OnTick()
{
    double buyPrice = GlobalVariableGet("MyEA_BuyPrice");
    
    if(GetLastError() == 0)
        Print("保存されていた買値: ", buyPrice);
    else
        Print("グローバル変数が見つかりません");
}

💡 ポイント：戻り値が0なのか、それとも「本当に0が格納されている」のか区別がつかない場合があります。確実に存在を確認したい場合は、次に紹介する GlobalVariableCheck() と組み合わせましょう。

GlobalVariableCheck() ── 存在の確認

指定した名前のターミナルグローバル変数が存在するかどうかを確認する関数です。

// 構文
bool GlobalVariableCheck(
    string name   // グローバル変数名
);

変数が存在する場合は true、存在しない場合は false を返します。

void OnInit()
{
    string gvName = "MyEA_BuyPrice";
    
    // 変数が存在するか先に確認してから値を取得する
    if(GlobalVariableCheck(gvName))
    {
        double val = GlobalVariableGet(gvName);
        Print(gvName, " の値: ", val);
    }
    else
    {
        Print(gvName, " は存在しません。初期値を設定します。");
        GlobalVariableSet(gvName, 0.0);
    }
}

このように、GlobalVariableCheck() → GlobalVariableGet() の順で呼び出すのが安全なパターンです。

GlobalVariableDel() ── 変数の削除

不要になったターミナルグローバル変数を削除する関数です。

// 構文
bool GlobalVariableDel(
    string name   // グローバル変数名
);

削除に成功した場合は true、失敗した場合は false を返します。

void OnDeinit(const int reason)
{
    // EA終了時にグローバル変数をクリーンアップ
    if(GlobalVariableDel("MyEA_BuyPrice"))
        Print("グローバル変数を削除しました");
    else
        Print("削除失敗。エラー: ", GetLastError());
}

実践例：EA再起動後もポジション情報を保持する

ここまでの関数を組み合わせた実践的なサンプルを見てみましょう。EAがポジションを持ったときにチケット番号をターミナルグローバル変数に保存し、MT4再起動後でも管理を継続できるようにします。

#property strict

// EA固有のプレフィックスをつけて名前衝突を防ぐ
string gvPrefix = "SampleEA_";

//+------------------------------------------------------------------+
//| 初期化処理                                                        |
//+------------------------------------------------------------------+
void OnInit()
{
    string gvTicket = gvPrefix + Symbol() + "_Ticket";
    
    // 前回保存したチケット番号があるか確認
    if(GlobalVariableCheck(gvTicket))
    {
        int ticket = (int)GlobalVariableGet(gvTicket);
        if(ticket > 0)
        {
            Print("前回のチケット番号を復元: ", ticket);
            // 必要に応じてポジション情報を再取得する処理を追加
        }
    }
    else
    {
        Print("保存済みチケットなし。新規稼働を開始します。");
    }
}

//+------------------------------------------------------------------+
//| ティック処理                                                      |
//+------------------------------------------------------------------+
void OnTick()
{
    string gvTicket = gvPrefix + Symbol() + "_Ticket";
    
    // 新規注文を出す処理（簡略化）
    int ticket = OrderSend(Symbol(), OP_BUY, 0.01, Ask, 3, 0, 0, "SampleEA", 12345, 0, clrBlue);
    
    if(ticket > 0)
    {
        // チケット番号をグローバル変数に保存
        GlobalVariableSet(gvTicket, (double)ticket);
        Print("チケット ", ticket, " をグローバル変数に保存しました");
    }
}

//+------------------------------------------------------------------+
//| 終了処理                                                          |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    // パラメータ変更やチャート切替時はデータを保持
    // 手動削除(REASON_REMOVE)の場合のみクリーンアップ
    if(reason == REASON_REMOVE)
    {
        string gvTicket = gvPrefix + Symbol() + "_Ticket";
        GlobalVariableDel(gvTicket);
        Print("EA削除のため、グローバル変数をクリーンアップしました");
    }
}

グローバル変数を使うときの注意点

1. 名前の衝突に注意 ── プレフィックスをつけよう

ターミナルグローバル変数は同じMT4上の全プログラムで共有されます。異なるEAが同じ名前の変数を使うと、互いに値を上書きしてしまい不具合の原因になります。上のサンプルのように、EA名＋通貨ペア名をプレフィックスとしてつけるのがベストプラクティスです。

2. 格納できるのは double 型のみ

ターミナルグローバル変数に格納できるのはdouble型の値だけです。整数（int）を保存したい場合はキャストが必要です。また、long型の大きな値（例：チャートIDなど）を格納すると、doubleの精度の問題で値が正確に復元できないことがあるので注意が必要です。

3. 4週間でデータが消える

クライアントターミナルのグローバル変数は、最後のアクセスから4週間クライアントターミナルに保持され、その後自動的に削除されます。長期間EAを停止する場合は、この点を意識しておきましょう。定期的にアクセス（読み書き）すればタイマーはリセットされます。

4. 不要な変数は削除する

使わなくなったグローバル変数を放置すると、F3キーで確認したときに一覧が煩雑になります。EA終了時に適切に GlobalVariableDel() で削除するか、GlobalVariablesDeleteAll() でプレフィックス指定の一括削除を行いましょう。

// プレフィックスを指定して一括削除
int deleted = GlobalVariablesDeleteAll("SampleEA_");
Print(deleted, " 個のグローバル変数を削除しました");

補足：その他の便利な関数

主要4関数以外にも、覚えておくと便利な関数を紹介します。

• GlobalVariablesTotal() ── 現在のターミナルグローバル変数の総数を取得
• GlobalVariableName(index) ── インデックス番号から変数名を取得（ループで全変数を列挙する際に便利）
• GlobalVariableSetOnCondition() ── 現在値が指定値と一致する場合のみ更新する（排他制御に利用可能）
• GlobalVariableTemp() ── MT4終了時に自動削除される一時的なグローバル変数を作成
• GlobalVariablesFlush() ── メモリ上のグローバル変数をディスクに強制保存

まとめ

ターミナルグローバル変数は、MQL4プログラミングにおいてデータの永続化やプログラム間のデータ共有を実現するための重要な仕組みです。今回紹介した4つの基本関数を押さえておけば、多くの場面で活用できます。

• GlobalVariableSet() で値を保存
• GlobalVariableGet() で値を取得
• GlobalVariableCheck() で存在を確認
• GlobalVariableDel() で不要な変数を削除

名前の衝突を避けるためにプレフィックスをつけること、double型しか格納できないこと、4週間の有効期限があることを忘れずに、安全で堅牢なEA開発に役立ててください！

**記事のポイント：**

| 項目 | 内容 |

|—|—|

| **タイトル** | 【MQL4】グローバル変数関数の使い方を徹底解説！GlobalVariableSet / Get / Check / Del |

| **タグ** | MQL4, グローバル変数, GlobalVariableSet, EA開発, MetaTrader4 |

| **文字数** | 約8,900文字（HTML含む） / 本文テキスト約3,000文字相当 |

| **構成** | 導入 → 2種類のグローバル変数の区別 → 関数一覧表 → 4関数の詳細解説（構文＋コード例） → 実践サンプル → 注意点4つ → 補足関数 → まとめ |

記事の特徴：

– **初心者が最も混同しやすい「2種類のグローバル変数」の違い**を冒頭で明確に解説

– 各関数に**構文・戻り値・実用コードサンプル**を掲載

– **実践例**として「EA再起動後もチケット番号を保持する」リアルなユースケースを提示

– **注意点**では名前衝突・double型制限・4週間有効期限・long型精度問題など、実開発で陥りやすい落とし穴をカバー

– 補足として `GlobalVariableSetOnCondition` や `GlobalVariableTemp` など発展的な関数も紹介

投稿 【MQL4】グローバル変数関数の使い方を徹底解説！GlobalVariableSet / Get / Check / Del は 自動売買を作ろう！ に最初に表示されました。