Price Void Atlas [AGPro Series]

4月20日

Price Void Atlas [AGPro Series]

🗺️ OVERVIEW

Price Void Atlas maps the chart's low-interaction price corridors — zones where price travelled fast and spent very little time — and tracks how price behaves when it returns. Unlike volume-based profiles that highlight crowded price levels, this indicator surfaces the opposite: the empty highways of the chart. Every corridor carries a live state (Fresh, Entered, Passed, Rejected) so you can read return behavior at a glance.


🧭 UNIQUE EDGE

Most volume profile and imbalance tools show where price concentrated. Price Void Atlas inverts the question: where did price refuse to concentrate? The detection engine is purely time-weighted and ATR-normalized, so it works identically on instruments without reliable volume data (forex, many altcoins, CFDs). The state machine adds a second layer — it does not just detect voids, it follows their return stories. This combination (time-based emptiness detection + entry-side-aware state tracking) is the core differentiator.


🔬 METHODOLOGY

The Scan Length window is sliced into 40 horizontal price bands. For each historical bar in the window, every band it intersects receives an ATR-normalized time weight. Bands that accumulate weight below a sensitivity-driven percentile threshold are flagged as empty. Contiguous empty bands form a corridor. Height is capped at 50% of total range to keep corridors structurally meaningful. Candidates are scored on a 65/35 weighted blend of emptiness intensity and ATR-normalized height, then the top N survivors are kept. Optional vertical proximity merging (0.3×ATR) consolidates nearby corridors into larger atlas-feel zones.

The state machine then observes price behavior per corridor:
- Fresh → never touched since birth
- Entered → price crossed inside; entry side is locked (top or bottom)
- Passed → close crossed beyond the far boundary (clean traversal)
- Rejected → close reversed beyond entry side by 35% of corridor depth


🔔 SIGNALS & ALERTS

Three independent alert channels:
- Void Entered — price re-enters an active corridor
- Void Passed — price closes through the far boundary
- Void Rejected — price reverses past its entry side

Each alert fires once per bar on confirmed close. Corridors are drawn as persistent ATR-aware rectangles with state-colored borders and labels. A dominant corridor (highest rank score) gets a thicker border as a visual hierarchy cue.


🎛️ KEY INPUTS

Core Engine
- Scan Length (100–1000): window of bars analyzed
- Sensitivity (Strict / Balanced / Loose): emptiness threshold
- Max Voids (1–6): hard cap on simultaneous corridors
- Hide Resolved Voids: removes Passed/Rejected for a clean view
- Merge Vertically Close Voids: atlas consolidation

Visual
- Panel Location (5 positions), Panel Theme (Dark / Light)
- Panel Font Size, Label Font Size (tiny → large, default normal)
- Show Entry Side Hint (↑ / ↓ arrows on Entered labels)

Alerts
- Individual toggles for Entered / Passed / Rejected


🎯 HOW TO USE

1. Apply on a chart with enough history (200+ bars recommended for 300 Scan Length)
2. Fresh amber zones are untouched voids — potential re-interaction targets
3. When price approaches a Fresh zone, the corridor turns indigo (Entered)
4. Observe whether the interaction resolves as a traversal (Passed, teal) or a turn-away (Rejected, pink)
5. Use corridor boundaries as structural reference points alongside your own system
6. The dominant corridor (thickest border) represents the cleanest void by rank score
7. Works across all timeframes; adaptive rebuild cadence keeps performance consistent


⚠️ LIMITATIONS & TRANSPARENCY

- This is an analysis aid, not a trading strategy. It does not generate buy or sell signals.
- Corridor detection requires at least Scan Length bars of history; newly loaded charts render progressively as history accumulates.
- The time-weighted emptiness metric depends on ATR stability; very low-volatility environments may produce fewer meaningful voids.
- State transitions are evaluated on confirmed bar closes to prevent intrabar repainting.
- Corridors persist across bars but are rebuilt on an adaptive cadence (5–25 bars depending on timeframe) for CPU efficiency.
- All visuals are computed from the visible historical data on the current chart; extending the lookback will refresh the atlas.


🛡️ RISK DISCLOSURE

This indicator is provided for educational and analytical purposes only. It does not predict future price movement, does not generate trade recommendations, and does not constitute financial advice. Trading involves substantial risk of loss. Past corridor interactions do not guarantee future behavior. Always conduct your own research and risk management.

5月26日

リリースノート

🔧 UPDATE NOTES - V2.2

This update focuses on publication polish, visual hierarchy, and AGPro interface consistency.

