TradingViewやPine Scriptを見ていると、「リペイントする」「あとから表示が変わる」という言葉に出会うことがあります。矢印やラインが後から動いたように見える場合もあれば、リアルタイムで見ていた値と、ページ更新後に見える過去バーの表示が違う場合もあります。
この記事では、TradingView公式ドキュメントの説明をもとに、リペイントを「過去バーとリアルタイムバーの見え方の違い」「Pine Scriptの実行タイミング」「上位足データの扱い」「アラートとの関係」に分けて見ます。リペイントの有無はツールの役割を理解するための材料であり、取引結果を保証するものではありません。
- TradingView公式ドキュメントでは、リペイントは歴史バーとリアルタイム計算や描画の挙動が異なることとして説明されています。
- リアルタイムバーは更新中の情報を使うため、バー確定後に見える過去バーとは見え方が変わることがあります。
- Pine Scriptでは、バーの状態、上位足データ、
request.security()、アラート作成時のスナップショットなどが関係します。 - 「リペイントしない」という言葉だけで判断せず、どの場面で値や表示が変わるのかを分けて見てください。
TradingViewでいうリペイントとは何か
TradingViewのPine Script公式ドキュメントでは、リペイントを、歴史バーとリアルタイムの計算や描画が異なるスクリプトの挙動として説明しています。つまり、過去のチャート上で見える線やサインと、実際にリアルタイムで表示されていたものが同じとは限らない、という話です。
公式ヘルプでも、ページを更新した後にスクリプトやストラテジーの結果が変わるケースが、リペイントの一種として説明されています。これは単純な不具合ではなく、リアルタイムバーと歴史バーに含まれる情報の違いから起きる場合があります。
TradingViewの説明では、リペイントは「リアルタイムで計算された結果」と「あとから歴史バーとして読み直した結果」が違って見える現象として扱われます。Pine Scriptを見る時は、コードがどのバーの情報を使い、いつ値を確定させているのかを見る必要があります。
リペイントにはいくつかの見え方がある
「リペイント」という言葉だけでまとめると、原因を見誤りやすくなります。リアルタイムバーの途中で値が動くもの、上位足データが確定前に変わるもの、過去バーへ描画しているもの、アラート作成時の条件と現在の表示が違うものは、それぞれ見る場所が違います。
まずは、何が変わったように見えているのかを分けてください。サインそのものが消えたのか、バー確定前だけ表示が揺れたのか、ページ更新後に過去の表示が変わったのかで、読むべき公式情報も変わります。
現在のバーは価格更新に合わせて値が変わります。バー確定前の表示と、確定後に残る表示は分けて見ます。
ページ更新や再読み込み後に、リアルタイムで見ていた表示と過去バーの表示が違って見える場合があります。
上位時間足の値を下位時間足で参照する時は、確定前の上位足と確定済み上位足を分けて見る必要があります。
過去バーにマークやラベルを描く設計では、リアルタイムでは見えていなかった位置に後から表示が出ることがあります。
リアルタイムバーと確定済みバーを分けて見る
Pine Scriptの公式ドキュメントには、現在スクリプトが実行されているバーの状態を判定する barstate の情報があります。リアルタイムバー、最後のバー、確定済みバーなどを分けて扱うための変数が用意されています。
インジケーターの値は、現在のバーが更新されるたびに変わる場合があります。たとえば、バーの途中では条件を満たしていたのに、終値が確定した時には条件を満たしていない、ということがあります。この場合、バー確定前の表示をどのように扱うかが重要です。
リアルタイムの価格更新に合わせて、条件や表示が変わることがあります。通知やサインを見る時は注意します。
終値が確定した後のバーは、あとからチャートを見た時の表示として残ります。リアルタイム中の揺れとは別に見ます。
バー途中で鳴らすのか、バー確定で鳴らすのかによって、画面上の見え方と通知の印象が変わります。
上位足データとrequest.securityを見る
Pine Scriptでは、request.security() などを使って、別の銘柄や時間足のデータを取得できます。TradingView公式ドキュメントでは、上位時間足の値を使う場合に、未確定の上位足データがリアルタイムで変化し、歴史バーとの見え方が変わることが説明されています。
公式ドキュメントでは、上位時間足データで一貫した動作を得る方法として、barmerge.lookahead_on と履歴参照を組み合わせ、最後に確定した上位足の値を取得する例が説明されています。ここはPine Scriptを見る時の重要な確認点です。
上位足の値は、その上位足が確定するまで変わることがあります。下位足チャートで上位足の値を使うスクリプトを見る時は、「現在進行中の上位足を見ているのか」「確定済みの上位足を見ているのか」を分けてください。
アラートとリペイントは別々に見る
TradingView公式ヘルプでは、カスタムスクリプトのアラートについて、リペイントしやすいインジケーターやストラテジーでは、アラートの動きとチャート上の表示が違って見える場合があると説明されています。
また、Pine Scriptのアラートは、チャートUIで作成した時点のスクリプト、入力値、銘柄、時間足などのコピーを使います。作成後にスクリプトや入力値を変更しても、古いアラートへ自動反映されるとは限りません。表示が違うと感じた時は、リペイントだけでなく、アラート作成時の条件も見てください。
現在表示されているサインや線が、バー確定後も同じように残る設計かを見ます。
バー途中で鳴るのか、バー確定で鳴るのか、アラート作成時の条件が何だったのかを見ます。
スクリプトの入力値、チャートの時間足、参照している時間足を分けて確認します。
ページ更新後に過去バーの表示が変わるかを見ると、リアルタイム時との差を把握しやすくなります。
ストラテジーではcalc_on_every_tickも見る
TradingViewのストラテジー設定では、リアルタイムバーの各更新ごとに計算する項目があります。公式ヘルプでは、この設定を使うと、チャート更新後にティックデータが失われるため、ストラテジーがリペイントする可能性があると説明されています。
ストラテジーを見る時は、バックテスト結果だけでなく、リアルタイムバーでどう計算しているか、バー確定時だけで見るのか、各更新で見るのかを分けてください。過去バーで整って見える結果と、リアルタイムで見える挙動は同じとは限りません。
インジケーターでは、リアルタイムバーの途中で値やサインが変わるかを見ます。
ストラテジーでは、バー確定時の計算か、各更新ごとの計算かで結果の見え方が変わる場合があります。
アラートでは、スクリプト側の挙動に加え、アラート作成時の条件と発動頻度も見ます。
Pine Scriptを見る前のチェックリスト
Pine Scriptのコードを読む前に、リペイントに関係しやすい箇所をざっくり見ておくと、どこを深掘りすべきかが分かりやすくなります。コードの良し悪しを一言で決めるのではなく、表示、データ取得、アラート、ストラテジー設定を分けて見てください。
- リアルタイムバーの途中で値やサインが変わるか
- バー確定後に表示が残る条件か
request.security()で上位足や別銘柄を参照しているか- 未確定の上位足データを使っていないか
- 過去バーへラベルやマークを描く設計になっていないか
- アラートが作成時のスクリプトや入力値を使っているか
- ストラテジーでリアルタイム更新ごとの計算を使っているか
- ページ更新後に表示が変わるか
導入前メモ
リペイントを見る時は、「リペイントするかしないか」だけでなく、どの場面で表示や値が変わるのかを分けることが大切です。
TradingViewやPine Scriptのスクリプトは、チャート確認を補助する道具です。過去バーの見え方、リアルタイムの挙動、アラート条件を分けて扱ってください。
用語集であわせて見たい言葉
関連して読みたい記事
まとめ
TradingViewのリペイントは、単に「後から変わるから悪い」と見るより、歴史バーとリアルタイムバーの違い、上位足データの扱い、Pine Scriptの実行タイミング、アラート作成時の条件を分けて見る方が理解しやすくなります。
Pine Scriptを見る前には、リアルタイムバー、バー確定、request.security()、アラート、ストラテジー設定を確認してください。表示や通知は取引判断を補助する材料であり、結果を保証するものではありません。
- TradingView Pine Script Docs：Repainting
- TradingView Help Center：Script or strategy gives different results after refreshing the page
- TradingView Pine Script Docs：Bar states
- TradingView Pine Script Docs：Other timeframes and data
- TradingView Help Center：Issue with alert on a custom script
- TradingView Help Center：Strategy properties