MQL5時系列・価格取得関数辞典｜CopyRates・iClose・SymbolInfo・Time系まとめ

MQL5でEAやインジケーターを開発する場合、ローソク足、価格、時刻、銘柄仕様を正しく取得できるかどうかは、シグナル判定、エントリー判定、決済判定、リスク管理、ログ確認のすべてに影響します。

特に、CopyRates、CopyOpen / CopyHigh / CopyLow / CopyClose、CopyTime、iOpen / iHigh / iLow / iClose / iTime、SymbolInfoDouble / SymbolInfoInteger / SymbolInfoString、TimeCurrent、TimeTradeServer、PeriodSeconds は、EA開発で頻繁に使う基本関数です。

この記事では、MQL5の時系列・価格取得関数を、EA開発や不具合調査で確認しやすい辞典形式で整理します。公式リファレンスの代わりに丸暗記するためではなく、どの関数を、どの場面で使い、どの戻り値・取得件数・時刻基準・ログを確認するかを整理するための記事です。

注意：この記事はMQL5開発・EA動作確認・インジケーター連携・不具合調査のための技術解説です。特定の売買判断、推奨エントリー、推奨ロット、推奨銘柄、利益保証、勝率保証、損失回避保証を行うものではありません。実運用前には、必ずデモ環境や検証環境で動作を確認してください。

MQL5時系列・価格取得関数の全体像

MQL5の時系列・価格取得関数は、ローソク足をまとめて取得する関数、単一価格を取得する関数、銘柄仕様を取得する関数、時刻を取得する関数に分けて理解すると整理しやすくなります。

価格取得関数は目的別に選ぶ

価格取得では、何を確認したいかによって使う関数が変わります。直近の終値だけならiCloseでも確認できますが、複数本のローソク足を使う判定ではCopyRatesやCopyCloseの方が管理しやすい場合があります。

CopyRates

CopyRatesは、指定した銘柄・時間足のローソク足情報をMqlRates配列として取得する関数です。OHLCだけでなく、バー時刻、tick volume、spread、real volumeもまとめて扱えるため、EAやインジケーターの判定で使いやすい関数です。

CopyRatesで確認すること

CopyOpen / CopyHigh / CopyLow / CopyClose

CopyOpen、CopyHigh、CopyLow、CopyCloseは、それぞれOpen、High、Low、Closeを配列で取得する関数です。終値だけ、安値だけ、高値だけなど、必要な価格だけを複数本取得したい場合に使います。

CopyCloseでよくある確認ミス

CopyTime

CopyTimeは、指定した銘柄・時間足のバー時刻を配列で取得する関数です。新バー判定、マルチタイムフレーム同期、履歴データ確認でよく使います。

新バー判定で確認すること

iOpen / iHigh / iLow / iClose / iTime

iOpen、iHigh、iLow、iClose、iTimeは、指定したsymbol、timeframe、shiftの価格や時刻を取得する関数です。単発で特定バーの値を確認したい場合に使いやすい一方、複数本を扱う場合はCopy系関数の方がログ追跡しやすい場合があります。

iCloseで確認すること

SymbolInfoDouble / SymbolInfoInteger / SymbolInfoString

SymbolInfo系関数は、銘柄の価格、仕様、取引条件、文字列情報を取得するために使います。発注前のロット確認、spread確認、point換算、StopsLevel確認、銘柄名確認で重要です。

SymbolInfoDoubleでよく確認する値

SymbolInfoIntegerでよく確認する値

SymbolInfoTick

SymbolInfoTickは、指定銘柄の最新tick情報をMqlTick構造体で取得する関数です。Bid、Ask、last、volume、timeをまとめて確認できます。

TimeCurrent

TimeCurrentは、最後に受信した気配値に基づくサーバー時刻を取得する関数です。EAの時間制御、日次処理、新バー判定補助、ログ出力でよく使います。

TimeCurrentはPCローカル時刻ではありません。また、tickが来ない時間帯では更新タイミングに注意が必要です。

TimeTradeServer

TimeTradeServerは、取引サーバー時刻を取得する関数です。サーバー時刻を基準にした外部制御、日次処理、カレンダー制御、稼働時間判定で確認対象になることがあります。

PeriodSeconds

PeriodSecondsは、時間足を秒数へ変換して取得する関数です。バー時間幅、タイマー処理、一定時間経過確認、MTF処理の補助に使います。

現在足と確定足

価格取得で最も重要な確認ポイントのひとつが、現在足と確定足の違いです。現在足は形成中のバーであり、価格が変化します。確定足はすでに閉じたバーであり、検証やEA判定で再現性を取りやすくなります。

確認ポイント：EAの条件判定では、現在足を使うのか、確定足を使うのかを必ず決めてください。ログには、shift、bar time、TimeCurrent、取得した価格値をセットで残すと原因を追いやすくなります。

データ不足時の確認

CopyRatesやCopyCloseで必要本数が取れない場合、すぐに不具合と判断せず、履歴データ、対象symbol、timeframe、Market Watch、初回ロード中かどうかを確認します。

EA利用者向けの確認ポイント

EAが想定どおりにエントリーしない、決済しない、サインとズレる場合は、価格取得や時刻基準が関係していることがあります。

