MQL5でインジケーター値をEAに取り込む方法｜iMA・iATR・iRSI・CopyBufferの基本

MQL5でEAを開発する時、移動平均線、ATR、RSIなどのインジケーター値をEA側で取得して、シグナル判定やフィルターに使う場面があります。MT5では、インジケーター値を直接関数の戻り値として読むのではなく、インジケーターハンドルを作成し、CopyBufferでバッファ値を取得する構成が基本になります。

CopyBufferは、MQL5でEAからインジケーター値を取得する時に重要な関数です。ただし、ハンドル作成、BarsCalculated、取得本数、バッファ番号、shift、現在足と確定足、ArraySetAsSeries、EMPTY_VALUE、INVALID_HANDLEを理解していないと、値が取れていないのにシグナル判定へ進んでしまうことがあります。

この記事では、MQL5でEAにインジケーター値を取り込むために、iMA、iATR、iRSI、iCustom、CopyBuffer、BarsCalculated、IndicatorRelease、現在足と確定足、ArraySetAsSeries、カスタムインジケーター連携、ログ設計、バックテスト確認までを実務目線で整理します。

なお、この記事はMT5 / MQL5のEA開発、インジケーター値取得、CopyBuffer、ログ確認を目的とした技術記事です。特定の売買判断、利益、勝率、損失回避、推奨ロット、推奨銘柄を案内するものではありません。

この記事で確認すること

MQL5でEAにインジケーター値を取り込む基本

MQL5では、EAからインジケーター値を使いたい場合、まずインジケーターハンドルを作成します。ハンドルとは、MT5内部で作成されたインジケーター計算結果へアクセスするための識別子です。

たとえば、移動平均線ならiMA、ATRならiATR、RSIならiRSIでハンドルを作成します。その後、CopyBufferを使って、指定したバッファ番号、開始位置、取得本数に応じた値を配列へコピーします。

MQL4の感覚で「iMAを呼べば値が返る」と考えていると、MQL5では混乱しやすくなります。MQL5では、ハンドル作成と値取得を分けて考えることが重要です。

インジケーターハンドルとは

インジケーターハンドルは、インジケーターの計算結果をEAから参照するための識別子です。MQL5では、標準インジケーターやカスタムインジケーターを使う時に、まずハンドルを作成します。

ハンドル作成に失敗すると、CopyBufferで値を取得することはできません。ハンドルがINVALID_HANDLEでないかをOnInitで確認し、失敗した場合は理由をログに出すことが重要です。

int ma_handle = INVALID_HANDLE;

int OnInit()
{
   ma_handle = iMA(_Symbol, PERIOD_CURRENT, 20, 0, MODE_SMA, PRICE_CLOSE);

   if(ma_handle == INVALID_HANDLE)
   {
      PrintFormat("HANDLE_FAIL name=iMA symbol=%s tf=%d last_error=%d",
                  _Symbol,
                  PERIOD_CURRENT,
                  GetLastError());
      return INIT_FAILED;
   }

   PrintFormat("HANDLE_OK name=iMA handle=%d symbol=%s tf=%d",
               ma_handle,
               _Symbol,
               PERIOD_CURRENT);

   return INIT_SUCCEEDED;
}

この例では、iMAで移動平均線のハンドルを作成し、INVALID_HANDLEかどうかを確認しています。ハンドル作成に失敗した状態でOnTickへ進むと、CopyBufferが失敗し続けるため、OnInitで止める設計が安全です。

iMAで移動平均線の値を取得する

iMAは、移動平均線のインジケーターハンドルを作成する関数です。EAでは、移動平均線の傾き、価格との位置関係、短期線と長期線のクロスなどを判定するために使うことがあります。

iMAで作成したハンドルから値を取得するにはCopyBufferを使います。移動平均線は通常バッファ0に値が入ります。現在足を使うか、確定足を使うかは、EAの仕様として明確にしてください。

