この記事を開いてくださったこと、心から感謝しています。Pine Scriptで1時間足の中の1分足の値動きを調べようとして、request.securityとrequest.security_lower_tfのどちらを使えばよいのか迷った人も多いはずです。
結論から言うと、足の内側の値をまとめて調べたいならrequest.security_lower_tf、同じ時間足か上位足の値を1つ受け取りたいならrequest.securityが向いています。
この記事では、2つの関数の戻り値の違い・下位足の扱い・取得できる上限・リクエスト数の制限を整理し、自分に合う選び方まで踏み込んでまとめます。
request.securityとrequest.security_lower_tfは、何が違うのか?
まずは、2つの関数の役割と、戻り値の形の違いを整理します。
request.security_lower_tfは、足の内側のデータを配列で返す
TradingViewの公式ドキュメントによると、request.security_lower_tfは、チャートよりも短い時間足の、足の内側のデータを取得する関数です。チャートの1本の足の中にある、すべての短い足の値を、配列にまとめて返します。
- チャートより短い時間足のデータを取る
- 足の内側の値を配列でまとめて返す
request.securityは、短い足を呼ぶと1つだけ返す
公式ドキュメントでは、request.securityで短い時間足のデータを呼ぶと、チャートの1本の足につき、短い足のうちの1本分の結果だけが返されると説明されています。足の内側の値を、すべて見たいときには、物足りない動きです。
request.securityは、本来、同じか上位の時間足向け
公式ドキュメントによると、request.securityは、チャートと同じか、それより長い時間足で使うことを想定した関数です。短い時間足も呼べますが、制限があると説明されています。
ほとんどの足の内側のデータには、request.security_lower_tfが勧められています。
- 想定は同じか上位の時間足
- 足の内側向きはsecurity_lower_tf
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
戻り値の違いは、どう表れるのか?
値が1つか、配列かという違いが、使い方にどう影響するかを確認します。
配列なら、足の内側の動きを自分で計算できる
配列で受け取れば、足の内側の高値と安値の幅や、上昇した足の本数など、自分で好きな計算ができます。足の内側の値動きの形を、細かく調べたいときに向いています。
- 高値や安値の幅を計算できる
- 上昇した足の本数も数えられる
1つだけでは、全体の動きが分からない
request.securityで短い足を呼ぶと、1本分の値しか返らないため、足の内側で何が起きたかを、判断できません。同じ1時間の中で、どんな動きがあったのかを知りたいときは、配列で受け取るほうが、情報が多くなります。
配列を扱う手間は、増える
配列で受け取ると、値を取り出したり、合計や平均を求めたりする処理を、自分で書く必要があります。値を1つだけ受け取るrequest.securityのほうが、書き方は簡単です。必要な情報の量と、書く手間のバランスで、選びましょう。
- 配列の処理を自分で書く必要がある
- 1つの値のほうが書き方は簡単
取得できる数には、どんな上限があるのか?
公式ドキュメントが示している、足の内側のデータの上限を確認します。
短い足は、最大20万本まで取得できる
公式ドキュメントによると、スクリプトが短い時間足から取得できる足の内側のデータは、最大で20万本です。この上限は、バックテストの期間や、チャートの時間足の選び方に影響します。
- 取得できる短い足は最大20万本
- 期間や時間足の選び方に影響する
20万本は、どれくらいの期間にあたるのか
短い足の長さがそのまま、カバーできる時間になります。1分足なら20万分で、約138.9日分です。5分足なら100万分で、約694日分、15分足なら300万分で、約2,083日分です。平日24時間取引で、1年を260日と仮定すると、5分足は約2.7年、15分足は約8年になります。
| 短い足 | 20万本の長さ | 期間の目安(平日24時間) |
|---|---|---|
| 1分足 | 20万分 | 約139日(約6.4か月) |
| 5分足 | 100万分 | 約694日(約2.7年) |
| 15分足 | 300万分 | 約2,083日(約8年) |
※平日24時間取引・年260営業日を仮定した、筆者の計算例です。実際は、銘柄の取引時間や、履歴の長さで変わります。
細かい足ほど、長い期間は調べにくくなる
1分足で調べると、約6か月分で、上限に届く計算です。長い期間を調べたいときは、5分足や15分足のように、少し粗い足を選ぶと、カバーできる期間が長くなります。精度と期間は、引き換えの関係です。
- 1分足は約6か月分で上限に届く
- 粗い足なら長い期間をカバーできる
利用できる足の数は、条件で変わる
公式ドキュメントでは、足の内側のデータが使えるチャートの足の数は、選んだ短い時間足や、計算する足の数の設定、利用者のプランによって変わると説明されています。実際に使える範囲は、自分の環境で確かめましょう。
リクエストの数には、どんな制限があるのか?
データの呼び出し回数にも、決まりがあります。
異なるリクエストは、最大40個まで
公式ドキュメントによると、スクリプトが行える、重複しないリクエストは、requestで始まる関数の組み合わせで、最大40個です。Ultimateプランなら、最大64個まで増えます。
同じ呼び出しを繰り返しても、データは再利用され、新しいリクエストとは、数えられないのが基本です。
| プラン | 重複しないリクエストの上限 |
|---|---|
| 一般 | 最大40個 |
| Ultimate | 最大64個 |
※公式ドキュメントの説明をもとにした整理です。プランの内容は変更される場合があります。
使う時間足と銘柄の数が、そのまま消費になる
たとえば、5つの銘柄で、それぞれ3つの時間足のデータを呼ぶと、重複しない呼び出しは、5×3=15個です。40個の上限までは、あと25個の余裕があります。呼び出しが多いスクリプトでは、数を数えながら設計しましょう。
- 銘柄数×時間足の数で数える
- 上限までの余裕を確かめる
同じ呼び出しは、まとめて使い回す
同じ内容の呼び出しは、データが再利用されるため、何度も書いても、リクエストの数は増えにくくなります。ただし、書き方を変えると、別のリクエストとして、数えられる場合があります。同じ書き方にそろえると、安心です。
- 同じ内容はデータが再利用される
- 書き方をそろえると安心
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、どちらの関数を選ぶとよいかの目安を整理します。
足の内側を調べるなら、request.security_lower_tf
足の内側の値動きを、細かく調べたいなら、request.security_lower_tfが向いています。たとえば、1時間足の中で、1分足が何本上昇したかを数えるような、使い方ができます。

