Imbalance Cartograph [JOAT]

Imbalance Cartograph [JOAT]

Introduction

The Imbalance Cartograph is an advanced open-source price imbalance mapping engine that identifies, tracks, and manages Fair Value Gaps (FVGs) and Supply/Demand zones across multiple layers. It goes far beyond basic FVG detection by adding auto-mitigation, volume filtering, transparency fade for aging zones, stacked imbalance detection, confluence highlighting, nearest zone radar, imbalance density scoring, and a comprehensive 15-row dashboard. Every zone is non-repainting and drawn only on confirmed bars.

The core idea is simple but powerful: institutional order flow creates imbalances in price delivery. These imbalances — gaps where price moved too fast for the market to fill, and zones where large orders were placed — act as magnets that price tends to revisit. By mapping all active imbalances and tracking their lifecycle, traders can identify high-probability areas where institutional interest exists.



Why This Indicator Exists

Fair Value Gaps and Supply/Demand zones are among the most discussed concepts in Smart Money methodology, yet most indicators that detect them are simplistic: they draw a box when a gap forms and leave it there indefinitely, with no lifecycle management, no volume confirmation, and no way to assess how many imbalances are clustered near current price.

The Imbalance Cartograph solves these problems by treating imbalances as living entities with a full lifecycle:

• Creation: FVGs are detected using the standard three-candle gap pattern, but filtered by volume (only gaps formed on above-average volume qualify by default). Supply/Demand zones are created at swing pivots using configurable pivot lengths.
• Aging: Older zones progressively fade in transparency, giving visual priority to fresh zones while keeping historical context visible.
• Testing: When price returns to a zone, it transitions from "fresh" to "tested" with a color change, indicating the zone has been challenged but not broken.
• Mitigation: FVGs are automatically deleted when price fills the gap completely. Supply zones broken by price can convert to breaker blocks (polarity flip).
• Confluence: When an FVG overlaps with a Supply/Demand zone, the overlap area is highlighted as a high-probability confluence zone.

Layer 1: Fair Value Gaps

FVGs represent gaps in price delivery where the market moved so aggressively that it left unfilled space between candles. The indicator detects both bullish and bearish FVGs:

• Bullish FVG: Current candle's low is above the candle-two-bars-ago's high, and the middle candle closed above that high. This creates an upward gap in price delivery.
• Bearish FVG: Current candle's high is below the candle-two-bars-ago's low, and the middle candle closed below that low. This creates a downward gap.

Each FVG is drawn as a colored box extending forward (default 50 bars) with optional price labels showing the exact gap range.

Volume Filter: When enabled (default), FVGs only qualify if the middle candle's volume exceeds the 20-bar average. This filters out low-conviction gaps that are less likely to act as institutional reference points.

Auto-Mitigation: When enabled (default), FVGs are automatically deleted when price fills the gap. For bullish FVGs, this means price's low touches the top of the gap. For bearish FVGs, price's high reaches the bottom. The indicator tracks mitigation counts for the dashboard.

Stacked Imbalance Detection: When two or more consecutive FVGs form in the same direction, the indicator marks them as "STACKED" with a count. Stacked FVGs indicate sustained institutional pressure — the market is creating gap after gap in the same direction, which is a strong directional signal.

Layer 2: Supply and Demand Zones

Supply and Demand zones are created at swing pivot points detected using ta.pivothigh() and ta.pivotlow() with a configurable pivot length (default 10 bars).

• Supply Zones: Created at swing highs. The zone extends from the swing high candle's high down to the candle body (max of open, close). These represent areas where selling pressure overwhelmed buying.
• Demand Zones: Created at swing lows. The zone extends from the swing low candle's low up to the candle body (min of open, close). These represent areas where buying pressure overwhelmed selling.

Zone Lifecycle:

• Fresh: Newly created zone, bright color, never tested
• Tested: Price has returned to the zone but not broken through. Color shifts to indicate the zone has been challenged.
• Broken/Breaker: When price breaks through a zone completely, it can optionally convert to a "breaker block" — the zone flips polarity (old supply becomes potential demand, and vice versa). This is a key Smart Money concept.

Overlap Prevention: New zones are checked against existing zones using an ATR-based threshold. If a new zone would overlap with an existing one, it is not drawn, keeping the chart clean.

BOS Lines: When price breaks through a supply or demand zone, a Break of Structure (BOS) line is drawn at the broken level, marking the structural shift.

Transparency Fade: When enabled, older zones gradually become more transparent based on their age in bars. This creates a natural visual hierarchy where fresh zones stand out and old zones fade into the background.

Advanced Features

Imbalance Confluence Detection:
The indicator checks whether any active FVG overlaps with any active Supply/Demand zone. When they overlap, the confluence area is highlighted with a gold-colored marker. These confluence zones represent areas where two independent institutional concepts agree — a gap in price delivery coincides with a structural supply or demand level. These are among the highest-probability zones on any chart.

Nearest Zone Radar:
The indicator continuously calculates the distance from current price to the nearest active zone (supply or demand). The dashboard displays the zone type, distance in ATR multiples, and direction. This gives traders an instant read on how close they are to the next potential reaction area.