bool GetMAValue(int handle, int shift, double &ma_value)
{
   if(handle == INVALID_HANDLE)
   {
      Print("MA_VALUE_FAIL reason=INVALID_HANDLE");
      return false;
   }

   double buffer[];
   ArraySetAsSeries(buffer, true);

   ResetLastError();

   int copied = CopyBuffer(handle, 0, shift, 1, buffer);

   if(copied != 1)
   {
      PrintFormat("COPYBUFFER_FAIL name=iMA shift=%d copied=%d last_error=%d",
                  shift,
                  copied,
                  GetLastError());
      return false;
   }

   ma_value = buffer[0];

   PrintFormat("COPYBUFFER_OK name=iMA shift=%d value=%.5f",
               shift,
               ma_value);

   return true;
}

この例では、指定shiftの移動平均線値を1本取得しています。shift=0なら現在足、shift=1なら1本前の確定足を参照する考え方になります。シグナル判定の再現性を重視する場合は、確定足を使う設計が一般的です。

iATRでATR値を取得する

iATRは、ATRのインジケーターハンドルを作成する関数です。ATRは、ボラティリティや値幅の確認に使われることがあります。EAでは、SL/TP幅、トレーリング幅、ボラティリティフィルターなどに使う場合があります。

ATRもCopyBufferで値を取得します。ATRが0に見える場合、値が本当に0なのか、CopyBufferに失敗しているのか、計算本数が不足しているのかを分けて確認してください。

int atr_handle = INVALID_HANDLE;

int OnInit()
{
   atr_handle = iATR(_Symbol, PERIOD_CURRENT, 14);

   if(atr_handle == INVALID_HANDLE)
   {
      PrintFormat("HANDLE_FAIL name=iATR last_error=%d", GetLastError());
      return INIT_FAILED;
   }

   PrintFormat("HANDLE_OK name=iATR handle=%d", atr_handle);
   return INIT_SUCCEEDED;
}

bool GetATRValue(int shift, double &atr_value)
{
   double buffer[];
   ArraySetAsSeries(buffer, true);

   ResetLastError();

   int copied = CopyBuffer(atr_handle, 0, shift, 1, buffer);

   if(copied != 1)
   {
      PrintFormat("COPYBUFFER_FAIL name=iATR shift=%d copied=%d last_error=%d",
                  shift,
                  copied,
                  GetLastError());
      return false;
   }

   atr_value = buffer[0];

   PrintFormat("COPYBUFFER_OK name=iATR shift=%d value=%.5f",
               shift,
               atr_value);

   return true;
}

ATRをSL/TPやトレーリング幅に使う場合は、pointやdigits、銘柄仕様もあわせて確認する必要があります。ATR値をそのまま価格距離として使えるかどうかは、銘柄や仕様によって確認が必要です。

iRSIでRSI値を取得する

iRSIは、RSIのインジケーターハンドルを作成する関数です。EAでは、買われすぎ・売られすぎの確認、エントリーフィルター、逆張り条件、トレンド中の過熱確認などに使われることがあります。

RSIも、ハンドル作成後にCopyBufferで値を取得します。RSIは通常0〜100の範囲で表示されますが、値が取れていない場合に初期値や0.0を判定に使ってしまうと、誤判定につながります。

int rsi_handle = INVALID_HANDLE;

bool CreateRSIHandle()
{
   rsi_handle = iRSI(_Symbol, PERIOD_CURRENT, 14, PRICE_CLOSE);

   if(rsi_handle == INVALID_HANDLE)
   {
      PrintFormat("HANDLE_FAIL name=iRSI last_error=%d", GetLastError());
      return false;
   }

   PrintFormat("HANDLE_OK name=iRSI handle=%d", rsi_handle);
   return true;
}

bool GetRSIValue(int shift, double &rsi_value)
{
   double buffer[];
   ArraySetAsSeries(buffer, true);

   ResetLastError();

   int copied = CopyBuffer(rsi_handle, 0, shift, 1, buffer);

   if(copied != 1)
   {
      PrintFormat("COPYBUFFER_FAIL name=iRSI shift=%d copied=%d last_error=%d",
                  shift,
                  copied,
                  GetLastError());
      return false;
   }

   rsi_value = buffer[0];

   PrintFormat("COPYBUFFER_OK name=iRSI shift=%d value=%.2f",
               shift,
               rsi_value);

   return true;
}

