この記事を開いてくださったこと、心から感謝しています。足ごとの値を調べたいとき、iVolumeとiSpreadの違いや、どちらを使えばよいのかで迷っている人も多いはずです。
結論から言うと、iVolumeは指定した足のティックボリュームを返す関数、iSpreadは指定した足のスプレッドの値を返す関数です。公式の説明でも、iVolumeはティックボリューム、iSpreadはスプレッドの値を返す、と書かれています。
また、確認した公式ページに書かれていない点もありました。たとえば、iSpreadの値の単位や、範囲外の足を指定したときの動きです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、引数、戻り値、エラー時の扱い、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
iVolumeとiSpreadは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。形と引数は、まったく同じ作りです。
iVolumeは、足のティックボリュームを返す関数である
iVolumeの形は、long iVolume(const string symbol, ENUM_TIMEFRAMES timeframe, int shift) です。
公式には、指定した足のティックボリュームを返す、と書かれています。ティックボリュームとは、その足の間に値動きが何回あったかを数えた値のことです。
- 戻り値は、long型
- 指定した足のティックボリュームを返す
- エラーのときは、0が返る
ここで注意したいのは、ティックボリュームは、実際に取引された量そのものではない、という点です。実際の取引量にあたるリアルボリュームは、iRealVolumeという別の関数が用意されています。
iSpreadは、足のスプレッドの値を返す関数である
iSpreadの形は、long iSpread(const string symbol, ENUM_TIMEFRAMES timeframe, int shift) です。
公式には、指定した足のスプレッドの値を返す、と書かれています。スプレッドとは、買う値段と売る値段の差のことです。
- 戻り値は、long型
- 指定した足のスプレッドの値を返す
- エラーのときは、0が返る
ただし、公式ページには、スプレッドの値がどんな単位なのか、足の中のどの時点の値なのかは、書かれていません。そのため、単位は、自分の環境で確かめてから使う必要があります。
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | iVolume | iSpread |
|---|---|---|
| 役割 | 足のティックボリューム | 足のスプレッドの値 |
| 引数 | 銘柄、時間軸、足の位置の3つ | 銘柄、時間軸、足の位置の3つ |
| 戻り値 | long型 | long型 |
| エラーのとき | 0が返る | 0が返る |
| 値の単位 | 記載なし | 記載なし |
| エラーコード | GetLastErrorで確認 | GetLastErrorで確認 |
※公式の説明をもとにした、筆者の整理です。
引数と戻り値は、どう扱えばよいのか?
2つの関数は、引数と注意点が共通しています。公式の説明を、順に整理します。
銘柄、時間軸、足の位置の3つを渡す
1つ目のsymbolは、銘柄の名前です。公式には、NULLを渡すと、現在の銘柄を指す、と書かれています。2つ目のtimeframeは、時間軸で、0を渡すと、現在のチャートの時間軸を指します。
3つ目のshiftは、足の位置です。公式には、現在の足から、何本前かを表す、と書かれています。0なら現在の足で、1なら1本前の足になります。
- symbol:銘柄の名前、NULLで現在の銘柄
- timeframe:時間軸、0で現在のチャートの時間軸
- shift:現在の足から何本前か
足の本数や、足の位置の調べ方については、BarsとSeriesInfoIntegerの記事で整理しています。足の位置が範囲外だったときの動きは、確認した公式ページには、書かれていません。
エラーのときは、0が返る
公式には、エラーのときは0が返り、詳しい内容はGetLastErrorで調べられる、と書かれています。ここで気をつけたいのは、0が返ったときに、本当に値が0なのか、エラーなのか、戻り値だけでは区別できない点です。
- エラーのときは、0が返る
- 詳しい内容は、GetLastErrorで調べる
- 0が正常な値かどうかの見分け方は、記載なし
このため、0が返ってきたときは、GetLastErrorの値もあわせて確かめる流れにしておくと安心です。具体的なエラーコードの種類は、公式のこのページには書かれていません。
呼ぶたびに、最新のデータを取りに行く
公式には、この関数は常に実際のデータを返し、呼ぶたびに時系列データへ問い合わせる、と書かれています。結果は保存されないため、呼ぶたびに、最新の値が返ってきます。
最初の呼び出しで、データの準備ができていない場合は、準備に少し時間がかかることがある、とも書かれています。あらかじめ別の関数でデータを読み込んでおく必要があるかどうかは、記載がありません。
- 呼ぶたびに、時系列データへ問い合わせる
- 結果は、保存されない
- 最初の呼び出しは、時間がかかることがある
公式サンプルは、どう読めばよいのか?
公式ページには、それぞれサンプルが載っています。ここでは、サンプルが何をしているのか、そして気をつけたい点を整理します。
iVolumeのサンプルは、足の情報をチャートに表示している
iVolumeのサンプルは、エキスパートアドバイザーの形で書かれています。入力のshiftの初期値は0で、ティックのたびに、足の時刻、始値、高値、安値、終値、ボリューム、足の本数を、チャートに文字で表示します。
- shiftの初期値は、0
- ティックのたびに情報を更新する
- 時刻、四本値、ボリューム、足の本数を表示する
表示される内容の例は、公式ページには載っていません。実際にどう表示されるかは、自分の環境で確かめる必要があります。四本値を取り出す関数の使い分けは、CopyRatesとiCloseの記事でも整理しています。
iSpreadのサンプルは、iVolumeのサンプルと同じ内容になっている
確認した公式ページでは、iSpreadのサンプルは、iVolumeのサンプルとまったく同じでした。コードの中で呼ばれているのはiVolumeで、表示の文字もボリュームのままです。iSpreadそのものは、呼ばれていません。
- iSpreadのサンプルは、iVolumeのサンプルと同じ
- コードの中では、iVolumeが呼ばれている
- iSpreadの使い方は、サンプルからは分からない
このため、iSpreadの使い方は、公式のサンプルからは読み取れません。形と引数が、iVolumeと同じであることから、同じ要領で呼べると考えられますが、これは筆者の推測です。使う前に、自分の環境で動きを確かめておくと安心です。
サンプルから分かることと、分からないこと
サンプルから読み取れるのは、足の位置を指定して、値を取り出す基本の流れです。一方で、iSpreadの値の単位や、範囲外の足を指定したときの動きは、サンプルからは読み取れません。
- 分かる:銘柄、時間軸、足の位置を渡す流れ
- 分からない:iSpreadの値の単位
- 分からない:範囲外の足を指定したときの動き
どう使い分ければよいのか?
取引の活発さの目安がほしいならiVolume、スプレッドの広さを見たいならiSpreadです。2つは別の情報なので、必要に応じて、あわせて使うこともできます。
値動きの回数を見たいなら、iVolumeを選ぶ
足ごとの値動きの多さを見たいときは、iVolumeを使います。ただし、ティックボリュームは、実際の取引量そのものではないため、取引量として扱ってよいかどうかは、慎重に考える必要があります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
スプレッドの広さを見たいなら、iSpreadを選ぶ
足ごとのスプレッドの広さを見たいときは、iSpreadを使います。ただし、値の単位が公式に書かれていないため、まずは数値を表示して、自分の環境の値の大きさを確かめておくのが安心です。
- 足ごとのスプレッドの広さを見たい
- 3つの引数を渡す
- 値の単位は、先に確かめる
まとめて取りたいなら、別の関数も選べる
公式の関連項目には、まとめて配列に取り出す関数として、CopyTickVolumeやCopySpreadが挙げられています。たくさんの足を一度に調べたいときは、そちらのほうが向いている可能性があります。
- 1本ずつ調べるなら、iVolumeとiSpread
- まとめて取るなら、CopyTickVolumeやCopySpread
- 使い分けは、足の本数で考える
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、現在の足と1本前の足を使って確かめるのが安心です。
まずは、現在の足と1本前の足で、値を表示する
最初は、銘柄にNULL、時間軸に0を渡して、shiftを0と1にした場合のiVolumeの値を表示します。値が、足ごとに違うことを、自分の目で確かめます。
- NULLと0を渡す
- shiftを、0と1にする
- 値を表示して見比べる
次に、iSpreadの値の大きさを確かめる
次に、同じ要領でiSpreadの値を表示します。値の単位は書かれていないため、実際にチャートで見えているスプレッドと、見比べて確かめておくと安心です。
- 同じ要領で、iSpreadを呼ぶ
- 値を表示する
- チャートのスプレッドと見比べる
最後に、0が返ったときの確認方法を決めておく
最後に、0が返ったときの確認方法を決めておきます。GetLastErrorの値もあわせて表示すれば、エラーなのか、正常な値の0なのかを、見分ける手がかりになります。









- まず、現在の足と1本前の足で値を表示する
- 次に、iSpreadの値の大きさを確かめる
- 最後に、0が返ったときの確認方法を決める
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
iVolumeの値は、実際の取引量なのか?
公式には、ティックボリュームを返す、と書かれています。実際の取引量にあたるリアルボリュームは、iRealVolumeという別の関数です。ただし、リアルボリュームの定義や、使える銘柄については、公式のページには書かれていません。
- iVolumeは、ティックボリューム
- リアルボリュームは、iRealVolumeが別にある
- リアルボリュームの定義は、記載なし
iSpreadの値は、何の単位なのか?
確認した公式ページには、書かれていません。記載なしなので、自分の環境で、実際の値を表示して確かめるのが安心です。
- 公式には、記載なし
- 実際の値を表示して確かめる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のiVolumeとiSpread、足ごとの取引の活発さを見るティックボリュームの手軽さと足ごとのスプレッドの広さを見る安心感どっちを使う?」
値動きの回数を見るならiVolume、スプレッドの広さを見るならiSpreadです。値の単位や範囲外の扱いなど、記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










