INVITE-ONLY SCRIPT
Updated Auto Fib Structure Planner [AGPro Series]
Auto Fib Structure Planner [AGPro Series]
🧠 Core Idea
Which confirmed Fibonacci structure leg has enough quality, reaction, risk geometry, and target room to deserve real planning attention?
📌 Overview / What it does
Auto Fib Structure Planner is a premium Fibonacci market structure planning engine for TradingView. It turns confirmed swing structure into a complete visual planning cockpit with an active Fibonacci framework, decision zone, target band, invalidation reference, readiness score, reaction state, and next-action context.
The script is built for traders who use Fibonacci retracement and extension logic but want more than a set of static lines. It detects the active confirmed structure leg, maps the relevant retracement area, projects the continuation target band, evaluates invalidation distance, reads reaction behavior, and converts the full setup into a 0-100 planning score.
The purpose is not to predict price.
The purpose is to organize the chart.
Instead of manually asking "which swing should I use?", "is this pullback still valid?", "where is the decision zone?", "where is invalidation?", and "does target room still make sense?", the script builds one structured framework and keeps it updated as confirmed market structure changes.
It does not automate trades, does not provide guaranteed outcomes, and does not replace trader judgment. It is a rule-based analytical and educational planning tool.
📸 Chart Examples
Main publication example - Weekly structure view:
Monthly structure example:
Daily structure example:
4H planning example:
1H active review example:
Dark theme example:
🎯 Purpose & Design Philosophy
Most Fibonacci tools draw levels.
That is useful, but it leaves several important questions unanswered:
• Which swing leg is currently driving the framework?
• Is the leg large enough to matter?
• Is the pullback inside a meaningful decision zone?
• Has price reacted from that zone?
• Is the pullback becoming too deep?
• Is invalidation close enough or too wide?
• Is there still enough target room?
• Is the setup fresh, late, invalidated, or already in target review?
Auto Fib Structure Planner was built to answer those questions with a structured decision-support workflow.
The script treats Fibonacci as a planning environment, not as decoration. It combines confirmed swing logic, retracement geometry, extension mapping, ATR context, trend alignment, reaction behavior, reward / risk geometry, and state classification into one chart-first interface.
The design philosophy is simple:
• use confirmed structure
• avoid repaint-style swing guessing
• show the active leg clearly
• highlight the decision zone
• map invalidation visibly
• project target room carefully
• score the structure from 0 to 100
• explain the current state through labels and panel rows
• keep the output premium, readable, and non-hype
This is a planning cockpit, not a magic signal board.
⚡ Why This Script Is Different
Most Fibonacci indicators focus on drawing retracement levels from a selected high and low.
Most signal indicators ignore the structure leg and print directional labels without explaining the plan.
Auto Fib Structure Planner does something different.
It creates a complete Fibonacci structure workflow:
• confirmed swing leg
• active fib framework
• decision zone
• projected target band
• invalidation reference
• reaction state
• readiness score
• target progress
• panel summary
• alert-ready state logic
The script does not ask only:
"Is price bullish or bearish?"
It asks:
• Is the structure leg valid?
• Is the leg large enough relative to ATR?
• Is price still before the pullback zone?
• Is price inside the zone?
• Did price react from the zone?
• Did price move into target review?
• Did price cross invalidation?
• Is the target projection realistic?
• Does the current state deserve planning attention?
That is the difference.
The output is not just a line set. It is a structured planning state.
⚙️ Methodology
1. Confirmed Swing Detection
The script uses confirmed pivot logic to identify meaningful swing highs and lows. The pivot setting controls how many bars must appear on both sides of a swing point before it becomes part of the structure map.
Higher pivot depth creates slower but cleaner swings.
Lower pivot depth creates faster but more sensitive swing updates.
The default is designed for a balanced structure workflow.
2. Wick / Body Swing Source
The script can use wick-based or body-based swing references.
Wick mode captures the full market extreme.
Body mode creates a cleaner close-based structure map.
This allows the user to choose between full-range structure and cleaner structural filtering.
3. Deviation Filtering
Very small alternating pivots can create noisy Fibonacci legs.
The minimum swing deviation filter helps ignore weak pivot changes that do not meaningfully alter the structure.
This keeps the active leg more useful for planning.
4. ATR Leg Quality
The script compares the active leg size against ATR.
This helps identify whether the current leg has enough volatility-adjusted size to matter.
A leg that is too small receives weaker structure quality.
A larger confirmed leg receives stronger structure context.
5. Active Leg Selection
The latest valid confirmed swing pair becomes the active planning leg.
The script determines whether the active plan is a bullish pullback planner or bearish pullback planner based on the direction of the confirmed leg.
This is why the chart always shows an origin swing and confirmation swing.
6. Fibonacci Framework
The engine maps key retracement levels from the active leg.
Default levels focus on the practical planning zone:
• 0
• 0.382
• 0.500
• 0.618
• 0.786
• 1
• extension targets
Optional minor levels can be enabled when the user wants more detail.
7. Decision Zone Mapping
The decision zone is the central planning area.
By default, it is built between 0.500 and 0.786.
This area is not a prediction zone.
It is the region where pullback structure, reaction behavior, invalidation distance, and target room become more important to evaluate.
8. Target Band Projection
The script projects a target band using Fibonacci extension ratios.
The default target band uses:
• 1.272 extension
• 1.618 extension
The target band is a planning reference.
It is not a forecast.
V3.2 and V3.3 include additional safety behavior for extreme higher-timeframe cases. If an extension target becomes invalid or impractical for a spot-market chart, the script avoids drawing unrealistic target bands and communicates the condition in the panel.
9. Invalidation Reference
Invalidation is derived from the origin swing plus an ATR buffer.
This creates a structural reference for the active plan.
It is not a stop-loss recommendation.
It is a planning boundary that helps the user understand when the current structure no longer fits the active framework.
10. Reaction Evaluation
The script checks whether price interacted with the decision zone and whether meaningful reaction behavior appeared afterward.
Reaction logic can include:
• candle body strength
• movement away from the decision zone
• close behavior
• relationship with trend context
This is used as part of the readiness model and state classification.
11. Trend Context
Fast and slow EMAs are used to evaluate whether the active Fibonacci plan is aligned with broader directional context.
The EMAs do not create standalone trade signals.
They are one component of the 0-100 readiness framework.
12. Reward / Risk Geometry
The script compares the available target room against the invalidation distance.
This helps distinguish a structure that looks interesting from a structure that has inefficient planning geometry.
Reward / risk is displayed in the panel and contributes to the readiness model.
13. Readiness Score
The final 0-100 readiness score combines:
• structure leg quality
• leg freshness
• decision-zone position
• trend alignment
• reaction behavior
• reward / risk geometry
The score does not guarantee outcome.
It only summarizes how well the current structure fits the script's planning model.
14. State Conversion
The script converts the underlying model into readable states such as:
• WAIT STRUCTURE
• WAIT PULLBACK
• WATCH REACTION
• PLAN READY
• TARGET WATCH
• TARGET HIT
• DEEP PULLBACK
• INVALIDATION WATCH
• INVALIDATED
These states are designed to help the user classify context quickly.
🗺️ How to Read the Chart
Active Swing Leg:
The diagonal line connects the origin swing and the confirmation swing used by the current Fibonacci framework.
This is the structure leg that drives the script.
Origin Label:
The origin label marks the swing where the active leg began.
For bullish plans, this is usually an origin low.
For bearish plans, this is usually an origin high.
Confirmation Label:
The confirmation label marks the swing that completed the active leg.
This helps the user see why the current Fibonacci framework exists.
Fib Levels:
The horizontal fib labels identify key retracement and extension references.
They are placed to the right side of the active structure so the chart remains readable.
Decision Zone:
The colored rectangle marks the main Fibonacci pullback decision area.
The centered badge identifies the ratio range.
Default:
0.500 - 0.786
Target Band:
The target band shows the projected extension area.
The centered target badge identifies the extension range.
Default:
1.272 - 1.618
If the extension projection becomes invalid or impractical, the script avoids drawing an unrealistic band.
Invalidation Line:
The dashed invalidation line marks the structural boundary for the active plan.
It is a planning reference, not a trading instruction.
Action Label:
The action label near price shows the current state and readiness score.
Examples:
• WAIT PULLBACK
• TARGET WATCH
• INVALIDATED
• PLAN READY
Event Labels:
Event labels mark important state changes such as:
• new bull / bear plan
• decision-zone touch
• reaction confirmation
• target progress
• invalidation
The default label density is intentionally controlled so the chart stays active but not crowded.
Panel:
The panel is the fastest way to read the script.
It summarizes:
• Readiness
• Next Action
• Structure
• Decision Zone
• Invalidation
• Targets
• Reward / Risk
• Context
The top row uses the standard AGPro blue merged header.
🚦 Signals & States
• WAIT STRUCTURE → no qualified confirmed swing framework is active yet
• WAIT PULLBACK → structure exists, but price has not yet reached the decision area
• WATCH REACTION → price is inside or near the decision zone and reaction behavior should be observed
• PLAN READY → readiness score reached the selected threshold while price is in the decision area
• TARGET WATCH → price reacted or progressed enough for target-room monitoring
• TARGET HIT → the projected target reference was reached
• DEEP PULLBACK → retracement moved beyond the configured deep-pullback warning level
• INVALIDATION WATCH → price moved beyond the preferred decision range and closer to invalidation risk
• INVALIDATED → price crossed the structural invalidation reference
These are analytical states.
They are not buy or sell instructions.
🔔 Alerts Logic
The script includes alert conditions for:
• New Auto Fib Structure Plan
• Fib Decision Zone Touch
• Fib Plan Reaction Confirmed
• Fib Target One Reached
• Fib Target Band Completed
• Fib Plan Invalidated
Alerts can be restricted to confirmed bars.
This supports a cleaner workflow for users who do not want intrabar noise.
Alerts are attention markers.
They are not trade instructions, automation signals, or guaranteed outcomes.
🧩 Confluence Logic
The active structure becomes more meaningful when multiple elements align:
• confirmed swing leg
• sufficient leg size
• price enters the decision zone
• reaction behavior appears
• trend context supports the leg direction
• invalidation is not too wide
• target room remains available
• readiness score improves
The script does not treat any single element as enough by itself.
Its value comes from combining structure, geometry, reaction, and context.
📊 When to Use
Auto Fib Structure Planner is most useful when:
• a market has visible swing structure
• price is pulling back within a confirmed leg
• higher-timeframe planning matters
• continuation structure is being reviewed
• invalidation and target room need to be visible
• a trader wants a repeatable Fibonacci workflow
• the chart has enough history for meaningful swing confirmation
Recommended review timeframes:
• 1H for active short-term structure
• 4H for cleaner swing planning
• Daily for broader structure review
• Weekly for main publication-style structure context
• Monthly for macro structure inspection
⚠️ When NOT to Use
The script may be less useful during:
• extremely low liquidity
• chaotic news-driven candles
• very tight sideways chop
• markets with poor historical data
• instruments where Fibonacci structure has no visible relevance
• timeframes that are too low for the selected pivot depth
• conditions where spreads and execution risk dominate structure quality
The script is not designed to force a plan on every chart.
Sometimes the correct output is simply to wait.
🎛️ Key Inputs
Structure Pivot Depth:
Controls how many bars are required on each side of a confirmed swing point.
Higher values create slower but cleaner structure.
Use Wicks For Swings:
When enabled, swing highs and lows use full candle wicks.
When disabled, the script uses candle bodies for a cleaner close-based structure map.
Minimum Swing Deviation %:
Filters very small pivot changes that do not meaningfully change structure.
Minimum Leg Size ATR:
Requires the active leg to be large enough relative to ATR.
This helps avoid weak Fibonacci frameworks based on tiny moves.
Confirmed Bars Only:
Keeps the engine focused on confirmed pivot behavior.
This supports a cleaner non-repainting planning workflow.
Decision Zone Lower / Upper Ratio:
Controls the Fibonacci retracement area used as the main decision zone.
Default:
0.500 to 0.786
Target Band Start / End Extension:
Controls the extension area used for target-band projection.
Default:
1.272 to 1.618
Plan Zone Extension Bars:
Controls how far the decision zone and target band extend to the right.
V3.3 adds automatic higher-timeframe protection:
• monthly charts cap forward projection at 24 bars
• weekly charts cap forward projection at 52 bars
• intraday and daily charts continue to use the configured value
Invalidation Buffer ATR:
Adds a volatility buffer beyond the origin swing before the plan is considered invalidated.
Fast / Slow Context EMA:
Used for trend alignment scoring.
They are not standalone signals.
Plan Ready Threshold:
Minimum readiness score required for PLAN READY state.
Deep Pullback Warning Ratio:
Defines when a pullback becomes deep enough to shift the state toward risk review.
Reaction Body ATR Filter:
Minimum candle body size used to help qualify reaction behavior.
Good Reward / Risk Level:
Reward / risk level used inside the readiness model.
Visual Mode:
Controls the visual intensity of lines, zones, and emphasis.
Label Settings:
Control event label density, font size, and ATR-based label spacing.
Panel Settings:
Control panel visibility, location, theme, and font size.
Alert Settings:
Enable or disable alert conditions and confirmed-bar alert behavior.
🖥️ Interface & Visual Design
Auto Fib Structure Planner is designed around chart clarity.
The main hierarchy is:
1. active structure leg
2. decision zone
3. invalidation reference
4. target band
5. action label
6. panel summary
The visual system uses the AGPro palette:
• teal / green for bullish planning context
• pink for bearish planning context
• indigo / blue for target and extension references
• amber for neutral fib references
• deep panel colors for dashboard readability
Zone and band labels use colored badge backgrounds so they remain readable on both dark and light chart themes.
The panel uses a compact professional layout with a blue merged header row.
🧪 Practical Usage Workflow
1. Start with the panel
Read:
• Readiness
• Next Action
• Structure
• Reward / Risk
• Context
2. Confirm the active leg
Check whether the origin and confirmation swing match the structure you want to study.
3. Review the decision zone
Ask:
• Is price before the zone?
• Inside the zone?
• Already through the zone?
• Reacting from the zone?
4. Check invalidation
Compare current price with the invalidation reference.
If invalidation is too close or already crossed, the plan should be interpreted differently.
5. Check target room
Look at the projected target band and reward / risk row.
If target room is weak or out of range, the plan may not have useful geometry.
6. Watch state transitions
Use labels and alerts to understand when the framework moves from waiting to reaction, target review, or invalidation.
7. Compare timeframes
The same chart can look different on 1H, 4H, daily, weekly, and monthly.
Use higher timeframes for structure context and lower timeframes for active review.
🔍 Interpretation Guidelines
A higher readiness score means the current structure fits the script's rule-based planning model better.
It does not mean price must continue.
A decision-zone touch means price interacted with the mapped Fibonacci pullback area.
It does not mean a reversal or continuation is guaranteed.
Reaction confirmation means the script detected meaningful movement away from the decision zone.
It does not mean the move will continue.
Invalidated means the current framework no longer fits the active plan logic.
It does not mean a new framework cannot form later.
Target Watch means the structure has progressed into target-review mode.
It does not mean the target will be reached.
🚫 What This Script Is NOT
Auto Fib Structure Planner is not:
• a prediction engine
• financial advice
• an auto-trading system
• a guaranteed signal generator
• a broker execution tool
• a stop-loss recommendation tool
• a full harmonic pattern suite
• a replacement for risk management
• a replacement for trader judgment
⚠️ Limitations & Transparency
Confirmed pivots naturally arrive with delay.
Different pivot depths create different structure maps.
Different timeframes can produce different active legs.
Very large higher-timeframe swings can produce wide zones and distant projections.
Low liquidity can reduce structure reliability.
High volatility can change invalidation and target geometry quickly.
The script works best when the market has visible swing structure.
It is designed to organize analysis, not remove uncertainty.
🧠 Market Context Notes
Fibonacci planning becomes stronger when combined with broader market context:
• trend direction
• liquidity behavior
• volume participation
• volatility regime
• support / resistance reaction
• higher timeframe structure
• risk environment
• market session context
The script gives a structured framework.
The user still decides whether that framework is useful.
🧾 Use Case Examples
Example 1 - Pullback planning:
Price forms a confirmed bullish leg and then pulls back toward the 0.500 - 0.786 decision zone. The panel shows improving readiness and the chart highlights the invalidation reference and target band.
This may deserve planning review.
Example 2 - Reaction review:
Price enters the decision zone, then prints a meaningful reaction candle. The script marks reaction behavior and may shift the state toward TARGET WATCH if the model confirms progress.
This helps the user revisit the structure without treating the label as a trade command.
Example 3 - Invalidation:
Price crosses the structural invalidation reference. The script marks the plan as INVALIDATED.
This tells the user that the current framework no longer matches the original structure logic.
Example 4 - Out-of-range target:
On a large historical bearish structure, a far extension may project below practical price territory.
The script avoids drawing an unrealistic negative target band and communicates the condition in the panel.
Example 5 - Higher timeframe review:
On weekly or monthly charts, the script automatically keeps the forward projection visually controlled so the framework does not dominate the entire chart with excessive future space.
🧱 System Philosophy
AGPro tools are designed as structured decision-support systems.
They are not built to create false certainty.
They are built to help traders classify context, compare quality, and plan with clearer visual information.
Auto Fib Structure Planner follows that philosophy by turning Fibonacci analysis into a repeatable planning workflow:
• structure first
• context second
• reaction third
• risk and target geometry always visible
• no prediction claims
• no guaranteed signals
🔐 Non-Promise Statement
This script does not guarantee accuracy, profitability, continuation, reversal, target completion, or risk control.
All outputs are rule-based analytical references.
They should be interpreted with independent judgment and broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unexpectedly.
Past behavior does not guarantee future results.
Fibonacci levels can fail.
Confirmed structures can invalidate.
High volatility can change risk conditions quickly.
This script is provided for educational and analytical purposes only.
It does not provide financial advice.
Users remain fully responsible for their own decisions, risk management, and trading activity.
📚 Educational Note
The best way to use this script is to study many examples across different timeframes.
Compare:
• clean pullbacks
• failed pullbacks
• deep retracements
• valid target progressions
• invalidated structures
• out-of-range target cases
• weekly vs daily structure differences
The value is not in one label.
The value is in building a more consistent Fibonacci planning process.
🧠 Core Idea
Which confirmed Fibonacci structure leg has enough quality, reaction, risk geometry, and target room to deserve real planning attention?
📌 Overview / What it does
Auto Fib Structure Planner is a premium Fibonacci market structure planning engine for TradingView. It turns confirmed swing structure into a complete visual planning cockpit with an active Fibonacci framework, decision zone, target band, invalidation reference, readiness score, reaction state, and next-action context.
The script is built for traders who use Fibonacci retracement and extension logic but want more than a set of static lines. It detects the active confirmed structure leg, maps the relevant retracement area, projects the continuation target band, evaluates invalidation distance, reads reaction behavior, and converts the full setup into a 0-100 planning score.
The purpose is not to predict price.
The purpose is to organize the chart.
Instead of manually asking "which swing should I use?", "is this pullback still valid?", "where is the decision zone?", "where is invalidation?", and "does target room still make sense?", the script builds one structured framework and keeps it updated as confirmed market structure changes.
It does not automate trades, does not provide guaranteed outcomes, and does not replace trader judgment. It is a rule-based analytical and educational planning tool.
📸 Chart Examples
Main publication example - Weekly structure view:
Monthly structure example:
Daily structure example:
4H planning example:
1H active review example:
Dark theme example:
🎯 Purpose & Design Philosophy
Most Fibonacci tools draw levels.
That is useful, but it leaves several important questions unanswered:
• Which swing leg is currently driving the framework?
• Is the leg large enough to matter?
• Is the pullback inside a meaningful decision zone?
• Has price reacted from that zone?
• Is the pullback becoming too deep?
• Is invalidation close enough or too wide?
• Is there still enough target room?
• Is the setup fresh, late, invalidated, or already in target review?
Auto Fib Structure Planner was built to answer those questions with a structured decision-support workflow.
The script treats Fibonacci as a planning environment, not as decoration. It combines confirmed swing logic, retracement geometry, extension mapping, ATR context, trend alignment, reaction behavior, reward / risk geometry, and state classification into one chart-first interface.
The design philosophy is simple:
• use confirmed structure
• avoid repaint-style swing guessing
• show the active leg clearly
• highlight the decision zone
• map invalidation visibly
• project target room carefully
• score the structure from 0 to 100
• explain the current state through labels and panel rows
• keep the output premium, readable, and non-hype
This is a planning cockpit, not a magic signal board.
⚡ Why This Script Is Different
Most Fibonacci indicators focus on drawing retracement levels from a selected high and low.
Most signal indicators ignore the structure leg and print directional labels without explaining the plan.
Auto Fib Structure Planner does something different.
It creates a complete Fibonacci structure workflow:
• confirmed swing leg
• active fib framework
• decision zone
• projected target band
• invalidation reference
• reaction state
• readiness score
• target progress
• panel summary
• alert-ready state logic
The script does not ask only:
"Is price bullish or bearish?"
It asks:
• Is the structure leg valid?
• Is the leg large enough relative to ATR?
• Is price still before the pullback zone?
• Is price inside the zone?
• Did price react from the zone?
• Did price move into target review?
• Did price cross invalidation?
• Is the target projection realistic?
• Does the current state deserve planning attention?
That is the difference.
The output is not just a line set. It is a structured planning state.
⚙️ Methodology
1. Confirmed Swing Detection
The script uses confirmed pivot logic to identify meaningful swing highs and lows. The pivot setting controls how many bars must appear on both sides of a swing point before it becomes part of the structure map.
Higher pivot depth creates slower but cleaner swings.
Lower pivot depth creates faster but more sensitive swing updates.
The default is designed for a balanced structure workflow.
2. Wick / Body Swing Source
The script can use wick-based or body-based swing references.
Wick mode captures the full market extreme.
Body mode creates a cleaner close-based structure map.
This allows the user to choose between full-range structure and cleaner structural filtering.
3. Deviation Filtering
Very small alternating pivots can create noisy Fibonacci legs.
The minimum swing deviation filter helps ignore weak pivot changes that do not meaningfully alter the structure.
This keeps the active leg more useful for planning.
4. ATR Leg Quality
The script compares the active leg size against ATR.
This helps identify whether the current leg has enough volatility-adjusted size to matter.
A leg that is too small receives weaker structure quality.
A larger confirmed leg receives stronger structure context.
5. Active Leg Selection
The latest valid confirmed swing pair becomes the active planning leg.
The script determines whether the active plan is a bullish pullback planner or bearish pullback planner based on the direction of the confirmed leg.
This is why the chart always shows an origin swing and confirmation swing.
6. Fibonacci Framework
The engine maps key retracement levels from the active leg.
Default levels focus on the practical planning zone:
• 0
• 0.382
• 0.500
• 0.618
• 0.786
• 1
• extension targets
Optional minor levels can be enabled when the user wants more detail.
7. Decision Zone Mapping
The decision zone is the central planning area.
By default, it is built between 0.500 and 0.786.
This area is not a prediction zone.
It is the region where pullback structure, reaction behavior, invalidation distance, and target room become more important to evaluate.
8. Target Band Projection
The script projects a target band using Fibonacci extension ratios.
The default target band uses:
• 1.272 extension
• 1.618 extension
The target band is a planning reference.
It is not a forecast.
V3.2 and V3.3 include additional safety behavior for extreme higher-timeframe cases. If an extension target becomes invalid or impractical for a spot-market chart, the script avoids drawing unrealistic target bands and communicates the condition in the panel.
9. Invalidation Reference
Invalidation is derived from the origin swing plus an ATR buffer.
This creates a structural reference for the active plan.
It is not a stop-loss recommendation.
It is a planning boundary that helps the user understand when the current structure no longer fits the active framework.
10. Reaction Evaluation
The script checks whether price interacted with the decision zone and whether meaningful reaction behavior appeared afterward.
Reaction logic can include:
• candle body strength
• movement away from the decision zone
• close behavior
• relationship with trend context
This is used as part of the readiness model and state classification.
11. Trend Context
Fast and slow EMAs are used to evaluate whether the active Fibonacci plan is aligned with broader directional context.
The EMAs do not create standalone trade signals.
They are one component of the 0-100 readiness framework.
12. Reward / Risk Geometry
The script compares the available target room against the invalidation distance.
This helps distinguish a structure that looks interesting from a structure that has inefficient planning geometry.
Reward / risk is displayed in the panel and contributes to the readiness model.
13. Readiness Score
The final 0-100 readiness score combines:
• structure leg quality
• leg freshness
• decision-zone position
• trend alignment
• reaction behavior
• reward / risk geometry
The score does not guarantee outcome.
It only summarizes how well the current structure fits the script's planning model.
14. State Conversion
The script converts the underlying model into readable states such as:
• WAIT STRUCTURE
• WAIT PULLBACK
• WATCH REACTION
• PLAN READY
• TARGET WATCH
• TARGET HIT
• DEEP PULLBACK
• INVALIDATION WATCH
• INVALIDATED
These states are designed to help the user classify context quickly.
🗺️ How to Read the Chart
Active Swing Leg:
The diagonal line connects the origin swing and the confirmation swing used by the current Fibonacci framework.
This is the structure leg that drives the script.
Origin Label:
The origin label marks the swing where the active leg began.
For bullish plans, this is usually an origin low.
For bearish plans, this is usually an origin high.
Confirmation Label:
The confirmation label marks the swing that completed the active leg.
This helps the user see why the current Fibonacci framework exists.
Fib Levels:
The horizontal fib labels identify key retracement and extension references.
They are placed to the right side of the active structure so the chart remains readable.
Decision Zone:
The colored rectangle marks the main Fibonacci pullback decision area.
The centered badge identifies the ratio range.
Default:
0.500 - 0.786
Target Band:
The target band shows the projected extension area.
The centered target badge identifies the extension range.
Default:
1.272 - 1.618
If the extension projection becomes invalid or impractical, the script avoids drawing an unrealistic band.
Invalidation Line:
The dashed invalidation line marks the structural boundary for the active plan.
It is a planning reference, not a trading instruction.
Action Label:
The action label near price shows the current state and readiness score.
Examples:
• WAIT PULLBACK
• TARGET WATCH
• INVALIDATED
• PLAN READY
Event Labels:
Event labels mark important state changes such as:
• new bull / bear plan
• decision-zone touch
• reaction confirmation
• target progress
• invalidation
The default label density is intentionally controlled so the chart stays active but not crowded.
Panel:
The panel is the fastest way to read the script.
It summarizes:
• Readiness
• Next Action
• Structure
• Decision Zone
• Invalidation
• Targets
• Reward / Risk
• Context
The top row uses the standard AGPro blue merged header.
🚦 Signals & States
• WAIT STRUCTURE → no qualified confirmed swing framework is active yet
• WAIT PULLBACK → structure exists, but price has not yet reached the decision area
• WATCH REACTION → price is inside or near the decision zone and reaction behavior should be observed
• PLAN READY → readiness score reached the selected threshold while price is in the decision area
• TARGET WATCH → price reacted or progressed enough for target-room monitoring
• TARGET HIT → the projected target reference was reached
• DEEP PULLBACK → retracement moved beyond the configured deep-pullback warning level
• INVALIDATION WATCH → price moved beyond the preferred decision range and closer to invalidation risk
• INVALIDATED → price crossed the structural invalidation reference
These are analytical states.
They are not buy or sell instructions.
🔔 Alerts Logic
The script includes alert conditions for:
• New Auto Fib Structure Plan
• Fib Decision Zone Touch
• Fib Plan Reaction Confirmed
• Fib Target One Reached
• Fib Target Band Completed
• Fib Plan Invalidated
Alerts can be restricted to confirmed bars.
This supports a cleaner workflow for users who do not want intrabar noise.
Alerts are attention markers.
They are not trade instructions, automation signals, or guaranteed outcomes.
🧩 Confluence Logic
The active structure becomes more meaningful when multiple elements align:
• confirmed swing leg
• sufficient leg size
• price enters the decision zone
• reaction behavior appears
• trend context supports the leg direction
• invalidation is not too wide
• target room remains available
• readiness score improves
The script does not treat any single element as enough by itself.
Its value comes from combining structure, geometry, reaction, and context.
📊 When to Use
Auto Fib Structure Planner is most useful when:
• a market has visible swing structure
• price is pulling back within a confirmed leg
• higher-timeframe planning matters
• continuation structure is being reviewed
• invalidation and target room need to be visible
• a trader wants a repeatable Fibonacci workflow
• the chart has enough history for meaningful swing confirmation
Recommended review timeframes:
• 1H for active short-term structure
• 4H for cleaner swing planning
• Daily for broader structure review
• Weekly for main publication-style structure context
• Monthly for macro structure inspection
⚠️ When NOT to Use
The script may be less useful during:
• extremely low liquidity
• chaotic news-driven candles
• very tight sideways chop
• markets with poor historical data
• instruments where Fibonacci structure has no visible relevance
• timeframes that are too low for the selected pivot depth
• conditions where spreads and execution risk dominate structure quality
The script is not designed to force a plan on every chart.
Sometimes the correct output is simply to wait.
🎛️ Key Inputs
Structure Pivot Depth:
Controls how many bars are required on each side of a confirmed swing point.
Higher values create slower but cleaner structure.
Use Wicks For Swings:
When enabled, swing highs and lows use full candle wicks.
When disabled, the script uses candle bodies for a cleaner close-based structure map.
Minimum Swing Deviation %:
Filters very small pivot changes that do not meaningfully change structure.
Minimum Leg Size ATR:
Requires the active leg to be large enough relative to ATR.
This helps avoid weak Fibonacci frameworks based on tiny moves.
Confirmed Bars Only:
Keeps the engine focused on confirmed pivot behavior.
This supports a cleaner non-repainting planning workflow.
Decision Zone Lower / Upper Ratio:
Controls the Fibonacci retracement area used as the main decision zone.
Default:
0.500 to 0.786
Target Band Start / End Extension:
Controls the extension area used for target-band projection.
Default:
1.272 to 1.618
Plan Zone Extension Bars:
Controls how far the decision zone and target band extend to the right.
V3.3 adds automatic higher-timeframe protection:
• monthly charts cap forward projection at 24 bars
• weekly charts cap forward projection at 52 bars
• intraday and daily charts continue to use the configured value
Invalidation Buffer ATR:
Adds a volatility buffer beyond the origin swing before the plan is considered invalidated.
Fast / Slow Context EMA:
Used for trend alignment scoring.
They are not standalone signals.
Plan Ready Threshold:
Minimum readiness score required for PLAN READY state.
Deep Pullback Warning Ratio:
Defines when a pullback becomes deep enough to shift the state toward risk review.
Reaction Body ATR Filter:
Minimum candle body size used to help qualify reaction behavior.
Good Reward / Risk Level:
Reward / risk level used inside the readiness model.
Visual Mode:
Controls the visual intensity of lines, zones, and emphasis.
Label Settings:
Control event label density, font size, and ATR-based label spacing.
Panel Settings:
Control panel visibility, location, theme, and font size.
Alert Settings:
Enable or disable alert conditions and confirmed-bar alert behavior.
🖥️ Interface & Visual Design
Auto Fib Structure Planner is designed around chart clarity.
The main hierarchy is:
1. active structure leg
2. decision zone
3. invalidation reference
4. target band
5. action label
6. panel summary
The visual system uses the AGPro palette:
• teal / green for bullish planning context
• pink for bearish planning context
• indigo / blue for target and extension references
• amber for neutral fib references
• deep panel colors for dashboard readability
Zone and band labels use colored badge backgrounds so they remain readable on both dark and light chart themes.
The panel uses a compact professional layout with a blue merged header row.
🧪 Practical Usage Workflow
1. Start with the panel
Read:
• Readiness
• Next Action
• Structure
• Reward / Risk
• Context
2. Confirm the active leg
Check whether the origin and confirmation swing match the structure you want to study.
3. Review the decision zone
Ask:
• Is price before the zone?
• Inside the zone?
• Already through the zone?
• Reacting from the zone?
4. Check invalidation
Compare current price with the invalidation reference.
If invalidation is too close or already crossed, the plan should be interpreted differently.
5. Check target room
Look at the projected target band and reward / risk row.
If target room is weak or out of range, the plan may not have useful geometry.
6. Watch state transitions
Use labels and alerts to understand when the framework moves from waiting to reaction, target review, or invalidation.
7. Compare timeframes
The same chart can look different on 1H, 4H, daily, weekly, and monthly.
Use higher timeframes for structure context and lower timeframes for active review.
🔍 Interpretation Guidelines
A higher readiness score means the current structure fits the script's rule-based planning model better.
It does not mean price must continue.
A decision-zone touch means price interacted with the mapped Fibonacci pullback area.
It does not mean a reversal or continuation is guaranteed.
Reaction confirmation means the script detected meaningful movement away from the decision zone.
It does not mean the move will continue.
Invalidated means the current framework no longer fits the active plan logic.
It does not mean a new framework cannot form later.
Target Watch means the structure has progressed into target-review mode.
It does not mean the target will be reached.
🚫 What This Script Is NOT
Auto Fib Structure Planner is not:
• a prediction engine
• financial advice
• an auto-trading system
• a guaranteed signal generator
• a broker execution tool
• a stop-loss recommendation tool
• a full harmonic pattern suite
• a replacement for risk management
• a replacement for trader judgment
⚠️ Limitations & Transparency
Confirmed pivots naturally arrive with delay.
Different pivot depths create different structure maps.
Different timeframes can produce different active legs.
Very large higher-timeframe swings can produce wide zones and distant projections.
Low liquidity can reduce structure reliability.
High volatility can change invalidation and target geometry quickly.
The script works best when the market has visible swing structure.
It is designed to organize analysis, not remove uncertainty.
🧠 Market Context Notes
Fibonacci planning becomes stronger when combined with broader market context:
• trend direction
• liquidity behavior
• volume participation
• volatility regime
• support / resistance reaction
• higher timeframe structure
• risk environment
• market session context
The script gives a structured framework.
The user still decides whether that framework is useful.
🧾 Use Case Examples
Example 1 - Pullback planning:
Price forms a confirmed bullish leg and then pulls back toward the 0.500 - 0.786 decision zone. The panel shows improving readiness and the chart highlights the invalidation reference and target band.
This may deserve planning review.
Example 2 - Reaction review:
Price enters the decision zone, then prints a meaningful reaction candle. The script marks reaction behavior and may shift the state toward TARGET WATCH if the model confirms progress.
This helps the user revisit the structure without treating the label as a trade command.
Example 3 - Invalidation:
Price crosses the structural invalidation reference. The script marks the plan as INVALIDATED.
This tells the user that the current framework no longer matches the original structure logic.
Example 4 - Out-of-range target:
On a large historical bearish structure, a far extension may project below practical price territory.
The script avoids drawing an unrealistic negative target band and communicates the condition in the panel.
Example 5 - Higher timeframe review:
On weekly or monthly charts, the script automatically keeps the forward projection visually controlled so the framework does not dominate the entire chart with excessive future space.
🧱 System Philosophy
AGPro tools are designed as structured decision-support systems.
They are not built to create false certainty.
They are built to help traders classify context, compare quality, and plan with clearer visual information.
Auto Fib Structure Planner follows that philosophy by turning Fibonacci analysis into a repeatable planning workflow:
• structure first
• context second
• reaction third
• risk and target geometry always visible
• no prediction claims
• no guaranteed signals
🔐 Non-Promise Statement
This script does not guarantee accuracy, profitability, continuation, reversal, target completion, or risk control.
All outputs are rule-based analytical references.
They should be interpreted with independent judgment and broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unexpectedly.
Past behavior does not guarantee future results.
Fibonacci levels can fail.
Confirmed structures can invalidate.
High volatility can change risk conditions quickly.
This script is provided for educational and analytical purposes only.
It does not provide financial advice.
Users remain fully responsible for their own decisions, risk management, and trading activity.
📚 Educational Note
The best way to use this script is to study many examples across different timeframes.
Compare:
• clean pullbacks
• failed pullbacks
• deep retracements
• valid target progressions
• invalidated structures
• out-of-range target cases
• weekly vs daily structure differences
The value is not in one label.
The value is in building a more consistent Fibonacci planning process.
Release Notes
🔧 UPDATE NOTES - v3.4This update focuses on panel readability and a cleaner premium presentation.
The core purpose of the script remains unchanged.
This release refines how the existing fib structure-planning workflow is presented and read 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 an inline readiness gauge to the panel.
The Readiness row now shows a compact visual gauge next to the 0-100 score, so plan readiness is easier to read at a glance.
• Minor presentation cleanup for a more balanced first impression, consistent with the rest of the series.
------------------------
Visual Improvements
------------------------
• Improved panel readability with a clearer presentation of the readiness score.
• Kept the decision-zone and target-band labels centered inside their zones for easy reading.
• Maintained ATR-based spacing so action, event, and swing labels stay clear of candle bodies.
------------------------
Interface & Usability
------------------------
• Kept all existing controls: structure engine, fib plan, readiness decision engine, visual design, panel, and alert settings.
• Panel show/hide, location, theme, and font-size controls remain available with balanced defaults.
• Improved overall chart interaction without changing the underlying workflow.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
Swing detection, the fib decision zone, the projected target band, the 0-100 readiness model, next-action states, event labels, and alert conditions all behave the same as before.
Users should interpret outputs the same way as before, with a slightly cleaner presentation.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based planning and visualization tool.
Fib structure depends on recent confirmed swings, and market conditions such as volatility, liquidity, and timeframe differences may affect how plans and states appear.
Outputs should always be interpreted within broader market structure and 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.
Release Notes
🔧 UPDATE NOTES - V3.5This small maintenance update focuses on state consistency, input safety, and edge-case reliability.
The core purpose of the script remains unchanged.
This release strengthens how the existing Fibonacci structure-planning workflow handles unusual settings and terminal plan states.
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
------------------------
• Normalized target-band extension inputs
The engine now treats the smaller extension input as the near target and the larger input as the far target, even when the values are entered in reverse order. Equal values are handled as one target reference instead of a zero-width target band.
• Preserved terminal invalidation state
After an active plan closes beyond its structural invalidation reference, that plan now remains invalidated until a new confirmed structure leg is created. Reaction and target events cannot reactivate an already-invalidated plan.
Completed far-target and single-target plans also retain their completed status. A later reversal does not rewrite an already-completed plan as a new invalidation event.
• Refined adverse pullback state priority
Deep-pullback and invalidation-watch conditions can now take priority when price deteriorates after an earlier reaction or first-target event.
• Added structure and reward/risk safeguards
Same-bar pivot pairs are excluded from active-leg construction, and reward/risk is reported only while the invalidation reference remains on the valid risk side of price.
• Clarified confirmation behavior
Event-label rendering now follows the core Confirmed Bars Only setting, while the alert confirmation option remains specific to alerts.
------------------------
Visual Improvements
------------------------
• Preserved the existing chart composition, Fibonacci framework, centered decision-zone badge, centered target-band badge, and AGPro color hierarchy
• Kept the merged blue panel header and all current panel rows unchanged
• Retained ATR-based spacing for action, event, and swing labels
• Added no new chart objects to the default 1.272 / 1.618 layout; equal target inputs use one dedicated target line and label instead of a zero-width band
------------------------
Interface & Usability
------------------------
• Clarified target-extension tooltips so reverse-order and equal-value behavior is explicit
• Preserved panel show/hide, location, theme, panel font-size, and label font-size controls
• Kept the default 1.272 / 1.618 target workflow unchanged
• Retained all six existing alert names and alert categories
------------------------
Behavior Notes
------------------------
The core swing, Fibonacci, decision-zone, reaction, and visual framework remains unchanged.
This release intentionally corrects edge-case behavior. Reversed target inputs now preserve near/far semantics, equal target inputs complete as a single target, and terminal invalidation or target-completion states remain stable until a new confirmed structure leg creates a new plan.
Users can interpret the default workflow in the same way as before.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based planning and visualization tool.
Confirmed pivots naturally appear with delay. Volatility, liquidity, timeframe selection, and pivot-depth settings may affect the active structure, invalidation geometry, and state timing.
Outputs should always be interpreted within broader market structure and context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice, automated execution, or guaranteed trading outcomes.
Users remain responsible for their own decisions and risk management.
Release Notes
🔧 UPDATE NOTES - V3.6• Refreshed the publication and access routing information.
• Core analytical logic, panel behavior, inputs, alerts, visuals, and outputs remain unchanged.
Release Notes
🔧 UPDATE NOTES - VERSION 3.7This update focuses on premium readability, collision-safe Fibonacci mapping, panel clarity, and leaner rendering.
The confirmed swing-leg engine, Fibonacci plan logic, readiness score, state model, and six alert conditions remain unchanged. This release improves how the existing analytical framework is presented and interpreted on the chart.
------------------------
What Changed
------------------------
• Replaced the ASCII readiness bar with a clean, state-colored 0-100 score cell.
• Added a merged analytical question row and alternating theme-aware panel rows for faster first-glance interpretation.
• Introduced separate, font-aware spacing lanes for retracement and extension labels to reduce overlap at compact price scales.
• Added dotted ownership connectors whenever a Fibonacci label is displaced from its true price rail.
• Separated the invalidation badge from the 1.000 reference while preserving its exact structural price.
• Enriched the centered decision-zone badge with its active ratio range and readiness score, and refined target-band hierarchy.
• Converted the active action badge to a compact single-line state and quality readout with greater candle clearance.
• Reduced line, label, and box budgets to match the script's real visual footprint while preserving all six alerts and the core analytical engine.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The script remains a rule-based planning and visualization tool. It does not predict price direction, automate trades, or guarantee outcomes.
------------------------
Risk Reminder
------------------------
Trading involves risk. Outputs should be interpreted within broader structure, liquidity, volatility, and timeframe context. Users remain responsible for their own decisions.
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
Request access to Auto Fib Structure Planner [AGPro Series]:
https://www.agprolabs.com/product/auto-fib-structure-planner/
🧠 Trading Suite - Flagship Workflow
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.
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
Request access to Auto Fib Structure Planner [AGPro Series]:
https://www.agprolabs.com/product/auto-fib-structure-planner/
🧠 Trading Suite - Flagship Workflow
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.