RSIを使う場合も、現在足か確定足かを明確にします。現在足のRSIは価格更新に応じて変化するため、シグナルが出たり消えたりすることがあります。確定足のRSIを使う場合は、shift=1を基準にすることが多くなります。

CopyBufferの基本構造

CopyBufferは、インジケーターハンドルから指定したバッファの値を取得する関数です。主に、ハンドル、バッファ番号、開始位置、取得本数、出力先配列を指定します。

CopyBufferを使う時は、戻り値を必ず確認します。戻り値は実際にコピーできた要素数です。要求本数を満たしていない場合は、値を使わずにログへ出して処理を止める方が安全です。

bool CopyIndicatorValues(int handle, int buffer_index, int start_shift, int count, double &values[])
{
   if(handle == INVALID_HANDLE)
   {
      Print("COPYBUFFER_FAIL reason=INVALID_HANDLE");
      return false;
   }

   ArraySetAsSeries(values, true);

   ResetLastError();

   int copied = CopyBuffer(handle, buffer_index, start_shift, count, values);

   if(copied != count)
   {
      PrintFormat("COPYBUFFER_FAIL buffer=%d start=%d count=%d copied=%d last_error=%d",
                  buffer_index,
                  start_shift,
                  count,
                  copied,
                  GetLastError());
      return false;
   }

   PrintFormat("COPYBUFFER_OK buffer=%d start=%d count=%d value0=%.5f",
               buffer_index,
               start_shift,
               count,
               values[0]);

   return true;
}

この例では、CopyBufferの戻り値が要求本数と一致するかを確認しています。取得本数が不足した状態で配列を参照すると、誤判定や配列範囲エラーにつながる可能性があります。

BarsCalculatedで計算済み本数を確認する

BarsCalculatedは、インジケーターの計算済み本数を確認するために使います。ハンドルが作成できても、必要な本数がまだ計算されていない場合、CopyBufferで十分な値を取得できないことがあります。

EA起動直後、バックテスト開始直後、MTF、マルチシンボル、iCustom利用時などは、計算済み本数が不足することがあります。BarsCalculatedで必要本数に達しているか確認してからCopyBufferへ進むと、失敗原因を切り分けやすくなります。

bool IsIndicatorReady(int handle, int needed_bars)
{
   if(handle == INVALID_HANDLE)
   {
      Print("INDICATOR_READY_FAIL reason=INVALID_HANDLE");
      return false;
   }

   ResetLastError();

   int calculated = BarsCalculated(handle);

   if(calculated < needed_bars)
   {
      PrintFormat("INDICATOR_NOT_READY calculated=%d needed=%d last_error=%d",
                  calculated,
                  needed_bars,
                  GetLastError());
      return false;
   }

   PrintFormat("INDICATOR_READY calculated=%d needed=%d",
               calculated,
               needed_bars);

   return true;
}

この例では、BarsCalculatedの値が必要本数を満たしているかを確認しています。計算済み本数が不足している場合は、シグナル判定へ進まず、ログを出して見送る方が安全です。

現在足と確定足を分けて扱う

インジケーター値をEAに取り込む時は、現在足と確定足を分けて扱う必要があります。現在足は価格更新に応じて値が変化します。確定足はすでに閉じた足なので、判定の再現性が高くなります。

CopyBufferでstart positionに0を指定すると、現在足の値を取得する構成になります。start positionに1を指定すると、1本前の確定足の値を取得する構成になります。どちらを使うかは、EAの仕様として明確にしてください。

バックテストで再現性を重視する場合や、シグナルの出たり消えたりを避けたい場合は、確定足を使う設計が扱いやすいです。一方で、リアルタイム性を重視するEAでは現在足を使う場合もあります。その場合は、ログで値の変化を確認できるようにしてください。