- 足の内側の値動きを調べられる
- 本数を数えるなどの計算ができる
上位足の値を1つ使うなら、request.security
日足の高値のように、上位の時間足の値を1つだけ使いたいなら、request.securityが向いています。値の渡し方が簡単で、書く量も少なくなります。上位足の扱いは、Pine Scriptのlookahead_offとlookahead_onを比べた記事で整理しています。
- 上位足の値を1つ受け取る
- 書く量が少なくて済む
迷ったら、目的が足の内側かどうかで決める
迷ったときは、調べたいものが、足の内側か、別の時間足の1つの値かで、決めましょう。足の内側ならrequest.security_lower_tf、別の時間足の1つの値ならrequest.securityです。


運用で気をつけたいことは、何か?
実際に使うときに、確認したい点をまとめます。
短い足の指定が、チャートより長くならないようにする
公式ドキュメントでは、チャートの時間足よりも短い足を呼ぶ前提の関数に、チャートより長い足を指定すると、問題が起きる場合があるため、公開するスクリプトでは、確認の処理を入れることが勧められています。時間足を切り替えても、動くように、備えておきましょう。
- チャートの時間足を切り替えても動くようにする
- 確認の処理を入れておくと安心
バックテストの精度とも、関係がある
足の内側のデータは、バックテストで、約定の順序を確かめるときにも、役立ちます。TradingViewの検証機能は、TradingViewのバーマグニファイヤーの記事でも整理しています。
チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- 検証の細かさの考え方につながる
- どこまで求めるかを決められる
呼び出しの数は、設計の段階で数える
後から呼び出しを増やすと、上限を超えて、動かなくなる場合があります。最初に、使う銘柄と時間足の数を、紙に書き出して数えておくと、無理のない設計になります。



- 最初に呼び出しの数を数える
- 上限に余裕を持たせる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
1時間足の中の1分足は、必ず60本返るのか?
理論上は、1時間の中に、1分足が60本入ります。ただし、公式ドキュメントのこのページでは、実際に返る本数は、確認されていません。取引が少ない時間帯などでは、本数が変わる場合も考えられるため、実際の本数は、自分で確かめましょう。
- 理論上は60本
- 実際の本数は自分で確かめる
ignore_invalid_timeframeは、何をするのか?
この引数は、request.security_lower_tfの引数として、公式ドキュメントに載っています。ただし、この記事では、動きの詳しい説明まで、確認できた範囲に含めていません。使うときは、最新の公式ドキュメントで確認しましょう。
まとめ:「Pine Scriptのrequest.securityとrequest.security_lower_tf、1つの値を手軽に受け取る簡単さと足の内側をまとめて調べる細かさどっちを選ぶ?」
足の内側をまとめて調べたいならrequest.security_lower_tf、別の時間足の値を1つ使うならrequest.securityが向いています。取得できる短い足は最大20万本で、リクエストの数にも上限がある点に、気をつけましょう。
関数の違いが分かると、データの扱い方が少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