Imbalance Density:
The indicator counts how many active FVGs and S/D zones exist within 3 ATR of current price and produces a density score (0-10). High density means price is surrounded by multiple imbalances — a "thick" area where reactions are likely. Low density means price is in "clean" territory with fewer institutional reference points.

15-Row Dashboard

• Rows 1-2: Bull FVG and Bear FVG counts with stacked status
• Rows 3-4: Supply and Demand zone counts with lifecycle state (Fresh/Tested)
• Row 5: Breaker block count
• Row 6: FVG fill rate (percentage of FVGs that have been mitigated)
• Row 7: Nearest zone type, distance, and direction
• Row 8: Imbalance density score and classification
• Row 9: Confluence detection status (active/none)
• Row 10: Stacked imbalance status
• Row 11: Zone age (average bars since creation for active zones)
• Row 12: Supply retest count and demand retest count
• Row 13: Market bias based on imbalance distribution (more bull FVGs + demand = bullish)
• Rows 14-15: Total FVG and zone statistics

Input Parameters

Fair Value Gaps:

• Show FVGs (default on), FVG Extend bars (default 50), Max FVGs Displayed (default 15)
• Auto-Mitigate FVGs (default on) — delete when price fills the gap
• Volume Filter (default on) — only show FVGs with above-average volume

Supply / Demand Zones:

• Show Zones (default on), Pivot Length (default 10), Max Zones (default 15)
• Show BOS Lines (default on), Convert to Breaker (default on)
• Fade Old Zones (default on) — transparency increases with age

Advanced Features:

• Show Confluence Zones (default on), Show Stacked Imbalances (default on)
• Show Price Labels on Zones (default on)

How to Use This Indicator

Step 1: Identify Active Imbalances
Look at the chart for active FVG boxes and S/D zones. Fresh zones (brighter colors) are more likely to produce reactions than tested or faded zones.

Step 2: Check Imbalance Density
The dashboard's density score tells you whether price is in a zone-rich or zone-poor area. High density (7+) means multiple imbalances are nearby — expect reactions. Low density (0-2) means price is in clean delivery territory.

Step 3: Watch for Confluence
When the dashboard shows "CONFLUENCE ACTIVE," an FVG overlaps with a S/D zone. These are the highest-probability reaction areas. Consider these zones for entries with tight stops.

Step 4: Monitor Stacked FVGs
Stacked FVGs (2+ consecutive gaps in the same direction) indicate strong institutional pressure. The market is not pausing to fill gaps — it is aggressively displacing price. Trade in the direction of stacked FVGs.

Step 5: Use Nearest Zone for Targets
The nearest zone radar tells you how far price is from the next potential reaction. Use this for setting take-profit targets or anticipating where price may stall.

Step 6: Track Mitigation Rate
The FVG fill rate shows what percentage of gaps have been filled. A high fill rate suggests the market is efficiently filling imbalances (range-bound behavior). A low fill rate suggests strong trending where gaps are being left behind.

Limitations

• FVG detection uses a standard three-candle pattern. Not all gaps are created by institutional activity — news events and low-liquidity periods can create gaps that lack institutional significance.
• Supply/Demand zones are based on swing pivots, which require a lookback period. The pivot length parameter significantly affects zone placement — shorter lengths create more zones, longer lengths create fewer but more significant zones.
• Auto-mitigation deletes FVGs when price touches the gap boundary. In some cases, price may wick into a gap without truly filling it. The indicator treats any touch as mitigation.
• Volume filtering uses the 20-bar volume average. On instruments with irregular volume patterns (e.g., crypto on weekends), this filter may be too aggressive or too lenient.
• The indicator draws on confirmed bars only (barstate.isconfirmed), so zones appear one bar after the pattern completes. This is intentional to prevent repainting.
• Imbalance zones show where institutional interest existed historically. They do not guarantee future price reactions.

Originality Statement

This indicator is original in its comprehensive lifecycle approach to imbalance mapping. While FVG detection and S/D zones exist in other scripts, this indicator is justified because:

• It treats imbalances as entities with a full lifecycle (creation, aging, testing, mitigation, breaker conversion) rather than static drawings
• The volume filter ensures only institutionally-significant FVGs are displayed, reducing noise from low-conviction gaps
• Transparency fade creates a natural visual hierarchy that no static-color indicator provides
• Stacked imbalance detection identifies consecutive FVGs as a measure of institutional pressure — a concept not available in standard FVG indicators
• Confluence detection between FVGs and S/D zones creates a cross-layer analysis that identifies the highest-probability reaction areas
• Nearest zone radar and imbalance density scoring provide quantitative measures of the imbalance environment around current price
• The combination of FVG lifecycle management, S/D zone tracking with breaker conversion, confluence detection, density scoring, and a comprehensive dashboard creates a unified imbalance analysis system not available in any single existing indicator

Disclaimer

This indicator is provided for educational and informational purposes only. It is not financial advice or a recommendation to buy or sell any financial instrument. Trading involves substantial risk of loss and is not suitable for all investors.

Price imbalances are historical observations about where gaps and zones formed. They do not predict future price movement. While price often revisits imbalances, there is no guarantee that any specific FVG will be filled or that any S/D zone will produce a reaction.

Always use proper risk management. Never risk more than you can afford to lose. The author is not responsible for any losses incurred from using this indicator.

-Made with passion by officialjackofalltrades