ArraySetAsSeriesと配列方向の注意

CopyBufferで取得した値を配列で扱う時は、ArraySetAsSeriesの設定を確認します。ArraySetAsSeriesをtrueにすると、配列の0番目を最新側として扱いやすくなります。

配列方向を確認せずにbuffer[0]やbuffer[1]を使うと、現在足と確定足を取り違える可能性があります。特にCopyBuffer、CopyRates、CopyCloseを混在させるEAでは、配列方向を統一しておくと確認しやすくなります。

EMPTY_VALUEと取得失敗を混同しない

インジケーターによっては、値が存在しない場所にEMPTY_VALUEが入ることがあります。特に矢印系インジケーター、サイン系インジケーター、条件成立時だけ値を出すカスタムインジケーターでは、EMPTY_VALUEの確認が重要です。

CopyBufferの失敗とEMPTY_VALUEは別です。CopyBufferが成功していても、取得した値がEMPTY_VALUEの場合、そのバーではシグナルが出ていない可能性があります。一方で、CopyBuffer自体が失敗している場合は、インジケーター値を判定に使うべきではありません。

bool GetSignalValue(int handle, int buffer_index, int shift, double &signal_value)
{
   double buffer[];
   ArraySetAsSeries(buffer, true);

   ResetLastError();

   int copied = CopyBuffer(handle, buffer_index, shift, 1, buffer);

   if(copied != 1)
   {
      PrintFormat("SIGNAL_COPY_FAIL buffer=%d shift=%d copied=%d last_error=%d",
                  buffer_index,
                  shift,
                  copied,
                  GetLastError());
      return false;
   }

   if(buffer[0] == EMPTY_VALUE)
   {
      PrintFormat("SIGNAL_EMPTY buffer=%d shift=%d", buffer_index, shift);
      return false;
   }

   signal_value = buffer[0];

   PrintFormat("SIGNAL_VALUE buffer=%d shift=%d value=%.5f",
               buffer_index,
               shift,
               signal_value);

   return true;
}

この例では、CopyBuffer失敗とEMPTY_VALUEを分けてログに出しています。サイン系インジケーターをEAへ取り込む場合は、この切り分けが非常に重要です。

iCustomでカスタムインジケーター値を取得する

iCustomは、カスタムインジケーターのハンドルを作成するために使います。EAから自作インジケーターや外部インジケーターの値を取得したい場合、iCustomでハンドルを作成し、CopyBufferでバッファ値を取得します。

iCustomを使う時は、インジケーターファイル名、input引数の順番、バッファ番号、サブウィンドウ、EMPTY_VALUE、再描画の有無を確認します。カスタムインジケーター側の仕様が分からないままEAへ取り込むと、値の意味を誤解する可能性があります。

int custom_handle = INVALID_HANDLE;

bool CreateCustomIndicatorHandle()
{
   custom_handle = iCustom(_Symbol, PERIOD_CURRENT, "MyCustomIndicator", 14, 2.0);

   if(custom_handle == INVALID_HANDLE)
   {
      PrintFormat("HANDLE_FAIL name=MyCustomIndicator last_error=%d",
                  GetLastError());
      return false;
   }

   PrintFormat("HANDLE_OK name=MyCustomIndicator handle=%d",
               custom_handle);

   return true;
}

この例では、MyCustomIndicatorというカスタムインジケーターをiCustomで呼び出しています。実際には、ファイル名、パス、input引数、バッファ番号が正しいかを確認してください。

カスタムインジケーター連携で確認すること

カスタムインジケーターをEAに取り込む場合は、標準インジケーターよりも確認項目が増えます。特に、どのバッファに何の値が入っているか、サインが出ない時にEMPTY_VALUEになるのか0になるのか、現在足で値が変わるのか、確定足で固定されるのかを確認します。

インジケーター側が描画用に作られている場合、EAから読み取る用途に適していないこともあります。バッファが公開されているか、CopyBufferで取得できるか、描画オブジェクトだけで値を出していないかを確認してください。

