Supply Demand Flip Matrix [AGPro Series]

🧠 Core Idea
When a supply or demand zone changes role, is the market accepting the flip, rejecting it, or making the zone inactive?
📌 Overview / What it does
Supply Demand Flip Matrix [AGPro Series] is a structured supply-and-demand role-transition workflow designed to map active zones, flip acceptance, rejection pressure, invalidation, and current flip quality directly on the chart.
The script focuses on the behavior that happens after a supply or demand zone starts behaving differently from its original role. Instead of only drawing static zones, it organizes the transition process into readable states such as zone watch, flip accepted, rejection, and zone inactive.
It does not attempt to predict price direction, automate decisions, or provide financial advice. Its purpose is to help users read supply-demand context with clearer visual structure and a dedicated workflow panel.
🎯 Purpose & Design Philosophy
This script was built for traders who want more than a basic supply and demand box.
Traditional supply-demand tools often mark zones and leave the user to manually decide whether the zone is still valid, accepted, rejected, or structurally inactive. Supply Demand Flip Matrix adds a decision-support layer around that process.
The goal is to support disciplined chart review by separating zone existence from zone behavior. A zone being visible is not enough; the key question is how price interacts with that zone after contact, rejection, acceptance, or role transition.
⚡ Why This Script Is Different
Most supply and demand tools focus on drawing zones.
This script does NOT treat every zone touch as the same event.
Instead, it evaluates whether the active zone is still being watched, whether price is accepting the flip, whether rejection pressure is building, whether invalidation has appeared, and whether the current zone context is becoming inactive.
The result is a cleaner workflow for supply-demand role transitions rather than a simple zone marker.
⚙️ Methodology
1. Context Detection
The script identifies qualified supply or demand source areas using structure, displacement, wick behavior, and local context.
2. Zone Mapping
A live zone is projected forward so the user can track whether price is interacting with the active supply-demand reference.
3. Flip Evaluation
The script evaluates acceptance and rejection behavior around the zone boundary to determine whether a role transition is building or confirmed.
4. Invalidation Review
If price behavior weakens the active zone context, the script raises invalidation or inactive-zone review states.
5. Visual Output
Zones, labels, and panel values are organized into a compact workflow so the current state can be interpreted quickly.
🗺️ How to Read the Chart
Zones represent the active supply or demand area being evaluated.
Labels mark key workflow states such as acceptance, rejection, flip accepted, inactive, or current review.
Colors separate the role and state:
• Teal tones highlight constructive demand-side or accepted behavior
• Pink tones highlight supply-side or opposing role behavior
• Yellow tones highlight watch or review states
• Red tones highlight rejection, invalidation, or inactive pressure
• Indigo tones highlight acceptance context
The panel summarizes the same workflow in a compact command-center format, including role side, zone range, flip state, acceptance, rejection, invalidation, flip score, and next action.
🚦 Signals & States
• Zone Watch -> the active zone is being monitored for reaction or transition behavior
• Acceptance -> price behavior is showing acceptance around the zone context
• Flip Accepted -> the zone has begun behaving as a role-transition reference
• Rejection -> price is responding against the attempted flip context
• Zone Inactive -> the active zone context has lost validity under the script rules
• Current Review -> the latest active state summarized near the current chart area
These states are analytical markers, not trade instructions.
🔔 Alerts Logic
Alerts are designed as attention markers.
They can trigger when a new zone appears, when acceptance develops, when rejection pressure appears, when a flip becomes accepted, when invalidation pressure is detected, or when the workflow state changes.
Alerts do not instruct the user to enter, exit, buy, sell, or hold. They only notify the user that a specific chart condition requires review.
🧩 Confluence Logic
The strongest contexts usually appear when several elements align:
• A clear supply or demand source zone
• Clean interaction with the active zone
• Acceptance or rejection behavior near the role boundary
• Low invalidation pressure
• A flip score that supports the current state
The script combines these elements into a single workflow view so the user can evaluate the situation without relying on a single visual event.
📊 When to Use
This script is best suited for:
• Supply and demand zone review
• Role reversal and flip analysis
• Price action structure review
• Retest and reaction workflows
• Multi-timeframe chart study
• Markets where clean structure and zone behavior are visible
⚠️ When NOT to Use
Avoid relying on this script in isolation during:
• Extremely illiquid markets
• Very noisy low-timeframe conditions
• Major news-driven volatility
• Thin order book environments
• Charts with inconsistent price history
• Situations where broader market context is unclear
The script is strongest when used as part of a structured chart review process.
🎛️ Key Inputs
• Reaction Mode -> controls whether the workflow evaluates both sides, demand only, or supply only
• Lookback -> adjusts the structure and zone measurement window
• Sensitivity -> controls how strict the source-zone qualification should be
• Zone Width Model -> changes how wide the active zone is drawn
• Acceptance Strictness -> controls how demanding the flip-acceptance logic is
• Rejection Strictness -> controls how quickly rejection pressure increases
• Projection Bars -> controls how far the active zone is projected to the right
• Visual Preset -> adjusts chart annotation density
• Label Font Size -> controls chart label readability
• Panel Location / Theme / Font Size -> customizes the workflow panel
🖥️ Interface & Visual Design
The interface is designed to make the active supply-demand story visible without turning the chart into a cluttered signal board.
The panel uses a single blue AGPro header row, alternating rows, and color-coded values to separate role side, state, pressure, and score.
The chart visuals focus on one active zone, supporting historical state labels, and a current review label so the user can understand both the present context and recent workflow behavior.
🧪 Practical Usage Workflow
1. Start with the panel and identify the current role side.
2. Check the active zone range on the chart.
3. Review whether price is showing acceptance, rejection, or inactivity.
4. Compare the flip score with the current state.
5. Use the current review label to understand the latest workflow context.
6. Confirm broader market structure before making any independent decision.
🔍 Interpretation Guidelines
A visible zone is not automatically meaningful by itself.
The important question is whether price is accepting the zone, rejecting it, or invalidating the role-transition idea. The panel and labels should be read together.
Higher flip scores indicate stronger alignment inside the script’s rules, but they do not guarantee any future outcome. Lower scores suggest that the zone context may require more caution or additional confirmation.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not an auto-trading system.
It is not financial advice.
It does not guarantee profitable outcomes.
It does not replace personal analysis, risk management, or broader market review.
⚠️ Limitations & Transparency
Supply-demand behavior can change quickly across different timeframes.
A zone that looks clean on one timeframe may be noisy or less meaningful on another. Volatility, liquidity, spread, and session behavior can also affect how the workflow states appear.
The script uses rule-based logic. It cannot understand external news, macro events, hidden order flow, or trader intent.
🧠 Market Context Notes
Supply and demand zones are most useful when interpreted inside broader structure.
A flip zone can become more meaningful when it aligns with trend context, volatility behavior, prior reactions, or a clear structural transition. Weak or isolated zones should be reviewed with more caution.
🧾 Use Case Examples
When price returns to a demand area and begins to hold above the zone boundary, the script may show acceptance or flip-accepted behavior.
When price fails to maintain the role transition and moves back through the zone, the script may show rejection or inactive-zone context.
When the current state remains in zone watch, the workflow is still waiting for cleaner behavior.
🧱 System Philosophy
Supply Demand Flip Matrix is built as a workflow tool, not a one-click signal tool.
Its role is to organize supply-demand role transitions into readable steps: source zone, active role, acceptance, rejection, invalidation, score, and next-action context.
🔐 Non-Promise Statement
No script can provide certainty.
This tool provides structured visual context based on predefined rules. It does not guarantee direction, timing, accuracy, or outcome.
📉 Risk Disclosure
Trading and investing involve risk.
All outputs from this script are for educational and analytical purposes only. Users are responsible for their own decisions, risk controls, and interpretation of market conditions.
📚 Educational Note
Use this script to study how supply and demand zones behave after contact, transition, acceptance, rejection, or invalidation.
The most valuable use is not simply seeing a zone, but learning how the zone’s role changes over time.
This update focuses on chart readability, active-zone clarity, and supply-demand role-transition interpretation.
The core purpose of the script remains unchanged.
This release improves how the existing supply-demand flip workflow 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
------------------------
* Historical label discipline was refined.
State labels now use a higher default score threshold and a longer cooldown window to reduce repeated labels while keeping meaningful flip-context markers visible.
* The active zone badge was upgraded.
The zone label now combines zone role, flip status, acceptance, rejection, flip score, and setup quality in one compact centered label.
* Invalidation context is clearer.
The script now includes an invalidation label with ATR distance when the active role-transition context requires rejection or invalidation review.
* Panel information was expanded.
The panel now includes Bars Active and Setup Quality, helping users evaluate zone age and the overall quality of the current flip workflow.
* State label hierarchy was refined.
Acceptance, rejection, inactive, and accepted states now use more distinct visual treatment for faster chart scanning.
------------------------
Visual Improvements
------------------------
* Improved chart readability by reducing repeated historical state labels.
* Refined the active supply-demand zone label so the main workflow details are grouped in one centered badge.
* Adjusted historical label filtering to reduce overlap with candles.
* Kept the active zone visually readable while making the central role-transition label more informative.
* Preserved the clean AGPro panel header and dark/light panel theme controls.
------------------------
Interface & Usability
------------------------
* Added Bars Active to show how long the current supply-demand zone has been active.
* Added Setup Quality as a composite readability score based on flip score, acceptance, rejection, and source-zone quality.
* Improved active-label information density without changing the core analytical logic.
* Kept panel location, panel theme, panel font size, label font size, and panel visibility controls intact.
------------------------
Behavior Notes
------------------------
This update does not change the core supply-demand flip concept of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure and clearer active-state context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, timeframe differences, and repeated zone interactions may affect how states appear.
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.
This update focuses on chart readability, label clarity, and presentation polish.
The core purpose of the script remains unchanged.
This release improves how the existing 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
------------------------
• Single on-chart decision card
The active status is now shown in one clean card that combines the zone side and flip status, acceptance, rejection, flip score, setup quality, and the current next-step context.
• Removed redundant labels
Earlier versions showed several separate labels (current review, acceptance, rejection) that repeated information already in the panel. These were consolidated to reduce visual noise.
• Cleaner invalidation label
The invalidation-distance label now appears on its own marker once a role flip occurs, clearly separated from the main card on every timeframe.
• Adaptive label text contrast
Label text now adjusts automatically for readability across all state colors, including lighter backgrounds.
• Internal cleanup
Removed unused code paths for a lighter, faster script.
------------------------
Visual Improvements
------------------------
• Improved chart readability by consolidating status into one card
• Reduced visual clutter and removed overlapping labels
• Refined visual hierarchy so the card and the invalidation level stand out clearly
• Adjusted positioning to avoid overlap with candles and between labels on all timeframes
------------------------
Interface & Usability
------------------------
• Clearer information flow between the panel and the on-chart card
• Improved label text contrast for easier reading on every state color
• Kept a balanced default annotation density for a clean, premium appearance
• Enhanced overall readability without changing core logic
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Zone detection, flip acceptance, rejection, invalidation, scoring, and states behave the same as before, presented with improved visual structure.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how labels and zones appear.
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.
This update focuses on proof and decisiveness: adding a Flip Follow Rate layer
that shows how often past role flips actually carried price in the flip
direction, and making the next-action readout speak in clear trade decisions.
The core purpose of the script remains unchanged. It still maps active
supply-demand zones, flip acceptance, rejection pressure, invalidation, flip
quality and a next-action context.
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
------------------------
- Flip Follow Rate proof layer
A new panel row reports the historical follow rate of the role flips on the
chart: the share of past flips after whose confirmation price traveled one
anchor-ATR in the flip direction before closing back through the far edge of the
zone, with the sample size (n). Each flip is registered once at its confirmation
bar - the first close beyond the zone, the moment the flip is actually visible -
and same-bar conflicts resolve conservatively as failures, so the statistic is
an honest record of how flips on this chart typically resolved. The on-chart
zone label also carries the follow rate once a sample exists.
- Decision-language next action
The Next Action row and the action line on the zone label now speak in trade
decisions - trade the flip, prepare flip entry, wait for acceptance, abort /
stand aside, wait / new zone - instead of generic review prompts.
- Clean numeric readouts
All scores now display as plain numbers in both the panel and the on-chart zone
label. Decorative gauge characters were removed for a cleaner, more professional
read.
- Honest sampling
The Flip Follow Rate row stays greyed until enough flips have resolved to read
it, so a thin sample is never presented as a strong result.
- Clearer invalidation label placement
The invalidation label now keeps additional clearance from thin zones so it no
longer overlaps the zone label or nearby candles.
------------------------
Visual Improvements
------------------------
- Improved panel and zone-label readability with numeric-only score
presentation.
- Reduced visual clutter while keeping the active zone, flip boundary and
history-label limits unchanged.
- Refined visual hierarchy so the verdict, the scores, the proof and the next
action each read clearly at a glance.
------------------------
Interface & Usability
------------------------
- Enhanced overall user experience while keeping panel theme, location and font
size fully adjustable, with the panel shown by default.
- All flip-engine, zone-model, visual and panel settings remain available and
unchanged.
------------------------
Behavior Notes
------------------------
This update adds a flip tracking layer and rewords the next-action readout. The
zone detection, flip logic, scoring, states and labels are unchanged.
The goal is to improve clarity, depth and usability, not to introduce predictive
behavior. The Flip Follow Rate describes how past flips resolved within the
visible history and is not a forecast. Small samples should be read with care.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Flip follow rates vary with timeframe, instrument, zone model and settings. A
favorable reading does not guarantee any individual outcome.
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.
This update focuses on confirmed-zone integrity, per-zone lifecycle accuracy, Flip Follow Rate completeness, and chart readability.
The core purpose of the script remains unchanged.
This release improves how the existing supply-demand role-transition workflow is validated, tracked, 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
------------------------
• Confirmed source-zone registration
New supply-demand zones, workflow changes, and alerts now rely on completed bars. An unfinished realtime candle can no longer temporarily replace the active zone context.
• Authentic pre-zone state
The matrix now remains in AWAITING ZONE until a qualified pivot source has actually been confirmed. It no longer builds a synthetic zone from fallback candle values before the first valid event.
• Independent per-zone lifecycle
Every confirmed source zone now starts with a clean flip lifecycle. A newly detected zone can no longer inherit a flip event that belonged to the previous zone.
• Corrected flip timing
A role flip can begin only after the source zone has been confirmed. The zone-confirmation bar itself can no longer be counted as an immediate flip.
• Persistent inactive state
Once a flipped zone closes through its invalidation edge, that zone remains inactive until a new confirmed source zone replaces it. A failed role transition can no longer reactivate merely because price later crosses back through the zone.
• Stable source-quality baseline
Average body and range references are anchored to the original source candle context when the zone is confirmed. Source quality no longer drifts as later candles change the rolling averages.
• Complete Flip Follow Rate sampling
Confirmed role flips are now tracked independently, including overlapping samples. Each sample resolves through one-ATR follow-through, stored-edge failure, or timeout, with same-bar conflicts handled conservatively.
• Neutral analytical review language
Execution-style phrases were replaced by a Current Review row and context-focused wording. The matrix remains an analytical decision-support tool, not a source of trade instructions.
------------------------
Visual Improvements
------------------------
• Re-centered the active zone card inside the forward projection to reduce overlap with recent candles
• Added a clean AWAITING ZONE presentation when no confirmed source exists
• Clarified invalidation distance with an explicit ATR AWAY suffix
• Replaced the Next Action row with Current Review for a clearer analytical hierarchy
• Corrected Current Review and proof-row contrast for both panel themes
• Preserved the pink supply-role and teal demand-role visual identity
------------------------
Interface & Usability
------------------------
• Preserved the merged blue panel header containing only the script name
• Preserved adjustable panel location, panel theme, panel font size, and label font size
• Preserved Show Panel as enabled by default
• Preserved the existing Clean, Balanced, and Rich visual presets
------------------------
Behavior Notes
------------------------
The pivot qualification, displacement thresholds, zone-width models, acceptance and rejection formulas, score weights, projection controls, and visual concept remain unchanged.
This update corrects confirmation boundaries, lifecycle ownership, invalidation persistence, proof-layer registration, and source-quality anchoring. Flip Follow Rate values and sample sizes may therefore differ from V1.3 because inherited, provisional, or skipped samples are no longer handled by the earlier logic.
Flip Follow Rate remains descriptive evidence from resolved historical samples. It is not a forecast and should be interpreted cautiously when the sample size is small.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, gaps, instrument history, and timeframe differences may affect how source zones, flips, and follow-rate samples appear.
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.
• Refreshed the publication and access routing information.
• Core supply-demand flip logic, panel behavior, inputs, alerts, visuals, and outputs remain unchanged.
This update focuses on evidence clarity, visual hierarchy, and risk-aware chart presentation.
The core purpose of Supply Demand Flip Matrix remains unchanged.
The script continues to map supply-and-demand source zones, role flips, acceptance, rejection pressure, invalidation, and current review context.
This script remains an analytical and visualization tool.
It does not predict price direction, automate execution, or provide guaranteed outcomes.
------------------------
What Changed
------------------------
• Added a confidence-aware Flip Follow Rate layer
The observed follow rate is now accompanied by a 90% Wilson lower confidence bound.
This keeps sample uncertainty visible instead of presenting the raw percentage as certainty.
• Added explicit evidence controls
Follow Target (ATR) defines the distance a confirmed flip must travel to count as followed.
Follow Window (Bars) defines how long the registered flip may take to reach that target.
Expired observations continue to resolve conservatively as not followed.
• Refined the active-zone summary
The centered zone label now uses readable metric names for acceptance, rejection, flip score, quality, observed follow rate, confidence floor, and sample size.
Cryptic single-letter abbreviations were removed.
• Rebuilt invalidation-edge communication
The former permanently red invalidation badge is now a state-sensitive fail-edge reference.
Low pressure uses a neutral presentation, moderate pressure uses a warning color, and elevated or completed invalidation uses the danger state.
• Improved panel state hierarchy
The active Flip State now receives a filled, contrast-aware value cell.
A dedicated 90% Floor row was added without materially widening the panel.
------------------------
Visual Improvements
------------------------
• Improved text contrast across teal, pink, amber, and indigo state colors
• Kept the active workflow label centered inside the projected zone
• Added a thin fail-edge line for faster boundary recognition
• Moved the fail-edge badge to the projected boundary area to reduce candle overlap
• Corrected singular and plural wording for Bars Active
------------------------
Interface & Usability
------------------------
• Added professional English tooltips for both evidence settings
• Preserved adjustable panel location, panel theme, panel visibility, panel font size, label font size, and visual density
• Preserved the compact two-column panel and merged AGPro header
• Replaced action-like wording with analytical review language
------------------------
Behavior Notes
------------------------
The source-zone and role-flip logic remains unchanged.
The historical evidence layer is now explicitly parameterized:
• A flip is registered after its first confirmed close beyond the role boundary
• A follow is recorded when price reaches the selected source-ATR target in the flip direction
• A failure is recorded when price closes through the stored far edge
• An unresolved sample is conservatively recorded as not followed when the selected evidence window expires
• Same-bar follow/failure conflicts resolve conservatively as failures
The 90% Floor is a statistical uncertainty aid, not a probability forecast.
------------------------
Limitations Reminder
------------------------
Supply-and-demand zones are rule-based approximations.
Timeframe, liquidity, volatility, symbol history, parameter choices, and available sample size may materially change the displayed states and evidence statistics.
Historical follow behavior does not guarantee future behavior.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice, automated trading, or guaranteed signals.
Users remain responsible for their own analysis, risk controls, and decisions.
This update refines the premium visual hierarchy of the existing supply-demand role-flip workflow. The core zone qualification, flip acceptance, rejection, invalidation, scoring, evidence, and alert logic remain unchanged.
• Added a dedicated analytical question row beneath the unified blue panel title.
• Centered the active workflow card on the complete projected zone geometry.
• Rebuilt the active card into a concise four-line hierarchy covering role, state, acceptance, rejection, flip score, setup quality, evidence, and current review.
• Connected the displaced fail-edge badge to its exact invalidation boundary with an owned guide.
• Made fail-edge clearance responsive to both zone height and the selected label font size.
• Reframed historical state labels as PRIOR ZONE events and placed them beyond a seven-bar candle cluster for clearer ownership.
• Expanded the panel safely while preserving location, theme, visibility, and font-size controls.
• Preserved the existing seven alert conditions and the full analytical behavior of the script.
The script remains a rule-based analytical and visualization tool. It does not predict price direction, automate trading, provide financial advice, or guarantee outcomes.
Invite-only script
Only users approved by the author can access this script. You'll need to request and get permission to use it. This is typically granted after payment. For more details, follow the author's instructions below or contact AGProLabs directly.
TradingView does NOT recommend paying for or using a script unless you fully trust its author and understand how it works. You may also find free, open-source alternatives in our community scripts.
Author's instructions
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
Disclaimer
Invite-only script
Only users approved by the author can access this script. You'll need to request and get permission to use it. This is typically granted after payment. For more details, follow the author's instructions below or contact AGProLabs directly.
TradingView does NOT recommend paying for or using a script unless you fully trust its author and understand how it works. You may also find free, open-source alternatives in our community scripts.
Author's instructions
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/