この記事を開いてくださったこと、心から感謝しています。ティックのデータを、プログラムで取り出す方法を知りたいと考えている人も、きっと多いはずです。
結論から言うと、開始時刻と件数を指定して取りたいときはCopyTicks、期間を区切ってその中だけを取りたいときはCopyTicksRangeです。範囲の決め方が違う関数です。
また、テスターでの動きや、時刻のタイムゾーンなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の引数、戻り値、動き方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
CopyTicksとCopyTicksRangeは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらもティックを配列に取り出しますが、範囲の指定方法が違います。
CopyTicksは、開始時刻と件数で取る
CopyTicksは、銘柄の名前、受け取る配列、ティックの種類、開始時刻、件数を渡して、ティックを取り出す関数です。開始時刻はミリ秒で、1970年1月1日からの経過です。
公式の説明では、開始時刻を0にすると、直近の件数ぶんのティックが返ります。開始時刻も件数も指定しないと、取れる最近のティックが入りますが、2000件までです。
- 開始時刻と件数で、範囲を決める
- 開始時刻が0なら、直近の件数
- 指定がないときは、2000件まで
CopyTicksRangeは、開始と終了の時刻で取る
CopyTicksRangeは、銘柄の名前、配列、ティックの種類、開始時刻、終了時刻を渡して、その期間のティックを取り出す関数です。時刻は、どちらもミリ秒です。
公式の説明では、開始時刻以上、終了時刻以下のティックが返ります。時刻を指定しないと、履歴の最初から、または最後までが対象になります。
- 開始と終了の時刻で、範囲を決める
- 開始時刻以上、終了時刻以下
- 省略すると、履歴の端までが対象
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | CopyTicks | CopyTicksRange |
|---|---|---|
| 範囲の決め方 | 開始時刻と件数 | 開始と終了の時刻 |
| 戻り値 | 取れた件数、失敗は-1 | 取れた件数、失敗は-1 |
| 配列が足りないとき | 記載なし | 最大限を入れて、エラーを設定 |
| 向いている場面 | 月初から今までなど | 1日分など、期間の中だけ |
| テスターでの動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
CopyTicksは、どんな場面で使うのか?
CopyTicksは、直近のティックを取りたいときや、ある時刻から今までを取りたいときに使います。公式の説明から、動き方を確認します。
ティックの種類を、3つから選べる
ティックの種類は、3つあります。買値と売値が変わったもの、最後の約定の価格と数量が変わったもの、すべてのものです。どの種類でも、残りの項目には直前の値が入ります。
| 種類 | 取れるティック |
|---|---|
| 情報用 | 買値や売値が変わったティック |
| 取引用 | 約定の価格や数量が変わったティック |
| すべて | すべてのティック |
※公式の説明をもとにした、筆者の整理です。
最初の呼び出しで、同期が始まる
公式の説明では、最初の呼び出しで、銘柄のティックの保存場所との同期が始まります。足りないティックは、取引サーバーから取り込まれます。
EAとスクリプトでは、同期を最大45秒まで待てます。時間切れになると、取れたぶんだけが返り、同期は続きます。インジケーターでは、待たずに、取れたぶんだけを返します。
- 最初の呼び出しで、同期が始まる
- EAとスクリプトは、最大45秒待てる
- インジケーターは、待たない
速さは、どこから読むかで変わる
公式の説明では、直近の4096件は、速いキャッシュに入っています。板情報を使っているときは、65536件です。それより古いものは、端末のメモリから、さらに古い日のものは、ディスクから読みます。
ティックの種類を絞っても、ほとんど速くならない、とも書かれています。すべてを取る場合は、すぐに返るためです。ティックの受け取りの仕組みは、OnTickとOnTimerの記事で整理しています。
- 直近の4096件は、速い
- 古いほど、読むのが遅い
- 種類を絞っても、速さは変わりにくい
CopyTicksRangeは、どんな場面で使うのか?
CopyTicksRangeは、ある期間のティックだけを、きっちり取りたいときに使います。公式の説明から、条件を確認します。
1日分など、期間の中だけを取れる
公式の説明では、CopyTicksRangeは、たとえば過去の1日分のように、決まった期間の中のティックを取るための関数です。CopyTicksは、開始時刻だけを指定する形なので、月初から今まで、という使い方に向いています。
- 決まった期間の中だけを取れる
- 1日分などの取り出しに向く
- 開始だけなら、CopyTicksが向く
エラーは、3種類が説明されている
失敗したときの戻り値は、-1です。公式には、エラーの種類も載っています。同期の待ち時間が過ぎたとき、固定長の配列が小さいとき、メモリが足りないときの3つです。
| 状況 | 起きること |
|---|---|
| 同期の待ち時間が過ぎた | 取れたぶんだけを返す |
| 固定長の配列が小さい | 入るぶんだけを返し、エラーを設定 |
| メモリが足りない | 動的配列に読み込めない |
※公式の説明をもとにした、筆者の整理です。
CopyTicksのエラーは、記載がない
CopyTicksのページには、具体的なエラーの種類は書かれていません。失敗の合図は、-1の戻り値です。公式サンプルは、成功後にエラーの番号が0なら、同期が済んだ合図として扱っています。
- エラーの種類は、記載なし
- 失敗の合図は、-1
- サンプルは、0を同期済みの合図とする
取り出したティックは、どう読むのか?
どちらの関数でも、ティックはMqlTickという構造体の配列に入ります。構造体の中身を知っておくと、読み取りが楽になります。
どのティックにも、すべての項目が入っている
構造体には、時刻、買値、売値、最後の約定の価格、数量、ミリ秒の時刻、フラグ、より細かい数量が入っています。公式の説明では、変わっていない項目にも、値が入ります。
そのため、過去のある時点の価格を、前のティックにさかのぼらずに読み取れます。配列は古い順で、先頭の番号0が最も古いティックです。
- 変わっていない項目にも、値が入る
- 配列は、古い順
- 番号0が、最も古い
フラグで、何が変わったかを見分ける
フラグには、買値、売値、最後の価格、数量が変わったことを示すものと、買いの約定、売りの約定を示すものがあります。公式サンプルも、フラグで買いか売りかを見分けています。
- 買値や売値の変化を見分けられる
- 約定の変化も見分けられる
- 買いか売りかも見分けられる
1銘柄の最新の値だけなら、別の関数もある
最新の1件だけを知りたいなら、ティックの取り出しではなく、別の関数が向いています。詳しくは、SymbolInfoTickとSymbolInfoDoubleの記事が参考になります。
ティックを集めて加工する場合と、最新の1件を読むだけの場合では、選ぶ関数が変わります。まずは、自分が必要なのが、最新の値なのか、ある期間の記録なのかを、決めておきましょう。
- 最新の1件なら、別の関数が向く
- 期間の記録なら、2つの関数が向く
- 先に、必要なものを決めておく
どう使い分ければよいのか?
2つは、範囲の決め方が違う関数です。直近や開始時刻から取るのか、期間の中だけを取るのかで、使い分けます。
直近や開始時刻から取りたいなら、CopyTicksを選ぶ
直近の数百件を見たいときや、ある時刻から今までを取りたいときは、CopyTicksが向いています。呼び出しの形も、シンプルです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
期間の中だけを取りたいなら、CopyTicksRangeを選ぶ
過去の1日分など、決まった期間のティックだけを取りたいときは、CopyTicksRangeが向いています。開始と終了の両方を、指定できるためです。
- 1日分など、期間を区切りたい
- 終了時刻も指定したい
- エラーの種類を、確かめたい
どちらも、テスターでの動きは記載がない
公式のページには、ストラテジーテスターでの動きは、書かれていません。時刻のタイムゾーンや、取れる履歴の長さも、記載なしです。
- テスターでの動きは、記載なし
- タイムゾーンも、記載なし
- 履歴の長さも、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使うときの、確認の順番を整理します。小さな件数から、順に確かめるのが安心です。
まずは、少ない件数で試す
最初は、スクリプトで、直近の10件ほどを取って、ログに表示します。戻り値の件数と、先頭と末尾の時刻を、確かめます。
- 直近の10件ほどで、試す
- 戻り値の件数を、確かめる
- 先頭と末尾の時刻を、見る
次に、期間を指定して試す
次に、CopyTicksRangeで、短い期間を指定して取ります。配列の形や、戻り値が-1のときの処理も、ここで試しておきます。
- 短い期間で、試す
- 動的配列で、受け取る
- -1のときの処理を、入れる
最後に、同期の待ちとエラーを確かめる
初めて取る銘柄では、同期に時間がかかる場合があります。公式サンプルのように、うまくいかなければ少し待って、やり直す作り方も考えられます。









もう1つのコツは、取り出す件数を、必要な分だけに絞ることです。多く取るほど、メモリを使い、時間もかかりやすくなります。
- 必要な件数だけを取る
- 戻り値の件数を、必ず確かめる
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
CopyTicksは、何件まで取れるのか?
公式の説明には、開始時刻も件数も指定しないと、2000件までと書かれています。件数を指定したときの上限は、記載なしでした。
- 指定なしは、2000件まで
- 指定したときの上限は、記載なし
取れたティックは、古い順なのか?
はい、公式の説明では、古い順に並び、番号0が最も古いティックです。新しいものほど、後ろに入ります。
- 古い順に並ぶ
- 番号0が、最も古い
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?」
開始時刻と件数で取るならCopyTicks、期間を区切って取るならCopyTicksRangeです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