IndicatorReleaseでハンドルを解放する

EA終了時には、作成したインジケーターハンドルをIndicatorReleaseで解放します。OnDeinitで後処理を行うことで、リソース管理が明確になります。

短いサンプルでは省略されることがありますが、複数インジケーター、MTF、マルチシンボル、iCustomを多用するEAでは、ハンドル管理を整理しておくと保守しやすくなります。

void OnDeinit(const int reason)
{
   if(ma_handle != INVALID_HANDLE)
   {
      IndicatorRelease(ma_handle);
      PrintFormat("HANDLE_RELEASE name=iMA handle=%d reason=%d",
                  ma_handle,
                  reason);
      ma_handle = INVALID_HANDLE;
   }

   if(atr_handle != INVALID_HANDLE)
   {
      IndicatorRelease(atr_handle);
      PrintFormat("HANDLE_RELEASE name=iATR handle=%d reason=%d",
                  atr_handle,
                  reason);
      atr_handle = INVALID_HANDLE;
   }

   if(rsi_handle != INVALID_HANDLE)
   {
      IndicatorRelease(rsi_handle);
      PrintFormat("HANDLE_RELEASE name=iRSI handle=%d reason=%d",
                  rsi_handle,
                  reason);
      rsi_handle = INVALID_HANDLE;
   }
}

この例では、各ハンドルが有効な場合だけIndicatorReleaseを呼び出し、その後INVALID_HANDLEへ戻しています。ログにreasonを出しておくと、EA終了理由の確認にも役立ちます。

MTFでインジケーター値を取得する時の注意

MTFでは、現在チャートとは別の時間足のインジケーター値を取得します。たとえば、M5チャート上でEAを動かしながら、H1の移動平均線やRSIをフィルターに使うような構成です。

MTFで注意すべきなのは、現在チャートのバー更新と上位足のバー更新が一致しないことです。上位足のshift=0は形成中であり、値が変わります。上位足をフィルターに使う場合は、shift=1の確定足を使うか、現在足を使うかを仕様として明確にします。

int h1_ma_handle = INVALID_HANDLE;

bool CreateH1MAHandle()
{
   h1_ma_handle = iMA(_Symbol, PERIOD_H1, 20, 0, MODE_SMA, PRICE_CLOSE);

   if(h1_ma_handle == INVALID_HANDLE)
   {
      PrintFormat("HANDLE_FAIL name=H1_MA last_error=%d", GetLastError());
      return false;
   }

   PrintFormat("HANDLE_OK name=H1_MA handle=%d", h1_ma_handle);
   return true;
}

上位足の値が取得できない場合は、時間足データ不足、バックテスト開始直後、BarsCalculated不足を確認します。MTFでは、CopyBuffer失敗をシグナル不成立と混同しないようにしてください。

マルチシンボルでインジケーター値を取得する時の注意

マルチシンボルEAでは、現在チャートとは別の銘柄のインジケーター値を取得することがあります。この場合、対象銘柄がMarket Watchに表示されているか、SymbolSelectで選択できているか、ヒストリーデータがあるかを確認する必要があります。

別銘柄のiMAやiRSIハンドルを作る場合は、_Symbolに固定せず、対象symbolを引数として渡す構成にします。銘柄ごとにハンドルを管理する必要があるため、単一ハンドルのEAよりも管理が複雑になります。

bool PrepareSymbol(string symbol)
{
   ResetLastError();

   if(!SymbolSelect(symbol, true))
   {
      PrintFormat("SYMBOL_SELECT_FAIL symbol=%s last_error=%d",
                  symbol,
                  GetLastError());
      return false;
   }

   PrintFormat("SYMBOL_SELECT_OK symbol=%s", symbol);
   return true;
}

SymbolSelectに失敗した状態でインジケーターハンドルを作成すると、ハンドル作成やCopyBufferに失敗する可能性があります。マルチシンボルEAでは、対象銘柄ごとの準備ログを残してください。

