AG Pro Value Shift Ladder [AGPro Series]# AG Pro Value Shift Ladder
## Overview
AG Pro Value Shift Ladder maps the ladder of accepted-value zones that price has repeatedly visited, showing how the market's notion of "fair value" migrates up, down, or breaks over time. Each rung of the ladder is a shelf anchored to a confirmed pivot, validated by the time price spent inside its band and the volume that traded there. Held, broken, and reclaimed shelves are tracked together, and the resulting sequence is summarized as a single ladder state — Rising, Falling, Mixed, Broken, Reclaiming, Building, or Neutral.
The tool is intended as a structural reference for discretionary traders who want to see where price has been accepted, where it has been rejected, and how those anchors are drifting. It does not generate buy/sell signals and is not a trading system.
---
## Unique Edge
Most shelf, S/R, or volume-based tools plot every candidate level they can find and leave the user to filter. Value Shift Ladder does three things differently:
- **Pivot-anchored hybrid acceptance.** A shelf is only registered when a confirmed swing pivot is surrounded by a configurable time-dwell (bars spent inside its band) AND a volume threshold (cumulative volume inside the band). Both conditions must be met. Single-confirmation noise is filtered out at the source.
- **Migration-aware state machine.** Each shelf has a lifecycle: Held → Broken → Reclaimed → Held. Transitions require sustained price behavior (three bars for a break, multiple bars of dwell for a reclaim), preventing oscillation between states on noise.
- **Proximity-gated visualization.** Only shelves within a configurable ATR distance from current price are drawn and fed into the ladder state. Distant historical shelves do not clutter the chart or contaminate the panel's metrics.
The result is a clean, structural ladder — usually three to five rungs — connected by thin riser lines that visually encode the migration path.
---
## Methodology
**Shelf candidate generation.** A swing pivot (high or low) with N bars on each side becomes a candidate shelf anchor. N is user-configurable via Pivot Length.
**Hybrid acceptance test.** For each candidate, the script scans the last 80 bars and counts:
1. How many bars closed inside the candidate's acceptance band (ATR × sensitivity multiplier).
2. Cumulative volume of those bars.
A shelf is accepted only if both the dwell-bar count meets Min Dwell Bars AND the cumulative volume meets Min Volume Confirmation × (average volume × dwell bars). Candidates failing either test are discarded.
**Separation filter.** A newly accepted shelf is rejected if it sits within Min Step Separation (ATR) of an existing active shelf, preventing micro-levels from cluttering the ladder.
**Break detection.** A held shelf transitions to Broken when price closes beyond its band by more than Break Distance (ATR) for three consecutive bars.
**Reclaim detection.** A broken shelf transitions to Reclaimed when price closes back inside its band for at least Reclaim Dwell Bars. A reclaimed shelf is promoted back to Held after ten additional bars of stability.
**Expiry.** Broken shelves older than Broken Expire Bars with no reclaim are purged.
**Ladder state.** The chronological sequence of active (held + reclaimed) shelves is evaluated: strictly monotonic rising → Rising; strictly monotonic falling → Falling; otherwise Mixed (with Above/Below context vs. the most recent shelf). Recent break or reclaim events override with Broken or Reclaiming.
---
## Signals & Alerts
Four alert conditions are exposed:
- **New Ladder Step Formed** — a new accepted-value shelf has been registered.
- **Ladder Step Held** — an existing shelf has been re-confirmed by fresh dwell + volume.
- **Ladder Step Broken** — a held shelf has been decisively lost.
- **Ladder Step Reclaimed** — a previously broken shelf has been reclaimed.
All alerts are informational markers of structural change. They do not encode directional trade intent.
---
## Key Inputs
**Step Engine**
- Step Sensitivity (Tight / Balanced / Wide) — band width around pivot anchors
- Pivot Length — bars on each side for swing pivot detection
- Min Dwell Bars — time-side of the hybrid acceptance test
- Min Volume Confirmation × — volume-side of the hybrid acceptance test
- Min Step Separation (ATR) — minimum ATR distance between accepted shelves
- Break Distance (ATR) — how far price must close beyond a shelf to flag a break
- Reclaim Dwell Bars — bars price must spend back inside the band to reclaim
- Broken Expire Bars — age at which unreclaimed broken shelves are purged
- Max Visible Distance (ATR) — proximity gate around current price
**Ladder Display**
- Max Visible Active Steps (3–8) — cap on simultaneously drawn active shelves
- Max Visible Broken Steps (0–5) — cap on displayed migration history
- Active Ladder Only — minimal mode showing just the dominant shelf
- Project Steps Forward — 30-bar forward projection of each shelf
- Show Ladder Connectors — thin riser lines between consecutive shelves
**Panel & Labels**
- Panel / label font size, panel position
- Alert master toggle
- Full color palette (state-driven, theme-independent)
---
## How to Use
- Apply on any timeframe and instrument. Balanced defaults are tuned for 1H–4H crypto; on faster timeframes consider raising Pivot Length, on slower timeframes lower it.
- Read the panel's Ladder state first, then the Dominant shelf price. These two values summarize where accepted value currently sits and how it is migrating.
- Use the on-chart labels for structural context: Up / Down / Held / Reclaim / Broken describe what each rung is doing.
- Integrity shows the percentage of recent shelves still holding. High integrity (green) means the ladder is intact; low integrity (red) means recent migration has broken most anchors.
- Treat the output as a structural map, not a signal. Combine with your own directional, volatility, and risk framework.
---
## Limitations & Transparency
- All calculations use completed bar data. Shelf registration is delayed by Pivot Length bars (the swing pivot is not confirmed until that many bars have elapsed).
- The hybrid acceptance test is lookback-limited to the last 80 bars; very long historical basing periods outside that window are not weighted more heavily than recent ones.
- On very low-volatility instruments or during compressed ranges the ATR-scaled thresholds may produce fewer shelves; widening Step Sensitivity is the intended adjustment.
- On very high-volatility or thin-volume symbols the volume confirmation may be dominated by outlier bars; raising Min Volume Confirmation × is the intended adjustment.
- The script does not repaint confirmed shelves, but state transitions (Held → Broken → Reclaimed) evaluate the last three to five bars, so fresh transitions can flip until those bars close.
- Ladder state and Integrity reflect only shelves within the proximity gate. Distant historical shelves exist in memory but are not counted.
---
## Risk Disclosure
This script is a structural visualization tool provided for educational and analytical purposes. It is not financial advice, not a trading strategy, and not a signal service. Past market behavior is not indicative of future results. All trading involves risk of loss. Users are responsible for their own decisions and for verifying the tool's behavior on their chosen instruments and timeframes before relying on it.
Wskaźnik Pine Script®






