MQL5開発者向けの実装確認ポイント

MQL5開発では、時系列取得、価格取得、銘柄仕様取得、時刻取得を分けて設計すると、不具合調査がしやすくなります。

実装時の注意点

• Copy系関数の戻り値を必ず確認する
• 取得件数が必要本数に満たない場合は判定しない
• 現在足と確定足を混同しない
• shift=0とshift=1の意味をログに残す
• iCloseの0値を取得失敗と有効値で混同しない
• SymbolInfo系でpoint、digits、volume step、StopsLevelを確認する
• TimeCurrent、TimeTradeServer、TimeLocalを混同しない
• マルチタイムフレームではbar time基準で照合する
• Strategy TesterとLIVEでspreadやtick条件が違う場合を考慮する
• ログにはsymbol、timeframe、shift、bar time、取得値、戻り値をセットで残す

時系列・価格取得関数の辞典表

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

時系列・価格取得まわりの不具合調査や改修依頼を行う場合は、次の情報を整理してください。

送ってはいけない情報：口座パスワード、投資家パスワード、Webhook URL、GAS URL、APIキー、認証トークン、口座番号の全桁、個人情報は、そのまま送らないでください。必要に応じて必ずマスクしてください。

関連するMQL5技術辞典

時系列・価格取得の確認では、関数全体、エラーコード、インジケーター連携、注文処理、ファイル操作、チャート表示、列挙型、標準ライブラリの理解も関係します。関連するMQL5技術辞典もあわせて確認してください。

確認ポイント：時系列・価格取得では、関数名だけで原因を断定せず、symbol、timeframe、shift、取得件数、bar time、TimeCurrent、SymbolInfo系の銘柄仕様、Expertsログ、Journalログをセットで確認してください。

関連する技術講座

FAQ

CopyRatesとiCloseはどちらを使えばよいですか？

目的によります。複数本のローソク足やOHLCをまとめて扱う場合はCopyRatesが便利です。指定shiftの終値だけを簡易的に確認する場合はiCloseでも対応できます。ただし、どちらの場合も取得件数、shift、現在足・確定足の扱いを確認してください。

CopyCloseが失敗する場合は何を確認しますか？

CopyCloseの戻り値、GetLastError、対象symbol、timeframe、必要本数、Bars、SeriesInfoInteger、Market Watch表示、履歴データの有無を確認してください。

iCloseが0を返した場合はサインなしですか？

断定できません。対象バーの価格が取得できていない可能性があります。GetLastError、Bars、対象shift、symbol、timeframeを確認してください。

現在足と確定足は何が違いますか？

現在足は形成中のバーで、価格が変化します。確定足はすでに閉じたバーです。EAの再現性を重視する場合は、shift=1の確定足を使うことが多くなります。

TimeCurrentとTimeTradeServerは何が違いますか？

TimeCurrentは最後に受信した気配値に基づくサーバー時刻として扱います。TimeTradeServerは取引サーバー時刻を確認するために使います。PCローカル時刻とは別に扱ってください。

SymbolInfoDoubleでは何を確認しますか？

Bid、Ask、Point、TickValue、最小ロット、ロット刻み、最大ロットなどを確認します。ロット計算、SL/TP計算、spread確認、銘柄仕様確認で重要です。

マルチタイムフレームで値がずれる場合は何を確認しますか？

CopyTimeやiTimeでbar timeを確認し、チャート時間足と取得時間足のバー位置を照合してください。shiftだけで判断すると、時間足の違いによりズレる場合があります。

Strategy Testerとリアルで価格取得が違うことはありますか？

あります。spread、tickデータ、ヒストリーデータ、テスター条件、外部通信条件が異なる場合があります。テスター条件、Expertsログ、Journalログ、対象期間、銘柄、時間足を整理してください。

開発依頼前に何を整理すればよいですか？

EA名、インジケーター名、バージョン、対象銘柄、時間足、setファイル、判定足、取得本数、時刻基準、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。

この記事にない項目はどのように確認すればよいですか？

まず公式リファレンス、MetaEditorのコンパイル結果、Expertsログ、Journalログ、実際のチャート表示を確認してください。価格取得が関係する場合は、symbol、timeframe、shift、取得件数、bar time、時刻basisを整理して確認します。

まとめ

MQL5の時系列・価格取得では、CopyRates、CopyOpen、CopyHigh、CopyLow、CopyClose、CopyTime、iOpen、iHigh、iLow、iClose、iTime、SymbolInfo系、TimeCurrent、TimeTradeServer、PeriodSecondsを目的別に使い分けることが重要です。

価格取得の不具合では、関数名だけで原因を断定せず、symbol、timeframe、shift、現在足・確定足、取得件数、bar time、履歴データ、SymbolInfo系の銘柄仕様をセットで確認してください。

EAの判定に使う場合は、現在足を使うのか、確定足を使うのかを明確にし、ログには取得値、取得件数、時刻、対象銘柄、対象時間足を残すと原因を追いやすくなります。

不具合調査や開発依頼を行う場合は、EA名、インジケーター名、バージョン、銘柄、時間足、setファイル、判定足、Expertsログ、Journalログ、スクリーンショット、再現手順を整理してください。