CopyBuffer失敗時に確認すること

CopyBufferが失敗する場合は、ハンドル、バッファ番号、取得開始位置、取得本数、計算済み本数、配列方向、対象銘柄、対象時間足、GetLastErrorを確認します。値が取れない理由を1つに決めつけないことが重要です。

バックテストでCopyBufferを確認する

バックテストでは、EAの損益結果だけでなく、インジケーター値が正しく取得できているかを確認します。特に、CopyBufferの取得本数、BarsCalculated、shift、現在足と確定足、MTF、iCustomのバッファ番号をログで確認してください。

バックテスト開始直後は、インジケーター計算に必要な本数が揃っていない場合があります。その状態でCopyBuffer結果を使ってしまうと、シグナル不成立や誤判定につながります。

EAに取り込んだインジケーター値をどこで使うかを分ける

EAにインジケーター値を取り込む時は、値を取得できたかどうかだけでなく、その値をEA内部のどこで使うかを先に分ける必要があります。

同じMA値やRSI値でも、エントリー方向を決めるために使うのか、エントリーを見送るフィルターとして使うのか、決済条件として使うのか、通知やパネル表示だけに使うのかで、必要な確認内容が変わります。

たとえば、RSIが30未満になったことを通知するだけなら、値取得と通知重複防止が中心です。一方で、自動発注EAとして使う場合は、スプレッド、既存ポジション、Magic Number、証拠金、ロット、OrderCheck、取引時間、外部停止条件まで確認する必要があります。

EA設計では、インジケーター値を取得した時点で発注へ直結させないことが重要です。値取得、値の妥当性確認、signal判定、entry gate、risk確認、executionを分けることで、後からログを見た時にどの段階で止まったのかを確認できます。

この分離がないと、「CopyBufferは成功しているのにEAが入らない」という状態になった時、値が悪いのか、判定条件が悪いのか、発注前条件で止まったのか、注文処理で失敗したのかを切り分けできません。

標準インジケーター別のEA取り込み方

EAへ取り込む標準インジケーターは、それぞれ値の性質が異なります。すべてを同じ「数値」として扱うのではなく、値の単位、意味、使う責務を分けて確認してください。

たとえば、ATRはエントリー方向を直接決めるインジケーターではありません。ATRが大きいからBUY、ATRが小さいからSELLという使い方ではなく、相場の値幅やボラティリティ環境を確認するために使う方が自然です。

一方で、MAは価格と同じような水準の値を返すため、価格との比較や短期線・長期線の比較に使いやすいです。ただし、現在足の終値と確定足のMAを比較するなど、参照足がズレると判定が不自然になります。

RSIやStochasticは、価格そのものではなく指標値です。0〜100の範囲で評価する値を、価格差やpipsと同じ単位で扱わないようにしてください。

CopyBufferで取得できた値を使える値として扱う前の確認

CopyBufferが成功したように見えても、その値をEA判定に使ってよいとは限りません。取得本数が足りているか、値がEMPTY_VALUEではないか、NaNではないか、意図したshiftの値か、buffer番号が正しいかを確認する必要があります。

値取得の成功、値の有効性、signal成立は別の段階です。CopyBufferが成功しても、EMPTY_VALUEならサインなしの可能性があります。値が有効でも、EAのsignal条件を満たしていないならWAITです。

この段階を分けずに実装すると、正常なWAIT状態をエラー扱いしたり、取得失敗をシグナル不成立として見逃したりします。ログ上でも、COPYBUFFER_FAIL、VALUE_EMPTY、SIGNAL_WAIT、ENTRY_BLOCKを分けると確認しやすくなります。

現在足を使うEAと確定足を使うEAの違い

インジケーター値をEAへ取り込む時、現在足を使う設計と、確定足を使う設計では挙動が大きく変わります。

現在足は価格更新に応じて変化します。シグナルが早く出る一方で、同じバーの中で条件が成立したり不成立になったりすることがあります。確定足は反応が遅くなりますが、検証結果と実運用の照合がしやすくなります。

