OPEN-SOURCE SCRIPT
FVG - MTF Confirmed Tracker [JP/EN]
Indicator Description: FVG MTF Concluded Bar Tracker
This indicator is a highly functional tool that identifies FVG for the currently displayed bar or a higher-level bar (MTF) and determines its "resolution" when the candlestick is resolved.
Its most notable feature is that it only displays history (gray) on the chart and sends an alert when a "significant level that has been continuously observed for a certain period of time" is resolved.
1. Timeframe Settings
Base Timeframe: Select the timeframe on which to detect FVG. Select "Same as chart" to use the current bar, or select another bar (1-hour, 4-hour, etc.) to project the FVG of the higher-level bar onto the current chart.
2. Active FVG Settings
Sets the currently active support/resistance area that has not yet been filled by price.
Show Bull/Bear: Individually toggles whether to display bull (buy) and bear (sell) FVG.
Color: Specifies the color of the box for the unresolved state.
Extend Right (Active): When enabled, the box will continue to extend indefinitely toward the right edge of the chart until the FVG is resolved.
Max Active FVG: This sets the maximum number of unresolved boxes to display on the chart. When a new FVG is detected, the oldest unresolved box will be automatically deleted if it exceeds this limit, saving resources.
3. Filled FVG Settings (Resolved, Grayed Out, Determination Logic)
These are very important settings for displaying history when the price fills an FVG.
Show Filled: Select whether to leave resolved FVGs grayed out (default color) as "history."
Color: Specifies the color of boxes that have been resolved (Filled).
Extend Right (Filled): When this is turned off, the box extension will stop at the candlestick where the resolution is confirmed, making the resolution point clear.
Max Filled FVG: This sets the maximum number of grayed out boxes to display as history. When the limit is reached, the oldest history will be deleted.
Min Bars to Keep & Alert (Important): This is the threshold for the number of bars elapsed between the occurrence of an FVG and its resolution.
If the threshold is not met: The event is considered a temporary reaction, and no alert will be sounded. The event will also be deleted without being recorded in the history (gray).
If the threshold is met or exceeded: The event is considered a significant market event, and the box will turn gray and an alert will be sent.
4. Alert Settings (Alert Notification Logic)
Alerts are executed in perfect sync with the "resolution of significant levels (graying out)."
Alert when Bull / Bear turns Gray: A notification will be sent the moment a bullish or bearish FVG is resolved after meeting the threshold and turning gray.
Execution Timing: A notification will only be sent when the candlestick is confirmed. It will not be triggered if the candlestick is only momentarily touched by the wick midway through the candlestick. This allows you to know for sure that the event was resolved at the time of closing.
インジケーター解説：FVG MTF 確定足トラッカー
このインジケーターは、現在表示している足、または上位足（MTF）のFVGを特定し、その「解消」をローソク足の確定時に判定する高機能ツールです。
最大の特徴は、**「一定期間意識され続けた重要な水準」**が解消された時のみ、チャートに履歴（グレー）を残し、アラートを通知する設計にあります。
1. Timeframe Settings（時間足設定）
Base Timeframe / 基準にする時間足: FVGを検知する時間足を選択します。「Same as chart（チャートと同じ）」を選べば現在の足、それ以外（1時間足、4時間足など）を選べば上位足のFVGを現在のチャートに投影します。
2. Active FVG Settings（未解消時の設定ロジック）
まだ価格に埋められていない、現在有効なサポート・レジスタンス領域の設定です。
Show Bull / Bear: ブル（買い）およびベア（売り）のFVGを表示するかどうかを個別に切り替えます。
Color: 未解消状態のボックスの色を指定します。
Extend Right (Active): 有効にすると、FVGが解消されるまでボックスをチャートの右端に向かって無制限に延長し続けます。
Max Active FVG: チャート上に表示する未解消ボックスの最大数です。新しいFVGが検知された際、この上限を超えていると最も古い未解消ボックスが自動的に削除され、リソースを節約します。
3. Filled FVG Settings（解消済み・グレー化・判定本数ロジック）
価格がFVGを埋めた際の、履歴表示に関する非常に重要な設定項目です。
Show Filled: 解消されたFVGを「履歴」としてグレー表示（デフォルト色）で残すかどうかを選択します。
Color: 解消済み（Filled）状態になったボックスの色を指定します。
Extend Right (Filled): これをOFFにすると、解消が確定したローソク足の位置でボックスの延長が止まり、解消地点が明確になります。
Max Filled FVG: 履歴として残すグレーボックスの最大数です。上限に達すると、古い履歴から順に削除されます。
Min Bars to Keep & Alert (重要): FVGが発生してから解消されるまでの「経過本数」の閾値です。
判定本数に満たない場合: 一時的な反応とみなし、アラートを鳴らさず、履歴（グレー）にも残さず削除します。
判定本数以上の場合: 市場で十分に意識された「重要な水準」とみなし、ボックスをグレーに変更し、アラートを通知します。
4. Alert Settings（アラート通知ロジック）
アラートは「重要水準の解消（グレー化）」と完全に同期して実行されます。
Alert when Bull / Bear turns Grey: ブル/ベアそれぞれのFVGが、上記の「判定本数」を満たした状態で解消され、グレーに変化した瞬間に通知を送ります。
実行タイミング: ローソク足の確定時にのみ通知されます。足の途中のヒゲで一時的に触れただけでは鳴りません。これにより、クローズ時点で確実に解消されたことのみを把握できます。
This indicator is a highly functional tool that identifies FVG for the currently displayed bar or a higher-level bar (MTF) and determines its "resolution" when the candlestick is resolved.
Its most notable feature is that it only displays history (gray) on the chart and sends an alert when a "significant level that has been continuously observed for a certain period of time" is resolved.
1. Timeframe Settings
Base Timeframe: Select the timeframe on which to detect FVG. Select "Same as chart" to use the current bar, or select another bar (1-hour, 4-hour, etc.) to project the FVG of the higher-level bar onto the current chart.
2. Active FVG Settings
Sets the currently active support/resistance area that has not yet been filled by price.
Show Bull/Bear: Individually toggles whether to display bull (buy) and bear (sell) FVG.
Color: Specifies the color of the box for the unresolved state.
Extend Right (Active): When enabled, the box will continue to extend indefinitely toward the right edge of the chart until the FVG is resolved.
Max Active FVG: This sets the maximum number of unresolved boxes to display on the chart. When a new FVG is detected, the oldest unresolved box will be automatically deleted if it exceeds this limit, saving resources.
3. Filled FVG Settings (Resolved, Grayed Out, Determination Logic)
These are very important settings for displaying history when the price fills an FVG.
Show Filled: Select whether to leave resolved FVGs grayed out (default color) as "history."
Color: Specifies the color of boxes that have been resolved (Filled).
Extend Right (Filled): When this is turned off, the box extension will stop at the candlestick where the resolution is confirmed, making the resolution point clear.
Max Filled FVG: This sets the maximum number of grayed out boxes to display as history. When the limit is reached, the oldest history will be deleted.
Min Bars to Keep & Alert (Important): This is the threshold for the number of bars elapsed between the occurrence of an FVG and its resolution.
If the threshold is not met: The event is considered a temporary reaction, and no alert will be sounded. The event will also be deleted without being recorded in the history (gray).
If the threshold is met or exceeded: The event is considered a significant market event, and the box will turn gray and an alert will be sent.
4. Alert Settings (Alert Notification Logic)
Alerts are executed in perfect sync with the "resolution of significant levels (graying out)."
Alert when Bull / Bear turns Gray: A notification will be sent the moment a bullish or bearish FVG is resolved after meeting the threshold and turning gray.
Execution Timing: A notification will only be sent when the candlestick is confirmed. It will not be triggered if the candlestick is only momentarily touched by the wick midway through the candlestick. This allows you to know for sure that the event was resolved at the time of closing.
インジケーター解説：FVG MTF 確定足トラッカー
このインジケーターは、現在表示している足、または上位足（MTF）のFVGを特定し、その「解消」をローソク足の確定時に判定する高機能ツールです。
最大の特徴は、**「一定期間意識され続けた重要な水準」**が解消された時のみ、チャートに履歴（グレー）を残し、アラートを通知する設計にあります。
1. Timeframe Settings（時間足設定）
Base Timeframe / 基準にする時間足: FVGを検知する時間足を選択します。「Same as chart（チャートと同じ）」を選べば現在の足、それ以外（1時間足、4時間足など）を選べば上位足のFVGを現在のチャートに投影します。
2. Active FVG Settings（未解消時の設定ロジック）
まだ価格に埋められていない、現在有効なサポート・レジスタンス領域の設定です。
Show Bull / Bear: ブル（買い）およびベア（売り）のFVGを表示するかどうかを個別に切り替えます。
Color: 未解消状態のボックスの色を指定します。
Extend Right (Active): 有効にすると、FVGが解消されるまでボックスをチャートの右端に向かって無制限に延長し続けます。
Max Active FVG: チャート上に表示する未解消ボックスの最大数です。新しいFVGが検知された際、この上限を超えていると最も古い未解消ボックスが自動的に削除され、リソースを節約します。
3. Filled FVG Settings（解消済み・グレー化・判定本数ロジック）
価格がFVGを埋めた際の、履歴表示に関する非常に重要な設定項目です。
Show Filled: 解消されたFVGを「履歴」としてグレー表示（デフォルト色）で残すかどうかを選択します。
Color: 解消済み（Filled）状態になったボックスの色を指定します。
Extend Right (Filled): これをOFFにすると、解消が確定したローソク足の位置でボックスの延長が止まり、解消地点が明確になります。
Max Filled FVG: 履歴として残すグレーボックスの最大数です。上限に達すると、古い履歴から順に削除されます。
Min Bars to Keep & Alert (重要): FVGが発生してから解消されるまでの「経過本数」の閾値です。
判定本数に満たない場合: 一時的な反応とみなし、アラートを鳴らさず、履歴（グレー）にも残さず削除します。
判定本数以上の場合: 市場で十分に意識された「重要な水準」とみなし、ボックスをグレーに変更し、アラートを通知します。
4. Alert Settings（アラート通知ロジック）
アラートは「重要水準の解消（グレー化）」と完全に同期して実行されます。
Alert when Bull / Bear turns Grey: ブル/ベアそれぞれのFVGが、上記の「判定本数」を満たした状態で解消され、グレーに変化した瞬間に通知を送ります。
実行タイミング: ローソク足の確定時にのみ通知されます。足の途中のヒゲで一時的に触れただけでは鳴りません。これにより、クローズ時点で確実に解消されたことのみを把握できます。
Skrypt open-source
W zgodzie z duchem TradingView twórca tego skryptu udostępnił go jako open-source, aby użytkownicy mogli przejrzeć i zweryfikować jego działanie. Ukłony dla autora. Korzystanie jest bezpłatne, jednak ponowna publikacja kodu podlega naszym Zasadom serwisu.
Wyłączenie odpowiedzialności
Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.
Skrypt open-source
W zgodzie z duchem TradingView twórca tego skryptu udostępnił go jako open-source, aby użytkownicy mogli przejrzeć i zweryfikować jego działanie. Ukłony dla autora. Korzystanie jest bezpłatne, jednak ponowna publikacja kodu podlega naszym Zasadom serwisu.
Wyłączenie odpowiedzialności
Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.