MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のCopyRatesとiClose、足の情報をまとめて取れる便利さと終値を1行で取れる手軽さどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のCopyRatesとiClose、足の情報をまとめて取れる便利さと終値を1行で取れる手軽さどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
MQL5のCopyRatesとiCloseの比較

この記事を開いてくださったこと、心から感謝しています。MQL5でEAやインジケーターを書いていて、過去の価格を取り出すときに、iCloseのような関数を使うか、CopyRatesでまとめて取るか、迷った人も多いはずです。

結論から言うと、1本だけ手軽に取りたいならiClose、たくさんの足をまとめて扱いたいならCopyRatesが向いています。どちらも、失敗したときの扱いを決めておく点は共通です。

この記事では、MQL5公式ドキュメントの説明をもとに、取り出せるものの違い・失敗したときの返り値・呼び出し回数・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。

MQL5のCopyRatesとiCloseの違いをまとめたインフォグラフィック
目次

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になります。

  • コピーできた数を返す
  • エラーのときは-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行書くだけで済みます。配列を用意したり、返り値の数を確かめたりする手間が、ありません。

  • 1行で書ける
  • 配列を用意しなくてよい

CopyRatesを使うときは、何に気をつけるのか?

CopyRatesならではの注意点を、公式ドキュメントの説明から整理します。

現在の足を取りたいときの指定

公式ドキュメントによると、まだ確定していない現在の足を取るには、開始位置を0、本数を1にした形を使います。確定した足だけを使いたいときは、開始位置を、1以上にして、現在の足を避けます。

  • 現在の足は開始位置0、本数1で取る
  • 確定した足だけなら開始位置を1以上にする

時刻で範囲を決めると、0が返る場合がある

公式ドキュメントでは、週足は日曜日に始まるため、週足の開始時刻を含まない範囲を指定すると、0が返ると説明されています。この場合は、エラーの-1ではなく、0になる点に、注意しましょう。

  • 週足の開始時刻を含まないと0が返る
  • -1とは別の扱いになる

取得できる本数にも、上限がある

公式ドキュメントによると、依頼がTERMINAL_MAXBARSを超えると、-1が返ります。大量の足を一度に取りたいときは、この上限を、先に確かめておきましょう。

  • TERMINAL_MAXBARSを超えると-1になる
  • 大量に取る前に上限を確かめる

実際に、どう使い分ければいいのか?

ここでは、場面ごとに、どちらを選ぶとよいかの目安を整理します。

1本の終値を見るだけなら、iClose

直前の足の終値と、今の価格を比べるといった、1本だけを見る処理には、iCloseが向いています。短く書けて、読み返しやすいのも利点です。

終値を1つ見るだけの処理は、iCloseで1行にしたら、あとから読んでもすぐ意味が分かりました。短さは大切ですね。
  • 1本だけを見る処理に向く
  • 短く書ける

たくさんの足を使うなら、CopyRates

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

Kenichi
Kenichi
100本ぶんをまとめて配列に入れてから計算したら、コードがすっきりして、考えやすくなりました。
  • たくさんの足を使う処理に向く
  • 高値や安値もまとめて使える

呼ぶタイミングも、合わせて考える

価格が動くたびに呼ぶのか、一定の間隔で呼ぶのかでも、負担は変わります。呼ばれるタイミングの違いは、MQL5のOnTickとOnTimerを比べた記事で整理しています。

  • ティックごとに呼ぶと回数が増える
  • 間隔を決めて呼ぶ方法もある

運用で気をつけたいことは、何か?

どちらの書き方でも、共通して意識したい点をまとめます。

失敗したときの処理を、必ず書く

iCloseの0も、CopyRatesの-1も、データが取れなかったことを示す合図です。そのまま計算に使うと、思わぬ結果になるため、確かめてから使いましょう。チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。

返り値を確かめる処理を入れたら、データが取れなかったときの原因が、すぐ分かるようになりました。確認は大切ですね。
  • 返り値を確かめてから使う
  • 取れなかったときの処理を書く

デモ口座で、動きを確かめる

書いたコードは、まずデモ口座で動かして、データが想定どおりに取れているかを、ログで確かめましょう。取れた本数や、返り値を出しておくと、原因を探しやすくなります。

  • デモ口座で先に動かす
  • 取れた本数をログに出す

小さなEAで、両方を試す

最初は、同じ終値を、iCloseとCopyRatesの両方で取って、ログに出す小さなEAを作ってみましょう。値が同じかどうかを見比べると、書き方の違いが、体で分かります。

同じ値を2通りで取って見比べたら、使い方の違いがよく分かりました。自分に合う書き方を選べて安心しました。
  • 同じ値を2通りで取る
  • ログで見比べる

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

CopyRatesで取った配列は、どの向きに並ぶのか?

確認した公式ドキュメントでは、配列の設定にかかわらず、一番古い要素がメモリの先頭に置かれると説明されています。確認したページの例では、ArraySetAsSeriesを呼んでからコピーしていますが、この関数の説明は、そのページにありません。使う前に、関数の説明で確かめましょう。

  • メモリ上は古い要素が先頭
  • 配列の向きは関数の説明で確かめる

iCloseは、CopyRatesより遅いのか?

確認した公式ドキュメントのページには、2つの処理時間を比べた説明は、ありませんでした。この記事の計算も、呼び出しの回数の違いであり、速さを比べたものではありません。実際の速さは、自分の環境で確かめましょう。

  • このページに速度の比較はない
  • 自分の環境で確かめる

まとめ:「MQL5のCopyRatesとiClose、足の情報をまとめて取れる便利さと終値を1行で取れる手軽さどっちを選ぶ?」

1本の終値だけならiClose、たくさんの足の情報をまとめて使うならCopyRatesが向いています。どちらも、失敗したときの返り値を確かめてから使うと安心です。

  • 手軽さはiClose
  • まとめて扱うならCopyRates
  • 返り値の確認はどちらでも必要

価格データの取り方が分かると、EAを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(CopyRates)
  • MQL5 リファレンス(iClose)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のCTradeとOrderSend、短く読みやすく書ける手軽さと注文の中身を自分で決められる自由度どっちを選ぶ?
  • Pine Scriptのstrategy.closeとstrategy.close_all、建玉を選んで閉じられる細かさと全部をまとめて閉じられる手軽さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次