D3m4h GIFVG

Description
D3m4h GIFVG is an indicator designed to automatically detect market imbalances—often referred to as FVGs (Fair Value Gaps)—and potential pivot-based shifts in market structure. It offers a dynamic approach to visualizing supply/demand inefficiencies and pivot-based trend changes. Key features include:

1. Pivot-Based Bullish/Bearish Detection

The indicator identifies higher-high/lower-low pivot logic as well as “outside bar” pivots.

It tracks when the market transitions from bullish to bearish ranges, or vice versa, by using multiple checks:

• Pivot low/high detection
  
• Break-of-structure (when price crosses the last pivot)
  
• Opposing FVG detection to confirm an intraday pivot shift
  

2. FVG (Fair Value Gap) Detection

The script automatically scans for bullish or bearish FVG conditions:

• Bullish FVG: Candle at position (bar_index - 2) has a high below the current candle’s low.
  
• Bearish FVG: Candle at position (bar_index - 2) has a low above the current candle’s high.
  

When it detects an FVG, it draws a box on the chart to highlight the price gap (yellow boxes by default).

3. Pivot Range FVG

If an FVG forms while the market is in a bullish pivot range, the script can paint a special “blue” FVG to underscore its significance. The same logic applies if a newly formed FVG appears in a bearish pivot range.

4. Filled Gap Cleanup

You can optionally hide standard FVG boxes once they’re filled. For example, if the candle’s body (or candle range) covers that gap, the box is removed to keep your chart clean.

5. Pivot-Range FVG “Raided” Cleanup

If the pivot-based FVG is later filled from the opposing direction, it turns green and can optionally remove itself after a set number of bars.

6. Informative Table

A small table on the chart optionally displays whether or not the pivot-based FVG has been “raided”. You can toggle this table on/off in the settings.

How It Works
1. Pivot Shifts
The script tracks the last pivot high/low using a combination of candle-based pivot detection and break-of-structure checks (when price crosses the last pivot in the opposite direction).

When a shift is detected, the pivot range ID increments—this helps the script know when to remove old pivot-based FVGs or draw new ones.

2. FVG Formation

Each new bar checks if a bullish or bearish FVG formed (comparing the high of bar two bars ago to the current low, or the low of bar two bars ago to the current high).

If one is found, a box is drawn to highlight the imbalance. Its color and extension depend on script settings.

3. Imbalance or Pivot FVG

Standard imbalance boxes appear in yellow.

If the new imbalance coincides with a bullish or bearish pivot range, a special “pivot imbalance” box in blue is drawn.

3. Hide Filled

If a newly formed candle’s body fully covers the FVG, the box is considered filled. If Hide Filled Gaps is enabled, the box is deleted once it’s covered.

4. Raid Status

For the pivot-based (blue) FVG, once price invalidates it from the opposite side, it changes color to green and gets removed after a user-defined number of bars.

How to Use
1. Look for FVGs

Observe yellow boxes to identify potential intraday imbalances. Watch for price returning to fill these zones.

If you see a “blue” box, it signifies a pivot-based FVG in line with a recognized shift in structure—arguably a higher-probability zone.

2. “Hide Filled Gaps”

Turn this on if you only want to see currently active or partially filled imbalances. The script cleans up old, fully covered boxes to keep your chart neat.

3. Pivot Shifts

Note the script’s internal pivot logic. Each new pivot re-defines bullish or bearish states. Use these states to gauge the short-term trend shifts.

4. Toggle the Table

You can show or hide the chart table by enabling/disabling “Show Table” from the inputs. This table indicates if the pivot-based “GIFVG” has been “raided” or not.

5. Extend Count

Adjust the extendCount in the code if you want FVG boxes to extend further or shorter in time.

Underlying Concepts
Fair Value Gaps

Market inefficiencies that occur when price jumps, leaving a “gap” from the candle 2 bars ago to the current candle. They can act like mini supply/demand zones where price may revisit for balance.

Pivot Ranges

The script tries to maintain an internal sense of whether the market is in a bullish or bearish pivot range. When it sees a contrary FVG or break-of-structure, it flips the pivot state.

Outside Bars

A candle that has both a higher high and a lower low than the previous bar. The script uses these to mark significant pivot shifts.

By combining pivot-based logic with FVG detection, the D3m4h GIFVG indicator helps highlight potential areas of liquidity or unfilled value. Traders can use these zones to plan entries/exits or to confirm short-term trend shifts.