「チャートではサインが出ているのにEAが入らない」という相談では、現在足と確定足の違いが原因になっていることがあります。チャート上で見ているサインが現在足の変動中サインで、EAが確定足を見ている場合、見え方が違って当然です。

そのため、EA仕様書やinput説明では、判定basisを明記してください。たとえば、SignalShift=1なら確定足基準、SignalShift=0なら現在足基準というように、利用者が分かる形にしておくと問い合わせ対応もしやすくなります。

iCustomでサイン系インジケーターをEA化する時の確認順序

サイン系カスタムインジケーターをEA化する場合、標準インジケーターより確認項目が多くなります。

特に、買いサインと売りサインがどのbufferに入っているのか、サインがない時にEMPTY_VALUEを返すのか0を返すのか、現在足でサインが消えるのか、確定足で固定されるのかを確認する必要があります。

カスタムインジケーターのソースコードがある場合は、SetIndexBuffer、OnCalculate、EMPTY_VALUEの入れ方を確認できます。ソースコードがない場合は、Data Window、チャート表示、CopyBufferログを使って推測することになります。

ex5のみのインジケーターをEA化する場合、内部bufferの意味が完全には分からないことがあります。この場合は、すぐに自動発注へつなげず、まず通知やログ出力でサイン検出の再現性を確認する方が安全です。

値取得できているのにEAが動かない時の切り分け

CopyBufferで値が取れているにもかかわらず、EAがエントリーしない場合があります。この場合、インジケーター値の取得は成功しているため、次にsignal判定、filter、entry gate、risk、executionを確認します。

EAが動かない時に「インジケーター値が取れていない」と決めつけるのは危険です。実際には、インジケーター値は正常に取れているが、entry gateやrisk条件で止まっている場合があります。

そのため、ログでは、VALUE_OK、SIGNAL_EVAL、FILTER_BLOCK、ENTRY_BLOCK、RISK_BLOCK、ORDER_RESULT のように段階を分けると原因を追いやすくなります。

ATRをSL幅やトレーリングに使う時の注意点

ATRは、EAでSL幅、トレーリング幅、ボラティリティ判定に使われることがあります。ただし、ATR値をそのままpipsとして扱うと、銘柄や桁数によって誤った距離になる可能性があります。

ATRを使う場合は、単に「ATRが大きいから広いSL」「ATRが小さいから狭いSL」とするだけでは不十分です。銘柄仕様、StopLevel、スプレッド、証拠金、ロット計算と合わせて確認する必要があります。

また、ATRは相場環境を示す値であり、売買方向そのものを決める値ではありません。EA内部では、signalではなく、risk補助、volatility filter、exit補助として扱う方が自然な場面が多くあります。

通知・半裁量・完全自動で確認項目を変える

同じインジケーター値取得でも、通知ツール、半裁量EA、完全自動EAでは、必要な確認項目が異なります。

通知ツールでは、値取得と重複通知防止が中心です。半裁量EAでは、サイン表示や手動実行ボタン、誤操作防止が重要です。完全自動EAでは、発注前のentry gate、risk、execution、注文結果確認まで必要になります。

インジケーター値を取得できるようになったからといって、すぐに完全自動発注へ接続する必要はありません。まず通知やログで検証し、サインの再現性、リペイント有無、確定足での残り方を確認してから、発注処理へ進める方が安全です。

EAファンクラブでは、インジケーター値取得を、通知、表示、判定、発注、決済、リスク管理へ分けて扱います。これにより、後から「通知だけ使う」「発注を止める」「ログ検証だけ行う」といった運用に切り替えやすくなります。

検証時に残すべき証跡

EAにインジケーター値を取り込む処理を検証する場合、単にバックテストを実行するだけでは不十分です。どの値を、どの足で、どのbufferから取得し、どの判定に使ったのかを確認できる証跡が必要です。

