OPEN-SOURCE SCRIPT
מעודכן AG Pro Ichimoku Cloud Equilibrium Map [AGPro Series]
AG Pro Ichimoku Cloud Equilibrium Map [AGPro Series]
Overview / What it does
AG Pro Ichimoku Cloud Equilibrium Map is an Ichimoku-based overlay designed to map balance, displacement, and return-to-balance behavior around a dynamic equilibrium core. Instead of using Ichimoku primarily as a traditional bullish/bearish checklist, this script reorganizes the framework around one structural question: where is price trading relative to its current equilibrium, and is that position balanced, expanding, overstretched, or reclaiming balance?
The script blends Kijun-Sen with the cloud midpoint to build an equilibrium core, then expands that core into an adaptive equilibrium band using ATR and cloud thickness. From there, it classifies how price is behaving around that band and displays the result through chart states, optional labels, and a compact information panel.
This script is intended as a chart analysis tool. It is built to help users read structure more efficiently, especially when standard Ichimoku layouts feel visually dense or interpretation-heavy.
Unique Edge
The main difference is that this script does not treat Ichimoku as a simple trend confirmation overlay. It converts the Ichimoku framework into an equilibrium map.
Rather than focusing only on whether price is above or below the cloud, this script asks:
- Is price still near structural balance?
- Is price moving away from equilibrium in a controlled way?
- Has the move become stretched?
- Is price returning back into equilibrium after displacement?
That makes it different from a standard Ichimoku presentation, where the raw components are visible but the user must do most of the structural interpretation manually.
It is also different from other AG Pro scripts built around breakout quality, oscillator pressure, compression behavior, or reversion frameworks. This tool is specifically centered on equilibrium, extension, and reclaim behavior using an Ichimoku-derived structure model.
Methodology
The script uses the following structure:
1. Kijun-Sen
Kijun-Sen is used as one of the main balance anchors.
2. Cloud midpoint
The midpoint between Span A and Span B is used as a second structural reference.
3. Equilibrium core
The script combines Kijun-Sen and the cloud midpoint into a dynamic equilibrium core.
4. Equilibrium band
An adaptive band is built around the equilibrium core using ATR and cloud thickness. This allows the model to respond differently in quieter and more volatile conditions.
5. Stretch zones
Beyond the equilibrium band, the script defines stretch areas that help distinguish normal directional expansion from more extended displacement.
6. Reclaim logic
When price moves back into the equilibrium region after being outside it, the script can classify that transition as a reclaim state.
This methodology is designed to make Ichimoku structure more explicit without removing the original context of the cloud framework.
States / Signals & Alerts
The script classifies chart behavior into the following states:
Balanced
Price is trading inside the equilibrium band.
Bullish Expansion
Price is trading above the equilibrium band with supportive directional structure.
Bearish Expansion
Price is trading below the equilibrium band with supportive directional structure.
Overstretched Bullish
Price is extended above the stretch threshold.
Overstretched Bearish
Price is extended below the stretch threshold.
Bullish Reclaim
Price has returned into the equilibrium region after trading below it.
Bearish Reclaim
Price has returned into the equilibrium region after trading above it.
Available alert conditions:
- Bullish Expansion
- Bearish Expansion
- Overstretched Bullish
- Overstretched Bearish
- Bullish Reclaim
- Bearish Reclaim
These states and alerts are descriptive tools for chart analysis. They are not a complete trade plan and should be interpreted in context.
Key Inputs
Ichimoku settings
Users can adjust Tenkan length, Kijun length, Senkou Span B length, and displacement.
Equilibrium engine settings
Users can control ATR length, equilibrium band sensitivity, cloud-thickness contribution, stretch sensitivity, and chop lookback.
Visual settings
Users can control cloud visibility, Kijun visibility, equilibrium band visibility, stretch zones, state labels, label density, and panel appearance.
These inputs allow the script to be tuned for different symbols, volatility conditions, and chart preferences.
Limitations & Transparency
This script is an indicator, not a strategy.
It does not place trades, manage positions, calculate performance, or guarantee outcomes.
The Equilibrium Score is an internal structure summary built from distance, alignment, cloud thickness, Tenkan/Kijun spread, reclaim contribution, and chop penalty. It is not a probability model, not a forecast, and not a standalone decision engine.
Overstretched conditions do not automatically imply reversal.
Reclaim conditions do not automatically imply continuation.
Expansion conditions do not automatically imply strength will persist.
As with any chart tool, interpretation depends on market regime, timeframe, volatility, and the user’s broader workflow. In noisy environments, state changes can occur more frequently. The script includes filters to reduce clutter, but no indicator removes uncertainty completely.
Risk Disclosure
This script is provided for research and chart analysis only.
It is not financial advice. Users should evaluate any signal, state change, or alert within their own process, risk framework, and market context before making decisions.
Overview / What it does
AG Pro Ichimoku Cloud Equilibrium Map is an Ichimoku-based overlay designed to map balance, displacement, and return-to-balance behavior around a dynamic equilibrium core. Instead of using Ichimoku primarily as a traditional bullish/bearish checklist, this script reorganizes the framework around one structural question: where is price trading relative to its current equilibrium, and is that position balanced, expanding, overstretched, or reclaiming balance?
The script blends Kijun-Sen with the cloud midpoint to build an equilibrium core, then expands that core into an adaptive equilibrium band using ATR and cloud thickness. From there, it classifies how price is behaving around that band and displays the result through chart states, optional labels, and a compact information panel.
This script is intended as a chart analysis tool. It is built to help users read structure more efficiently, especially when standard Ichimoku layouts feel visually dense or interpretation-heavy.
Unique Edge
The main difference is that this script does not treat Ichimoku as a simple trend confirmation overlay. It converts the Ichimoku framework into an equilibrium map.
Rather than focusing only on whether price is above or below the cloud, this script asks:
- Is price still near structural balance?
- Is price moving away from equilibrium in a controlled way?
- Has the move become stretched?
- Is price returning back into equilibrium after displacement?
That makes it different from a standard Ichimoku presentation, where the raw components are visible but the user must do most of the structural interpretation manually.
It is also different from other AG Pro scripts built around breakout quality, oscillator pressure, compression behavior, or reversion frameworks. This tool is specifically centered on equilibrium, extension, and reclaim behavior using an Ichimoku-derived structure model.
Methodology
The script uses the following structure:
1. Kijun-Sen
Kijun-Sen is used as one of the main balance anchors.
2. Cloud midpoint
The midpoint between Span A and Span B is used as a second structural reference.
3. Equilibrium core
The script combines Kijun-Sen and the cloud midpoint into a dynamic equilibrium core.
4. Equilibrium band
An adaptive band is built around the equilibrium core using ATR and cloud thickness. This allows the model to respond differently in quieter and more volatile conditions.
5. Stretch zones
Beyond the equilibrium band, the script defines stretch areas that help distinguish normal directional expansion from more extended displacement.
6. Reclaim logic
When price moves back into the equilibrium region after being outside it, the script can classify that transition as a reclaim state.
This methodology is designed to make Ichimoku structure more explicit without removing the original context of the cloud framework.
States / Signals & Alerts
The script classifies chart behavior into the following states:
Balanced
Price is trading inside the equilibrium band.
Bullish Expansion
Price is trading above the equilibrium band with supportive directional structure.
Bearish Expansion
Price is trading below the equilibrium band with supportive directional structure.
Overstretched Bullish
Price is extended above the stretch threshold.
Overstretched Bearish
Price is extended below the stretch threshold.
Bullish Reclaim
Price has returned into the equilibrium region after trading below it.
Bearish Reclaim
Price has returned into the equilibrium region after trading above it.
Available alert conditions:
- Bullish Expansion
- Bearish Expansion
- Overstretched Bullish
- Overstretched Bearish
- Bullish Reclaim
- Bearish Reclaim
These states and alerts are descriptive tools for chart analysis. They are not a complete trade plan and should be interpreted in context.
Key Inputs
Ichimoku settings
Users can adjust Tenkan length, Kijun length, Senkou Span B length, and displacement.
Equilibrium engine settings
Users can control ATR length, equilibrium band sensitivity, cloud-thickness contribution, stretch sensitivity, and chop lookback.
Visual settings
Users can control cloud visibility, Kijun visibility, equilibrium band visibility, stretch zones, state labels, label density, and panel appearance.
These inputs allow the script to be tuned for different symbols, volatility conditions, and chart preferences.
Limitations & Transparency
This script is an indicator, not a strategy.
It does not place trades, manage positions, calculate performance, or guarantee outcomes.
The Equilibrium Score is an internal structure summary built from distance, alignment, cloud thickness, Tenkan/Kijun spread, reclaim contribution, and chop penalty. It is not a probability model, not a forecast, and not a standalone decision engine.
Overstretched conditions do not automatically imply reversal.
Reclaim conditions do not automatically imply continuation.
Expansion conditions do not automatically imply strength will persist.
As with any chart tool, interpretation depends on market regime, timeframe, volatility, and the user’s broader workflow. In noisy environments, state changes can occur more frequently. The script includes filters to reduce clutter, but no indicator removes uncertainty completely.
Risk Disclosure
This script is provided for research and chart analysis only.
It is not financial advice. Users should evaluate any signal, state change, or alert within their own process, risk framework, and market context before making decisions.
הערות שחרור
UPDATE NOTES - V1.6AG Pro Ichimoku Cloud Equilibrium Map [AGPro Series]
This update focuses on visual hierarchy, right-edge clarity, and state communication consistency.
What changed
1) Refined right-edge presentation
The active area on the most recent bars has been cleaned up so the chart reads more clearly at first glance. The goal of this pass was not to change the equilibrium logic, but to present the active zone in a more structured and visually intentional way.
2) Stretch tags were repositioned
Bull Stretch and Bear Stretch tags were adjusted so they point toward the active stretch area more naturally instead of appearing to reference empty chart space. This improves directional readability and makes the tags feel more integrated with the structure on the chart.
3) Core tag was redesigned as an anchor label
The Core label was reworked so it behaves more like a reference marker and less like a signal tag. This helps separate the role of the equilibrium core from the role of state-event labels and stretch-context labels.
4) Core label now follows Label Size
The Core tag now scales in line with the main Label Size setting, which keeps the visual language more consistent across different chart styles and user preferences.
5) Better separation between current structure and historical events
Historical event labels remain available for context, while the most recent active area is now easier to identify visually. This creates a cleaner balance between past state transitions and the current decision zone.
6) Current-state consistency improvement
A current-state tag layer was added so the panel state and the visible right-edge chart communication stay better aligned, especially in reclaim conditions. This reduces visual ambiguity when the panel shows a live state that may not match the most recent historical event label.
7) Premium visual polish
The equilibrium core, band presentation, and tag hierarchy were tuned to create a cleaner and more premium look without overcrowding the chart.
What did not change
- No attempt was made to reframe this script as a prediction engine.
- No undocumented promise of future price direction is implied.
- The main equilibrium engine, state logic, and Ichimoku-derived structural framework remain conceptually the same.
- This update is primarily a presentation, readability, and communication refinement.
Why this update matters
The script already carried a useful analytical structure, but parts of the visual output could occasionally compete for attention. This revision improves chart readability and makes the most relevant area easier to interpret without removing the broader structural context.
Result
The chart should now feel more intentional, more readable, and more visually coherent, especially on the most recent bars where users naturally focus first.
As always, this tool is intended to support chart reading, structure assessment, and context evaluation. It is not a guarantee, signal-selling device, or substitute for independent trade planning.
הערות שחרור
Update Notes - V1.7This update focuses on visual balance and chart readability.
What changed:
- Reduced the opacity of the Ichimoku cloud fill to keep candles and wick structure clearer.
- Softened the equilibrium band fill so the central zone remains visible without dominating the chart.
- Reduced the stretch zone fill intensity to improve price-action visibility during expansion phases.
- Preserved the core equilibrium, reclaim, stretch, and twist logic from the prior version.
- Kept the panel structure, alert framework, and labeling system unchanged.
Why this update was made:
- The previous visual layer could appear too dominant on some charts.
- This refinement improves readability while keeping the indicator's structure and state mapping intact.
Notes:
- This update is visual and presentation-oriented.
- No claim is made regarding predictive accuracy or trading performance.
- The script remains an analysis and alerting tool, not an automated trading system.
הערות שחרור
Update Notes - V1.8This update is built to make the script feel more premium, more distinctive, and more useful at first glance without changing its core identity as an Ichimoku-derived equilibrium framework.
What changed
1. New stretch memory zones
The script now projects the latest qualified bullish or bearish stretch corridor forward as a rectangular memory zone. This gives displacement phases a cleaner structural footprint and creates a stronger visual reference for post-expansion reactions, pullbacks, and reclaim behavior.
2. Stronger right-edge communication
The live chart edge was reworked with cleaner EQ Core, Bull Zone, Bear Zone, and current-state tags so the most important information reads immediately on the latest bars.
3. Full AGPro panel standard
The panel now follows the premium AGPro format with a merged blue title row, adjustable position, adjustable font size, and theme support. The live metrics were also refined to emphasize structure quality instead of visual clutter.
4. Professional tooltip pass
Core inputs, visual controls, labels, projected zones, and panel settings now include clear English tooltips for a more polished public-release experience.
5. Cleaner title architecture
The script title now follows the newer naming standard by removing the AG Pro prefix from the published script title while keeping AG Pro visible inside the panel header and the short title.
6. Premium palette alignment
The visual system was rebuilt around the AGPro palette so the cloud, equilibrium band, stretch states, and panel hierarchy feel more consistent and brand-defined.
7. Better default readability
Panel font size now defaults to Normal, labels keep more distance from candles, and stretch visuals remain visible without overwhelming price action.
What did not change
- The equilibrium engine is still built from Kijun-Sen and cloud midpoint.
- State logic remains centered on balance, expansion, overstretch, and reclaim behavior.
- The script is still an analysis and alerting framework, not a prediction engine or trading strategy.
Why this update matters
The prior version was structurally sound, but the visual story ended too quickly once displacement faded. The new stretch memory zones solve that by preserving context after expansion, which makes the script feel more intentional, more premium, and more differentiated from standard Ichimoku presentations.
Result
The indicator now communicates not only where equilibrium is, but also where displacement recently lived. That extra layer makes the map richer for continuation traders, reclaim traders, and anyone who wants a more complete structural picture without turning the chart into noise.
הערות שחרור
UPDATE NOTES - v1.9This update focuses on label and panel readability.
The core purpose of the script remains unchanged. This release improves how the
existing state labels, reference tags, and panel read on the chart, with text
that stays clear on every state color and on both panel themes.
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
------------------------
- Theme-aware label and tag text
State labels, Kumo twist tags, and the right-edge reference tags (EQ Core,
Bull Zone, Bear Zone, and the current-state tag) now choose a text color that
reads clearly on each tag color. Amber and lighter tags previously used white
text that was hard to read; they now switch to a dark text color, while darker
tags keep light text.
- Theme-aware panel cells
The State, Chop, and Twist panel cells now pick a readable text color for their
colored backgrounds on both the Elite Dark and Clean Light themes.
------------------------
Visual Improvements
------------------------
- Contrast-safe state labels and reference tags across all state colors.
- Cleaner, more legible right-edge tags (EQ Core, Bull Zone, Bear Zone).
- Improved panel contrast on the colored State, Chop, and Twist cells.
- Preserved the familiar cloud, equilibrium band, stretch zones, and memory box
layout.
------------------------
Interface & Usability
------------------------
- Cleaner, more readable state labeling.
- Improved panel contrast on both panel themes.
- Adjusted default visual presentation for a more balanced, premium appearance.
- Enhanced overall user experience without changing core logic.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The Ichimoku cloud, the equilibrium core and band, the overstretch and reclaim
state engine, the stretch memory zones, the equilibrium quality score, and every
panel statistic all behave exactly as before.
Users should interpret outputs the same way as before, but with cleaner labels
and a more readable panel.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how equilibrium 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.
הערות שחרור
🔧 UPDATE NOTES - v2.0This update adds a next-action readout and a reclaim follow-rate proof.
The core purpose of the script remains unchanged.
It continues to map the Ichimoku cloud, equilibrium core and band, stretch zones, memory
zones, states and twists with the same engine.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Action row
The panel now translates the current state and chop context into a clear, neutral
next-action readout, so the equilibrium map guides interpretation rather than only describing it.
- Reclaim Follow Rate proof layer
The panel reports how often reclaims historically followed through in the reclaim direction
before failing back across the band, shown with the sample count for transparency.
- Reclaim Proof Window input
A new setting controls the window used to measure post-reclaim follow-through.
- Cleaner score formatting
The equilibrium score is now shown as a whole number out of 100.
------------------------
Visual Improvements
------------------------
- Preserved the cloud, equilibrium core, band, glow, stretch and memory zones
- Kept contrast-aware state labels, twist tags and right-edge reference tags
- Maintained controlled label spacing and density
- Left the publication-ready chart layout intact
------------------------
Interface & Usability
------------------------
- Added an Action row for a clear, at-a-glance next step
- Added a Reclaim Rate row for a historical follow-through track record
- Added a window setting so the proof measures prompt follow-through
- Enhanced overall user experience without changing the core equilibrium logic
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
States, score, cloud and zones are unchanged. The Action readout and Reclaim Rate are
presentation and track-record layers and do not alter how the equilibrium map is computed.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how
states, reclaims and the rate 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.
סקריפט קוד פתוח
ברוח האמיתית של TradingView, יוצר הסקריפט הזה הפך אותו לקוד פתוח, כך שסוחרים יוכלו לעיין בו ולאמת את פעולתו. כל הכבוד למחבר! אמנם ניתן להשתמש בו בחינם, אך זכור כי פרסום חוזר של הקוד כפוף ל־כללי הבית שלנו.
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
כתב ויתור
המידע והפרסומים אינם מיועדים להיות, ואינם מהווים, ייעוץ או המלצה פיננסית, השקעתית, מסחרית או מכל סוג אחר המסופקת או מאושרת על ידי TradingView. קרא עוד ב־תנאי השימוש.
סקריפט קוד פתוח
ברוח האמיתית של TradingView, יוצר הסקריפט הזה הפך אותו לקוד פתוח, כך שסוחרים יוכלו לעיין בו ולאמת את פעולתו. כל הכבוד למחבר! אמנם ניתן להשתמש בו בחינם, אך זכור כי פרסום חוזר של הקוד כפוף ל־כללי הבית שלנו.
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
כתב ויתור
המידע והפרסומים אינם מיועדים להיות, ואינם מהווים, ייעוץ או המלצה פיננסית, השקעתית, מסחרית או מכל סוג אחר המסופקת או מאושרת על ידי TradingView. קרא עוד ב־תנאי השימוש.