この記事を開いてくださったこと、心から感謝しています。Pine Scriptで日足の高値を1時間足のチャートに表示しようとして、request.securityにlookahead_onを付けたら、過去の結果がやけに良くなって驚いた人も多いはずです。
結論から言うと、検証や売買の判断に使うなら、初期設定のlookahead_offか、1本ずらしたうえでlookahead_onを使う形が向いています。ずらさないlookahead_onは、未来の値が混ざる原因になります。
この記事では、2つの設定の違い・未来の値が混ざる仕組み・安全な書き方を整理し、自分に合う選び方まで踏み込んでまとめます。
lookaheadとは、何を決める設定なのか?
まずは、設定の役割と、2つの値の基本的な違いを整理します。
上位足のデータを呼ぶときの、時間の扱いを決める
TradingViewの公式ドキュメントによると、lookaheadは、request.securityなどで別の時間足のデータを呼ぶときの、先読みの動きを決めるパラメータです。上位足のデータを呼ぶとき、チャートの足より先の時刻の値を返してよいかどうかを、この設定が決めます。
- 別の時間足のデータを呼ぶときの設定
- 先の時刻の値を返すかどうかを決める
初期設定は、lookahead_off
公式ドキュメントでは、初期値はbarmerge.lookahead_offだと説明されています。何も指定しなければ、この動きになります。過去の足では、上位足の期間が終わったときに、新しい値に切り替わります。
lookahead_onは、期間の始まりから新しい値を返す
lookahead_onを指定すると、上位足の期間の始まりの時点から、新しい値が返されます。つまり、まだ確定していない上位足の値が、過去の足に反映されることになります。
- 期間の始まりから新しい値が返る
- 確定前の値が過去の足に反映される
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
未来の値が混ざると、何が問題なのか?
公式ドキュメントの説明をもとに、混ざる仕組みと影響を確認します。
過去の足で、まだ知り得ない高値が見えてしまう
公式ドキュメントの例では、上位足の高値をlookahead_onで、ずらさずに呼ぶと、その高値が実際に分かるより前の過去の足に、最終的な高値が表示されると説明されています。その日の朝の足で、まだ誰も知らない一日の最高値が、すでに見えている状態です。
- 最終的な高値が先に見えてしまう
- 当時は知り得なかった情報が混ざる
検証の結果が、実際よりも良く見える
未来の値が混ざったストラテジーは、「まだ分からないはずの高値で売買する」検証になります。そのため、バックテストの結果が、実際の取引よりも、はるかに良く見えてしまいます。
公式ドキュメントも、強く注意している
公式ドキュメントでは、先読みで未来のデータを過去に混ぜるスクリプトは、非常に誤解を招くものであり、公開が認められないと説明されています。便利な機能の裏側に、きびしい注意があることを、知っておきましょう。
- 誤解を招くスクリプトとされている
- 公開が認められない場合がある
どれくらいの足に、未来の値が混ざるのか?
1時間足のチャートで日足の高値を呼ぶ例で、影響の大きさを計算します。
1時間足で日足を呼ぶと、ほとんどの足が影響を受ける
平日24時間取引の銘柄を仮定すると、日足1本の中に、1時間足は24本あります。lookahead_onを、ずらさずに使うと、その日の最終的な高値が、24本すべての足に表示されます。確定するのは、最後の足の終わりなので、最大で23本の足には、まだ知り得ない値が混ざる計算です。
| チャートの足 | 日足1本あたりの本数 | 未来の値が混ざる足(最大) |
|---|---|---|
| 1時間足 | 24本 | 23本(約96%) |
| 4時間足 | 6本 | 5本(約83%) |
| 15分足 | 96本 | 95本(約99%) |
※平日24時間取引を仮定した、筆者の計算例です。実際は、高値が確定する時刻によって変わります。
足が細かいほど、影響は大きくなる
チャートの足が細かいほど、上位足の1本の中に足が多く入るため、未来の値が混ざる割合は高くなります。15分足では、ほぼすべての足が影響を受ける計算です。細かい足で上位足を使うときほど、注意が必要です。
- 足が細かいほど割合が高くなる
- 15分足ではほぼすべてが影響を受ける
5日間で数えると、影響の広がりが分かる
1時間足で5日間(120本)を見ると、未来の値が混ざる足は、最大で23本×5日=115本です。約96%の足で、当時は分からなかった高値を使って判断してしまう計算になります。
安全に使うには、どう書けばいいのか?
公式ドキュメントが示している、未来の値を混ぜない書き方を確認します。
lookahead_offのまま使う
いちばん簡単なのは、初期設定のlookahead_offのまま使うことです。過去の足では、上位足が確定してから、新しい値に切り替わるため、未来の値は混ざりません。迷ったら、まずこの形で書きましょう。
- 何も指定しなければlookahead_off
- 過去の足で未来の値が混ざらない
1本ずらして、lookahead_onを使う
公式ドキュメントでは、式を1本ずらして(たとえば高値の[1])、lookahead_onと組み合わせる方法が、再描画を避ける唯一のおすすめの方法だと説明されています。この形なら、上位足の確定した最後の値を、いつも使えます。