不具合調査では、「動かない」という説明だけでは原因を特定できません。値取得に失敗しているのか、値は取れているがsignal条件を満たしていないのか、entry gateで止まっているのか、注文処理で失敗しているのかをログで分けてください。

特にCopyBuffer関連では、buffer、shift、copied、last_error、BarsCalculated、取得値、basisを同じ行に残すと、後から原因を確認しやすくなります。

CopyBufferのログ設計

CopyBufferを使うEAでは、ログ設計が重要です。EAが注文しない時、ロジック条件ではなく、インジケーター値が取得できていないことが原因の場合があります。

ログ名は、HANDLE_OK、HANDLE_FAIL、INDICATOR_READY、INDICATOR_NOT_READY、COPYBUFFER_OK、COPYBUFFER_FAIL、SIGNAL_EMPTYのように分けると検索しやすくなります。

開発依頼前に整理する情報

EAにインジケーター値を取り込みたい場合や、CopyBufferが失敗する不具合を相談する場合は、対象EA、対象インジケーター、setファイル、銘柄、時間足、ハンドル作成ログ、CopyBufferログ、バッファ番号、shift指定を整理してください。

特にカスタムインジケーターをEAに取り込む場合は、インジケーター側のバッファ仕様が重要です。買いサイン、売りサイン、ライン、フィルター値がどのバッファに入っているのか、値なしがEMPTY_VALUEなのか0なのかを確認してください。

CopyBuffer実務チェック表

よくある質問

MQL5でiMAを呼べば移動平均線の値が直接返りますか？

MQL5では、iMAは基本的にインジケーターハンドルを返します。移動平均線の値を取得するには、そのハンドルを使ってCopyBufferでバッファ値を取得します。

CopyBufferの戻り値は何を意味しますか？

CopyBufferの戻り値は、実際にコピーできた要素数です。要求本数と一致していない場合は、取得不足として扱い、ログを出して判定を止める方が安全です。

shift=0とshift=1はどちらを使えばよいですか？

shift=0は現在足、shift=1は1本前の確定足として扱うことが多いです。現在足は値が変化するため、再現性を重視する場合は確定足を使う設計が扱いやすいです。

BarsCalculatedは必ず確認すべきですか？

確認した方が安全です。ハンドルが有効でも、インジケーターの計算本数が不足していると、CopyBufferで必要本数を取得できないことがあります。

iCustomで値が取れない時は何を確認しますか？

インジケーター名、ファイルパス、input引数、バッファ番号、EMPTY_VALUE、ハンドル作成結果、BarsCalculated、CopyBufferの戻り値を確認します。カスタムインジケーター側の仕様確認も必要です。

CopyBufferで0.0が返った場合は取得成功ですか？

0.0が有効な値である場合もありますが、取得失敗や初期値の可能性もあります。CopyBufferの戻り値、GetLastError、BarsCalculated、EMPTY_VALUEを確認し、値の意味を分けて判断してください。

関連ページ

インジケーター値をEAに取り込む時は、時系列データ、インジケーター開発、マルチシンボル、ログ確認、EA設計、バックテストもあわせて確認すると、CopyBuffer失敗やシグナル不成立の原因を切り分けやすくなります。

まとめ

MQL5でEAにインジケーター値を取り込む時は、iMA、iATR、iRSI、iCustomでハンドルを作成し、CopyBufferで値を取得します。ハンドル作成と値取得は別の工程として考え、INVALID_HANDLE、BarsCalculated、CopyBufferの戻り値を必ず確認してください。

CopyBufferでは、バッファ番号、shift、取得本数、配列方向、EMPTY_VALUEを確認することが重要です。現在足と確定足を混同すると、シグナルが出たり消えたりすることがあります。再現性を重視する場合は、確定足を使う設計が扱いやすいです。

カスタムインジケーターをiCustomでEAに取り込む場合は、ファイル名、input引数、バッファ番号、値なしの扱いを確認してください。バックテストや不具合調査では、ハンドル作成ログ、BarsCalculated、CopyBufferの戻り値、取得値、setファイル、検証条件を整理して確認することが重要です。