この記事を開いてくださったこと、心から感謝しています。MQL5でEAやインジケーターを書いていて、過去の価格を取り出すときに、iCloseのような関数を使うか、CopyRatesでまとめて取るか、迷った人も多いはずです。
結論から言うと、1本だけ手軽に取りたいならiClose、たくさんの足をまとめて扱いたいならCopyRatesが向いています。どちらも、失敗したときの扱いを決めておく点は共通です。
この記事では、MQL5公式ドキュメントの説明をもとに、取り出せるものの違い・失敗したときの返り値・呼び出し回数・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
CopyRatesとiCloseは、そもそも何なのか?
まずは、2つの書き方がそれぞれ何を取り出すものなのかを整理します。
iCloseは、指定した足の終値を1つ返す
MQL5の公式ドキュメントによると、iCloseは、指定したチャートの足の終値を返す関数です。銘柄、時間足、そして何本前の足かを表すシフトを渡します。銘柄にNULL、時間足に0を渡すと、現在のチャートの設定になります。
- 銘柄と時間足とシフトを渡す
- NULLと0で現在のチャートになる
CopyRatesは、足の情報をまとめて配列に入れる
公式ドキュメントでは、CopyRatesは、銘柄と時間足の過去のデータを、MqlRatesという構造体の配列にコピーする関数と説明されています。確認したページの例では、時間、始値、高値、安値、終値、ティックの出来高が、読み取られています。
CopyRatesには、3つの呼び出し方がある
公式ドキュメントによると、CopyRatesには、開始位置と本数で指定する形、開始時刻と本数で指定する形、開始時刻と終了時刻で指定する形の、3つがあります。使う場面に合わせて、選べます。
- 開始位置と本数で指定する
- 開始時刻と終了時刻で指定する
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
取り出せるものには、どんな違いがあるのか?
ここでは、2つの書き方で取り出せるものと、並び順の違いを確認します。
iCloseは、終値だけを取り出す
iCloseが返すのは、終値1つです。始値や高値も欲しい場合は、別の関数を、さらに呼ぶことになります。1本の終値だけで足りる処理には、短く書けて向いています。
- 返すのは終値1つ
- 1本だけ欲しいときは短く書ける
CopyRatesは、1本の足の複数の値を、一度に取る
CopyRatesを使うと、1本の足の、時間・始値・高値・安値・終値が、構造体にまとまって入ります。複数の足を取れば、その分が、配列に並びます。高値や安値も使う処理で、役立ちます。
配列の並び順には、注意が必要
公式ドキュメントによると、CopyRatesでは、配列の設定にかかわらず、一番古い要素が、メモリの先頭に置かれます。確認したページの例では、ArraySetAsSeriesで、配列を時系列の向きに設定してから、コピーしています。
- 一番古い要素がメモリの先頭に置かれる
- 例ではArraySetAsSeriesを設定している
取り出せるものを、表で比べる
公式ドキュメントの説明をもとに、2つの違いを表にまとめます。選ぶときの目安として使ってください。
| 項目 | iClose | CopyRates |
|---|---|---|
| 取り出せるもの | 終値1つ | 足の情報を配列にまとめて |
| 渡すもの | 銘柄、時間足、シフト | 銘柄、時間足、範囲、配列 |
| 失敗したとき | 0を返す | -1を返す |
※公式ドキュメントの説明をもとにした整理です。
失敗したときは、どう扱われるのか?
値が取れなかったときの返り値と、データがまだ用意できていない場合の動きを確認します。
iCloseは、失敗すると0を返す
公式ドキュメントによると、iCloseは、エラーのときに0を返します。詳しい原因は、GetLastErrorで確かめます。0は、価格として、本当に起こりにくい値ですが、確認の処理は書いておきましょう。
- エラーのときは0が返る
- 原因はGetLastErrorで確かめる
CopyRatesは、失敗すると-1を返す
公式ドキュメントでは、CopyRatesは、コピーできた要素の数を返し、エラーのときは-1を返すと説明されています。依頼した期間が、サーバーのデータの範囲の外にあるときなどに、-1になります。
データが用意できていないときの動きが違う
公式ドキュメントによると、CopyRatesを、インジケーターから呼ぶと、データがまだ用意できていない場合に、すぐ-1を返して、ダウンロードや構築を始めます。EAやスクリプトでは、タイムアウトまで待って、用意できた分を返します。
- インジケーターではすぐ-1を返す
- EAやスクリプトでは用意できた分を返す
iCloseは、呼ぶたびに時系列へ問い合わせる
公式ドキュメントでは、iCloseは、常に実際のデータを返し、呼ぶたびに時系列へ問い合わせると説明されています。結果は保存されず、繰り返し呼んでも、キャッシュはありません。最初の呼び出しで、データが未準備なら、時間がかかる場合があります。
呼び出しの回数は、どれくらい違うのか?
仮の数字で、直近100本の終値を取り出すときの、呼び出し回数を比べます。
例の前提を、そろえる
EAが、ティックのたびに、直近100本の終値を取り出すと仮定します。1時間に3,600回のティックが来るとします。iCloseは、1本ごとに1回、CopyRatesは、100本を1回で取ると考えます。
- 1回の処理で100本の終値が必要と仮定する
- 1時間に3,600回のティックが来ると仮定する
※筆者が設定した仮の数字にもとづく、計算例です。実際のティックの数や、必要な本数は、条件で大きく変わります。
iCloseは36万回、CopyRatesは3,600回になる
iCloseは、100回×3,600回で、1時間に36万回の呼び出しです。CopyRatesは、1回×3,600回で、3,600回です。呼び出しの回数は、100分の1になります。
| 書き方 | 1回の処理の呼び出し(例) | 1時間の呼び出し(例) |
|---|---|---|
| iClose | 100回 | 360,000回 |
| CopyRates | 1回 | 3,600回 |
※仮の数字にもとづく、筆者の計算例です。呼び出しの回数であり、実際の処理時間を示すものではありません。
回数が多いほど、問い合わせの負担は増えやすい
iCloseは、呼ぶたびに時系列へ問い合わせるため、本数が多いほど、問い合わせの回数が増えます。たくさんの足を繰り返し使うなら、まとめて取るCopyRatesの考え方が、使いやすくなります。
- 本数が多いほど問い合わせが増える
- まとめて取る考え方が使いやすい
1本だけなら、iCloseの手軽さが活きる
一方で、直前の足の終値を1つだけ見るような処理なら、iCloseを1行書くだけで済みます。配列を用意したり、返り値の数を確かめたりする手間が、ありません。
CopyRatesを使うときは、何に気をつけるのか?
CopyRatesならではの注意点を、公式ドキュメントの説明から整理します。
現在の足を取りたいときの指定
公式ドキュメントによると、まだ確定していない現在の足を取るには、開始位置を0、本数を1にした形を使います。確定した足だけを使いたいときは、開始位置を、1以上にして、現在の足を避けます。
- 現在の足は開始位置0、本数1で取る
- 確定した足だけなら開始位置を1以上にする
時刻で範囲を決めると、0が返る場合がある
公式ドキュメントでは、週足は日曜日に始まるため、週足の開始時刻を含まない範囲を指定すると、0が返ると説明されています。この場合は、エラーの-1ではなく、0になる点に、注意しましょう。
- 週足の開始時刻を含まないと0が返る
- -1とは別の扱いになる
取得できる本数にも、上限がある
公式ドキュメントによると、依頼がTERMINAL_MAXBARSを超えると、-1が返ります。大量の足を一度に取りたいときは、この上限を、先に確かめておきましょう。
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、どちらを選ぶとよいかの目安を整理します。
1本の終値を見るだけなら、iClose
直前の足の終値と、今の価格を比べるといった、1本だけを見る処理には、iCloseが向いています。短く書けて、読み返しやすいのも利点です。