3つの書き方を、表で比べる
3つの書き方の違いを、公式ドキュメントの説明から整理します。
| 書き方 | 過去の足での動き | 未来の値 |
|---|---|---|
| lookahead_off | 期間の終わりで値が切り替わる | 混ざらない |
| lookahead_on(ずらさない) | 期間の始まりから最終値を返す | 混ざる |
| lookahead_on(1本ずらす) | 確定した最後の値を返す | 混ざらない |
※公式ドキュメントの説明をもとにした整理です。
リアルタイムの足では、どうなるのか?
過去の足とは、動きが異なる点にも注意が必要です。
リアルタイムでは、確定前の値が返る
公式ドキュメントによると、リアルタイムの足では、lookahead_offの場合でも、確定していない現在の値が返されます。過去の足では確定してから切り替わるのに、リアルタイムでは、確定前の値が使われる点が違います。
- リアルタイムは確定前の値が返る
- 過去の足とは動きが異なる
ずらさないlookahead_onは、見た目が変わる
ずらさないlookahead_onは、リアルタイムでは、確定前の上位足の高値を表示します。過去の足では最終的な高値が出ていたのに、リアルタイムでは途中の値になるため、見た目が食い違います。
確定した値だけを使う書き方が、安心につながる
確定した最後の値だけを使うと、過去の足でもリアルタイムでも、同じ値になりやすくなります。再描画を避けたいときは、この考え方が基本になります。varipの再描画は、Pine Scriptのvarとvaripを比べた記事でも整理しています。
- 確定した値だけを使う
- 過去とリアルタイムで同じ値になりやすい
gapsの設定は、どう関わるのか?
lookaheadと合わせて使われる、もう1つの設定も確認します。
gaps_offは、直前の確定値で埋める
公式ドキュメントによると、gapsは、データが存在しない足への対応を決める設定です。初期値のgaps_offは、過去の足では、直前に確定した値で、すき間を埋めます。
- 初期値はgaps_off
- 確定した値で埋める
gaps_onは、確定前をnaにする
gaps_onを指定すると、新しいデータがまだ確定していない足では、naが返されます。値のない足を、はっきり区別したいときに使えます。
目的に合わせて、選べばよい
値のない足を、直前の確定値で埋めて見たいのか、はっきり区別したいのかで、選び方が変わります。迷ったら、まずは初期設定のgaps_offで試すのが、無理のない進め方です。
- 埋めるか区別するかで選ぶ
- 迷ったら初期設定で試す
どう使い分け、確認すればいいのか?
実際に書くときの選び方と、確認の手順をまとめます。
判断に使うなら、迷わず安全な形を選ぶ
売買の判断や検証に使うなら、lookahead_offか、1本ずらしたlookahead_onを選びましょう。見た目のきれいさを優先して、ずらさないlookahead_onを使うと、検証がゆがむ原因になります。


- 判断に使うなら安全な形を選ぶ
- 見た目より検証の正しさを優先する
結果が良すぎるときは、まず設定を疑う
バックテストの結果が、驚くほど良いときは、未来の値が混ざっていないかを、先に確認しましょう。lookahead_onをずらさずに使っていないか、コードを見直すのが、最初の一歩です。
- lookahead_onを使っていないか見る
- 使っているなら1本ずらす
- 結果が現実的になるか確かめる
上位足の見方も、あわせて理解する
上位足と下位足を組み合わせて見る考え方は、FXのマルチタイムフレーム分析を紹介した記事で整理しています。チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- 上位足の考え方を先に理解する
- コードの設定で迷いにくくなる
他人のコードを使うときも、確認する
公開されているコードを使うときは、lookaheadの設定を確認しましょう。ずらさないlookahead_onが使われていると、検証の結果が実際よりも良く見えている可能性があります。



- 先読みの設定を確かめる
- 結果をうのみにしない
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
lookahead_onは、使ってはいけないのか?
使ってはいけないわけではありません。公式ドキュメントでも、1本ずらしたlookahead_onは、おすすめの書き方として紹介されています。問題になるのは、ずらさずに使って、未来の値が過去に混ざる場合です。
- ずらして使うのは問題ない
- ずらさずに使うと未来の値が混ざる
リアルタイムの動きを、すべて確認できるのか?
この記事は、公式ドキュメントの最初の約10万字までを読んだ範囲で書いています。リアルタイムの細かな動きは、公式ドキュメントの最新の内容で、あらためて確認しましょう。
まとめ:「Pine Scriptのlookahead_offとlookahead_on、未来の値を混ぜない安心感と上位足の値を早く見せる誤解のしやすさどっちを選ぶ?」
判断や検証に使うなら、lookahead_offか、1本ずらしたlookahead_onが向いています。ずらさないlookahead_onは、未来の値が混ざり、結果が実際よりも良く見える原因になる点に、気をつけましょう。
設定の意味が分かると、検証の数字との付き合い方が少しずつ心強くなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