The core purpose of the script remains unchanged.
This release improves how price voids are presented, labeled, and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added centered void badges
Each visible void can now display a centered PRICE VOID badge with the current state beneath it.
The badge is a separate label object and does not use box text.

• Added panel show / hide control
The AGPro information panel can now be disabled from settings while remaining enabled by default.

• Standardized panel naming
The panel header now uses the full script identity: AG Pro Price Void Atlas.

• Expanded panel controls
Panel location now supports top, middle, and bottom center placements.
Panel themes now include Elite Dark, Slate, and Clean Light.

• Updated label and panel size controls
Font-size options now use the standard AGPro casing: Tiny, Small, Normal, Large, and Huge.

• Cleaned publication header
The source header was aligned with current AGPro public-free release standards.


------------------------
Visual Improvements
------------------------

• Added centered zone labels to make voids readable without relying only on right-edge tags

• Improved state hierarchy across Fresh, Entered, Passed, and Rejected voids

• Strengthened active and dominant void borders for better first-glance visibility

• Preserved the clean atlas feel while making the chart less visually empty

• Kept right-edge state tags optional for users who prefer a cleaner chart


------------------------
Interface & Usability
------------------------

• Added Show Centered Void Badges

• Added Show Right Edge State Tags

• Added Show Panel

• Added expanded panel positions

• Added expanded panel themes

• Improved panel layout with Active, Fresh / Entered, Resolved, Emptiness, Price, and Last Route


------------------------
Behavior Notes
------------------------

This update does not change the core analytical concept of the script.

The void detection, ranking, merging, state tracking, and alert logic remain aligned with the prior version.

Users should interpret outputs the same way as before, but with clearer visual structure.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Timeframe differences, volatility shifts, and scan-window selection may affect which voids are shown.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.

6月26日

リリースノート

🔧 UPDATE NOTES - v2.3

This update focuses on adding a decision read and a void-fill proof statistic.

The core purpose of the script remains unchanged.
This release adds a next-action read and a historical pass-versus-reject proof
rate to the panel, makes every on-chart badge contrast-safe, and hardens the ATR
baseline. It does not change the void detection or state logic.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Action row added
A single next-step read derived from the current voids and price position:
inside a void, a live void to watch, all voids resolved, or no void mapped.

• Fill Proof row added
When a void is entered, the atlas measures whether price followed through in the
fill direction (1.5 ATR) before reversing against it (1.0 ATR), evaluated on
confirmed closes. It reports the fill share with the sample count, e.g. "54% (24)",
and reads "Building (n)" until at least 6 samples exist. This is a fair, symmetric
follow-through read rather than requiring full void traversal.

• Unified label contrast
The centered void badges and right-edge state tags now derive their text color
from the fill brightness, so Fresh, Entered, Passed, and Rejected badges stay
legible on both bright and dark fills.

• Hardened ATR baseline
The ATR used for slice weighting and merge spacing now falls back to true range
and a minimum tick on early or illiquid bars.


------------------------
Visual Improvements
------------------------

• Improved badge and tag readability by deriving text color from each fill

• Kept void corridors, centered badges, and right-edge tags otherwise unchanged

• Maintained the few-meaningful-voids atlas view rather than heatmap clutter


------------------------
Interface & Usability
------------------------

• Panel now adds an Action read and a Fill Proof statistic at the bottom

• Grouped the void context and the next step so the read flows top to bottom

• Enhanced overall user experience without changing the core detection


------------------------
Behavior Notes
------------------------

This update does not change the core void detection, merge, or state logic.

The Action read is a context summary and the Fill Proof row is a historical,
descriptive statistic measured on confirmed closes. Neither is a
forecast, win rate, or trade instruction, and the pass rate is symbol- and
timeframe-dependent.

Users should interpret outputs the same way as before, now with an added action
and void-fill context.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, and timeframe differences may
affect how voids form, resolve, and how the fill rate reads.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.

8月14日

リリースノート

Version 2.4 – Ranked Void Identity

This update sharpens the atlas hierarchy while preserving the existing price-void methodology.

• The default view now focuses on the two highest-ranked live voids for a cleaner first-glance map.
• Corridor fills now use subtle rank- and lifecycle-aware transparency, reducing visual dominance without changing boundaries.
• Every centered badge now identifies the structure and its emptiness percentage at the exact geometric center.
• Right-edge tags now communicate lifecycle only, with compact Fresh Watch and directional Entry states.
• Tooltips were refined to explain the curated display hierarchy and the distinct roles of center and edge badges.

The detection, merge, ranking, state, fill-proof, and alert calculations remain unchanged.