- 1本だけを見る処理に向く
- 短く書ける
たくさんの足を使うなら、CopyRates
移動平均を自分で計算する、直近の高値と安値を探すなど、たくさんの足を使う処理は、CopyRatesが向いています。構造体で、足の値が、まとまって手に入ります。


- たくさんの足を使う処理に向く
- 高値や安値もまとめて使える
呼ぶタイミングも、合わせて考える
価格が動くたびに呼ぶのか、一定の間隔で呼ぶのかでも、負担は変わります。呼ばれるタイミングの違いは、MQL5のOnTickとOnTimerを比べた記事で整理しています。
- ティックごとに呼ぶと回数が増える
- 間隔を決めて呼ぶ方法もある
運用で気をつけたいことは、何か?
どちらの書き方でも、共通して意識したい点をまとめます。
失敗したときの処理を、必ず書く
iCloseの0も、CopyRatesの-1も、データが取れなかったことを示す合図です。そのまま計算に使うと、思わぬ結果になるため、確かめてから使いましょう。チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- 返り値を確かめてから使う
- 取れなかったときの処理を書く
デモ口座で、動きを確かめる
書いたコードは、まずデモ口座で動かして、データが想定どおりに取れているかを、ログで確かめましょう。取れた本数や、返り値を出しておくと、原因を探しやすくなります。
- デモ口座で先に動かす
- 取れた本数をログに出す
小さなEAで、両方を試す
最初は、同じ終値を、iCloseとCopyRatesの両方で取って、ログに出す小さなEAを作ってみましょう。値が同じかどうかを見比べると、書き方の違いが、体で分かります。



- 同じ値を2通りで取る
- ログで見比べる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
CopyRatesで取った配列は、どの向きに並ぶのか?
確認した公式ドキュメントでは、配列の設定にかかわらず、一番古い要素がメモリの先頭に置かれると説明されています。確認したページの例では、ArraySetAsSeriesを呼んでからコピーしていますが、この関数の説明は、そのページにありません。使う前に、関数の説明で確かめましょう。
iCloseは、CopyRatesより遅いのか?
確認した公式ドキュメントのページには、2つの処理時間を比べた説明は、ありませんでした。この記事の計算も、呼び出しの回数の違いであり、速さを比べたものではありません。実際の速さは、自分の環境で確かめましょう。
- このページに速度の比較はない
- 自分の環境で確かめる
まとめ:「MQL5のCopyRatesとiClose、足の情報をまとめて取れる便利さと終値を1行で取れる手軽さどっちを選ぶ?」
1本の終値だけならiClose、たくさんの足の情報をまとめて使うならCopyRatesが向いています。どちらも、失敗したときの返り値を確かめてから使うと安心です。
価格データの取り方が分かると、EAを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










