OPEN-SOURCE SCRIPT
Aggiornato AG Pro Volume Profile Acceptance Ladder [AGPro Series]
AG Pro Volume Profile Acceptance Ladder [AGPro Series]
Overview / What it does
AG Pro Volume Profile Acceptance Ladder is a volume-structure indicator designed to monitor whether price is building acceptance, holding acceptance, or losing acceptance inside a rolling volume-defined band. Instead of treating volume profile as a static reference snapshot, this script tracks acceptance as a progressive process. The goal is not to predict where price must go next, but to help the user read whether the market is spending enough time and participation inside a value zone to justify calling that area accepted.
The script builds a rolling profile window, estimates the active acceptance band, and then classifies current behavior into states such as Probe, Build, Accept, Shift Watch, Shift Confirmed, and Fail. This creates a ladder-style framework for reading when the market is stabilizing within one value region and when that acceptance may be migrating toward another region. In practice, that makes it useful for users who want a structured way to distinguish temporary interaction from more durable volume-based acceptance.
A key design goal of this script is to separate acceptance progression from simple attraction-to-level logic. Some tools are built around whether price is pulled back toward a reference such as a POC or another central level. This script focuses on a different question: is the market actually building and holding acceptance inside a rolling value zone, and is that acceptance stable enough to be treated as an active auction area rather than a temporary touch.
Because of that framing, the indicator is best read as a market-structure context tool. It maps an evolving acceptance zone, estimates a directional ladder bias, and provides state transitions that can be used to organize chart reading, scenario planning, or alert workflows. It is not an execution engine, not a broker-grade order book product, and not a substitute for independent trade management.
Unique Edge
The distinguishing feature of this script is that it treats acceptance as a staged process rather than a single level event. The output is not limited to a profile center or a value-area drawing. Instead, the script evaluates how price behaves relative to a rolling volume-defined band and converts that behavior into a progression model.
That matters because a market can interact with a value area in very different ways. It can briefly probe it, begin building around it, hold it in a more stable manner, shift acceptance upward or downward, or fail to maintain acceptance altogether. By organizing those conditions into a ladder of states, the script attempts to make the auction process easier to read in real time.
This also makes the indicator materially different from a standard POC-centered interpretation. The emphasis here is not on magnetic pull toward one volume reference. The emphasis is on whether acceptance is forming, strengthening, or migrating. In that sense, the script is better understood as an acceptance progression map than as a simple volume anchor display.
Methodology
The script uses a rolling lookback window and distributes bar-based volume across a defined number of bins in order to approximate a local volume profile. From that rolling profile it derives the active central reference, the current acceptance band, and the relative participation of that band within the profile window.
Using those profile components, the script calculates several internal measures. These include how often price remains inside the band over a recent hold window, how often price re-enters the band after leaving it, how stable the band center is relative to recent values, and whether the active center appears to be migrating in a meaningful way. These measures are then blended into an aggregate acceptance score and a ladder bias.
The state engine uses those components to classify behavior into the following progression states:
- Reject
- Probe
- Build
- Accept
- Shift Watch
- Shift Confirmed
- Fail
These states should not be read as guarantees of continuation or reversal. They are condition labels describing how the script currently interprets interaction with the active acceptance band.
Signals & Alerts
The script includes deterministic state-based alerts so users can build workflows around changes in acceptance conditions.
Available alert events:
- Acceptance Building
- Acceptance Confirmed
- Upward Ladder Migration Confirmed
- Downward Ladder Migration Confirmed
- Acceptance Failed
- Acceptance Lost
These alerts are designed to reflect state transitions inside the indicator logic. They do not imply expected profitability, win rate, or directional certainty.
Key Inputs
- Profile Window: Defines the rolling lookback used for the local profile estimate.
- Bin Count: Controls the profile resolution.
- Value Area %: Defines how much of the rolling profile volume is used to construct the active acceptance band.
- Migration Sensitivity: Controls how easily the script classifies center shifts as migration activity.
- Probe Band Multiplier: Expands the outer interaction zone around the active acceptance band.
- Hold Lookback: Defines the window used for hold and re-entry style calculations.
- Theme / Panel Location / Panel Font Size / Label Font Size: Presentation controls for chart readability.
- Show Previous Acceptance Band / Show State Markers / Forward Extension Bars: Visual controls for context and labeling.
Limitations & Transparency
This script does not use exchange-native tick-by-tick volume profile data. It uses a bar-based approximation built from the information available to Pine Script on the chart. As a result, the acceptance band and profile structure shown by the indicator should be interpreted as a model of local volume distribution, not as a perfect reconstruction of exchange-level auction detail.
The ladder states are also model outputs, not objective market facts. Small changes in lookback, resolution, or volatility regime can influence how the script classifies the same area. Users should therefore treat the states as structured analytical context rather than as standalone instructions.
The indicator is also not intended to replace broader market analysis. Trend structure, liquidity conditions, volatility regime, higher-timeframe context, and instrument-specific behavior can all affect how useful an acceptance reading is in practice.
Risk Disclosure
This script is for chart analysis and educational use only. It does not provide financial advice, investment advice, or trade recommendations. All markets involve risk, and no indicator can guarantee outcome, timing, or future performance. Users should apply independent judgment, test settings carefully, and use risk management appropriate to their own methodology.
What this script is not
- It is not a promise of continuation or reversal.
- It is not a broker-grade volume profile engine.
- It is not a substitute for execution planning or risk control.
- It is not a claim that acceptance automatically leads to trend persistence.
Overview / What it does
AG Pro Volume Profile Acceptance Ladder is a volume-structure indicator designed to monitor whether price is building acceptance, holding acceptance, or losing acceptance inside a rolling volume-defined band. Instead of treating volume profile as a static reference snapshot, this script tracks acceptance as a progressive process. The goal is not to predict where price must go next, but to help the user read whether the market is spending enough time and participation inside a value zone to justify calling that area accepted.
The script builds a rolling profile window, estimates the active acceptance band, and then classifies current behavior into states such as Probe, Build, Accept, Shift Watch, Shift Confirmed, and Fail. This creates a ladder-style framework for reading when the market is stabilizing within one value region and when that acceptance may be migrating toward another region. In practice, that makes it useful for users who want a structured way to distinguish temporary interaction from more durable volume-based acceptance.
A key design goal of this script is to separate acceptance progression from simple attraction-to-level logic. Some tools are built around whether price is pulled back toward a reference such as a POC or another central level. This script focuses on a different question: is the market actually building and holding acceptance inside a rolling value zone, and is that acceptance stable enough to be treated as an active auction area rather than a temporary touch.
Because of that framing, the indicator is best read as a market-structure context tool. It maps an evolving acceptance zone, estimates a directional ladder bias, and provides state transitions that can be used to organize chart reading, scenario planning, or alert workflows. It is not an execution engine, not a broker-grade order book product, and not a substitute for independent trade management.
Unique Edge
The distinguishing feature of this script is that it treats acceptance as a staged process rather than a single level event. The output is not limited to a profile center or a value-area drawing. Instead, the script evaluates how price behaves relative to a rolling volume-defined band and converts that behavior into a progression model.
That matters because a market can interact with a value area in very different ways. It can briefly probe it, begin building around it, hold it in a more stable manner, shift acceptance upward or downward, or fail to maintain acceptance altogether. By organizing those conditions into a ladder of states, the script attempts to make the auction process easier to read in real time.
This also makes the indicator materially different from a standard POC-centered interpretation. The emphasis here is not on magnetic pull toward one volume reference. The emphasis is on whether acceptance is forming, strengthening, or migrating. In that sense, the script is better understood as an acceptance progression map than as a simple volume anchor display.
Methodology
The script uses a rolling lookback window and distributes bar-based volume across a defined number of bins in order to approximate a local volume profile. From that rolling profile it derives the active central reference, the current acceptance band, and the relative participation of that band within the profile window.
Using those profile components, the script calculates several internal measures. These include how often price remains inside the band over a recent hold window, how often price re-enters the band after leaving it, how stable the band center is relative to recent values, and whether the active center appears to be migrating in a meaningful way. These measures are then blended into an aggregate acceptance score and a ladder bias.
The state engine uses those components to classify behavior into the following progression states:
- Reject
- Probe
- Build
- Accept
- Shift Watch
- Shift Confirmed
- Fail
These states should not be read as guarantees of continuation or reversal. They are condition labels describing how the script currently interprets interaction with the active acceptance band.
Signals & Alerts
The script includes deterministic state-based alerts so users can build workflows around changes in acceptance conditions.
Available alert events:
- Acceptance Building
- Acceptance Confirmed
- Upward Ladder Migration Confirmed
- Downward Ladder Migration Confirmed
- Acceptance Failed
- Acceptance Lost
These alerts are designed to reflect state transitions inside the indicator logic. They do not imply expected profitability, win rate, or directional certainty.
Key Inputs
- Profile Window: Defines the rolling lookback used for the local profile estimate.
- Bin Count: Controls the profile resolution.
- Value Area %: Defines how much of the rolling profile volume is used to construct the active acceptance band.
- Migration Sensitivity: Controls how easily the script classifies center shifts as migration activity.
- Probe Band Multiplier: Expands the outer interaction zone around the active acceptance band.
- Hold Lookback: Defines the window used for hold and re-entry style calculations.
- Theme / Panel Location / Panel Font Size / Label Font Size: Presentation controls for chart readability.
- Show Previous Acceptance Band / Show State Markers / Forward Extension Bars: Visual controls for context and labeling.
Limitations & Transparency
This script does not use exchange-native tick-by-tick volume profile data. It uses a bar-based approximation built from the information available to Pine Script on the chart. As a result, the acceptance band and profile structure shown by the indicator should be interpreted as a model of local volume distribution, not as a perfect reconstruction of exchange-level auction detail.
The ladder states are also model outputs, not objective market facts. Small changes in lookback, resolution, or volatility regime can influence how the script classifies the same area. Users should therefore treat the states as structured analytical context rather than as standalone instructions.
The indicator is also not intended to replace broader market analysis. Trend structure, liquidity conditions, volatility regime, higher-timeframe context, and instrument-specific behavior can all affect how useful an acceptance reading is in practice.
Risk Disclosure
This script is for chart analysis and educational use only. It does not provide financial advice, investment advice, or trade recommendations. All markets involve risk, and no indicator can guarantee outcome, timing, or future performance. Users should apply independent judgment, test settings carefully, and use risk management appropriate to their own methodology.
What this script is not
- It is not a promise of continuation or reversal.
- It is not a broker-grade volume profile engine.
- It is not a substitute for execution planning or risk control.
- It is not a claim that acceptance automatically leads to trend persistence.
Note di rilascio
UPDATE NOTES - V1.2This update focuses on visual presentation, chart readability, and cleaner state communication.
What was refined:
- Cleaned minor visual artifacts from the prior display so the chart reads more smoothly.
- Refined the acceptance ladder presentation so the band structure is easier to read at a glance.
- Improved internal hierarchy inside the active band to better separate the core area from the wider acceptance region.
- Polished the right-side state label for stronger readability and more balanced chart presence.
- Improved marker presentation so acceptance-related events are easier to spot without dominating the chart.
- Tightened the overall visual language so the panel, band, center line, and markers feel more consistent as one tool.
What did not change:
- The script is still designed to organize price behavior around a rolling volume-profile acceptance band.
- The overall acceptance workflow remains the same: Probe, Build, Accept, Shift Watch, Shift Confirmed, Reject, and Fail.
- This update does not reframe the script as a prediction engine or standalone trade system.
- Documented alert conditions and the script’s core analytical purpose remain aligned with the existing workflow.
Why this update matters:
The goal of this revision is to make the acceptance ladder easier to read in live chart conditions while preserving the script’s original purpose. The chart should now look cleaner, more intentional, and more usable without adding unnecessary visual noise.
As always, this tool is intended for structured chart analysis and context-building. It should be used together with broader market structure, risk management, and user judgment.
Note di rilascio
Update Notes - V1.1This update refines the visual structure and presentation of the script while keeping the core acceptance ladder concept intact.
What changed:
- Reworked the panel layout to match the current AG Pro presentation standard.
- Updated the panel header into a single merged title row for a cleaner top-level read.
- Set the panel default font size to Small and the label default size to Normal.
- Improved panel contrast and row hierarchy for better readability in live chart conditions.
- Refined the ladder band presentation with a more structured inner layering model.
- Softened the zone intensity and line pressure so candles remain easier to read.
- Added a cleaner migration readout to improve state interpretation.
- Polished the overall visual balance to create a more consistent and premium chart presence.
Notes:
- This update is focused on clarity, structure, and usability.
- The script remains an analytical tool and should be used with chart context and risk management.
- No outcome, profitability, or trade performance is implied by this update.
Note di rilascio
UPDATE NOTES - V2.0This update turns Volume Profile Acceptance Ladder into a cleaner and more expressive auction-read tool while keeping the core idea intact: track how acceptance is built, held, and migrated inside one rolling volume-defined band.
What changed
- The public indicator title now follows the current AGPro release standard: the AG Pro prefix was removed from the TradingView title, while the panel title still keeps AG Pro branding.
- The visual language was rebuilt around the AGPro palette so the band hierarchy, panel, and markers read as one premium overlay instead of separate parts.
- The upper and lower ladder shelves now react to shelf-pressure bias, which makes it easier to see whether acceptance is leaning into the upper step, lower step, or staying balanced.
- Upward and downward migration confirmations now use separate chart markers, which makes directional ladder shifts more obvious at a glance.
- The live state label now sits outside the active band by default, reducing candle overlap and improving screenshot quality.
- Inputs were refreshed with professional English tooltips and cleaner defaults for panel sizing, label sizing, and extension distance.
- The panel keeps the required merged blue header row and now highlights Shelf Bias alongside Acceptance, Stability, and Migration quality.
What did not change
- The script is still a rolling volume-profile acceptance tool, not a POC magnet model, not a higher-timeframe overlay, and not a price-time acceptance map.
- The state ladder remains centered on Probe, Build, Accept, Shift Watch, Shift Confirmed, Reject, and Fail.
- The engine still uses a bar-based local volume profile approximation available inside Pine.
Why this update matters
The goal of this revision is to make the ladder easier to notice, easier to read, and more distinct within the AGPro public library. Instead of acting like another POC-centered overlay or another generic migration band, this version stays focused on staged acceptance progression inside a single active auction band and adds a clearer internal shelf read for live chart interpretation.
Note di rilascio
UPDATE NOTES - v2.2This update focuses on readability and decision clarity.
The core purpose of the script remains unchanged.
This release improves how the existing acceptance, shelf, and migration logic is
presented, organized, 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
------------------------
- Conflict-aware Next Action
When price is accepted but the short-term shelf bias points against the
broader value-migration direction, the Next Action line now flags it as a
counter-trend read (for example Counter-Bounce Long - Value Firm) instead of a
clean directional hold. When shelf bias and migration align, it still reads as
a straight Hold Long Bias / Hold Short Bias. This keeps the readout honest
about when an in-band move is working with the larger drift versus against it.
- Tidied settings
Removed an unused spacing input that no longer affected any output, leaving a
cleaner and more focused settings panel.
- Badge clearance over live candles
The live state badge is now anchored a fixed step into the forward projection
and grows away from price, so its body no longer overlaps the most recent
candles at any zoom level. The small pointer keeps it visually tied to the
acceptance band it describes.
- Next Action readout
The panel now includes a plain-language Next Action line that translates the
current acceptance state, shelf bias, and price position into a single
suggested response (for example Hold Long Bias - Value Firm, Follow - Value
Shifting Up, Watch - Value Shift Forming, Watch Reversion - Above Value, or
Trade Range - Value Accepted). It turns the existing scores into a clear
at-a-glance read of how the auction is behaving right now.
- Centered acceptance badge
The live state label is now a single compact badge centered inside the active
acceptance band, placed in the forward projection. This fixes the previous
right-edge label that could be clipped at the chart border, and keeps the badge
attached to the band it describes.
- Adaptive text color
The State cell, the Next Action cell, and the on-chart badge now select their
text color automatically from the background brightness, so the readouts stay
legible across every state color and both themes.
- Panel labelling
Panel rows were reordered so the Next Action sits directly under the header,
followed by the State and the supporting acceptance, shelf, and migration
metrics.
------------------------
Visual Improvements
------------------------
- Improved chart readability by centering the state badge in the active band
instead of anchoring it at the right edge.
- Reduced the chance of a clipped or hard-to-read label at the chart border.
- Refined visual hierarchy so the state and the suggested response are the first
things the eye lands on.
- Adjusted badge positioning into the forward projection to avoid overlap with
candles.
------------------------
Interface & Usability
------------------------
- Optimized panel layout with a dedicated Next Action row for clearer
information flow.
- Improved badge readability and adaptive contrast for cleaner chart interaction.
- Adjusted default visual settings for a more balanced first-glance appearance.
- Enhanced overall user experience without changing core logic.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The rolling volume profile, value-area construction, acceptance scoring, shelf
pressure, and migration states all behave exactly as before. The Next Action line
is a plain-language summary of those existing outputs; it is not a new signal
layer.
Users should interpret outputs the same way as before, but with improved visual
structure and a clearer suggested response.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how value forms and how acceptance and migration read.
Outputs and the Next Action line 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.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.