OPEN-SOURCE SCRIPT
Actualizado

AG Pro KAMA Efficiency Zones [AGPro Series]

696
AG Pro KAMA Efficiency Zones [AGPro Series]

Overview

KAMA stands for Kaufman’s Adaptive Moving Average.

AG Pro KAMA Efficiency Zones is built around KAMA not as a simple trend-following line, but as an adaptive market reference for evaluating how efficiently price is moving. Instead of focusing only on direction, the script is designed to classify the quality of directional travel and separate cleaner movement from noisier, lower-clarity conditions.

The core idea is straightforward: markets do not move with the same quality all the time. Some phases show relatively efficient directional travel where price stays organized around an adaptive path. Other phases become mixed, unstable, or reversion-prone, where direction weakens and noise becomes more dominant. This script is designed to map those changes visually through adaptive KAMA-based zones, state labels, and a compact panel that summarizes the current condition.

This makes the tool structurally different from a basic moving average overlay. The objective is not to present KAMA as a one-line signal source. The objective is to use KAMA as the center of a state engine that helps users distinguish efficient trend phases from transitional or noisy environments.

What this script does

AG Pro KAMA Efficiency Zones evaluates price behavior around a Kaufman’s Adaptive Moving Average and organizes that behavior into visual market states. It does this by combining adaptive smoothing, slope behavior, distance from KAMA, and persistence around the KAMA path.

The result is a chart framework that can help answer questions such as:

• Is price moving in an efficient bullish or bearish path?
• Is the market entering a mixed transition phase?
• Has movement quality deteriorated into a noisier reversion-prone environment?
• Is the adaptive path becoming stronger, weaker, or less stable?

By turning those questions into zones and state-based chart feedback, the script aims to improve context rather than replace judgment.

Unique edge

The distinguishing feature of this script is that it does not treat KAMA as a standard moving average. Instead, it uses KAMA as the center of a layered efficiency model.

That model focuses on the quality of movement, not just the existence of movement.

Many tools emphasize momentum, volatility, volume pressure, or overbought/oversold conditions. This script is designed for a different purpose. It is a movement-quality map. It attempts to show whether price is traveling in a relatively efficient path or whether that path is degrading into a noisier condition where directional clarity may be weaker.

This means the script is less about predicting a move and more about classifying the environment in which a move is taking place.

How it works

The script begins with KAMA, or Kaufman’s Adaptive Moving Average. KAMA is useful because it adapts its responsiveness according to market behavior. In cleaner directional phases it can respond more quickly, while in noisier phases it can become more conservative. That makes it a practical centerline for an efficiency-based state model.

On top of KAMA, the script evaluates several components:

1. Efficiency behavior
The script measures how directly price is moving relative to its recent path. This helps estimate whether price action is acting efficiently or becoming more erratic.

2. KAMA slope behavior
The slope of KAMA is normalized so that directional angle can be evaluated in a more consistent way. Stronger and more persistent slope behavior supports higher-quality trend classifications.

3. Price-to-KAMA relationship
Price position around KAMA helps determine whether movement is aligned with the adaptive path or drifting around it without clear structure.

4. Persistence
The script also looks at how consistently price remains on one side of KAMA. That persistence can help distinguish a more stable move from a weaker and less durable one.

These components are blended into a composite efficiency model that drives the active state and the corresponding visual zone.

States and zones

The script classifies market behavior into four main states:

Efficient Bull Trend
This state reflects a comparatively organized bullish environment where price and adaptive slope are aligned in a cleaner upward path.

Efficient Bear Trend
This state reflects a comparatively organized bearish environment where price and adaptive slope are aligned in a cleaner downward path.

Transition
This is a mixed condition. Direction may be weakening, changing, or failing to achieve the quality required for an efficient trend classification.

Noise / Reversion
This state reflects lower movement quality, weaker slope behavior, or a more unstable relationship between price and the adaptive path.

The visual zone structure is designed to reinforce those classifications on the chart. Instead of using only one line, the script builds layered KAMA-centered bands so the user can read not only direction, but also how structured or fragile the current condition may be.

How to read the chart

The KAMA line is the adaptive spine of the script.

The outer and inner bands represent zone structure around that adaptive path. In stronger trend states, the script increases the visual emphasis of the KAMA path and its supporting zone layers. In weaker or more mixed conditions, the script softens those visuals and allows the chart to communicate reduced clarity.

State labels appear when the script confirms a meaningful shift in condition. These labels are intended to highlight a change in market state, not to promise a trade outcome.

The on-chart panel summarizes the active reading using fields such as State, Efficiency, Score Band, Adaptive Bias, Active Zone, and Stability. This gives the user a compact interpretation layer without requiring every decision to be made directly from raw chart inspection.

Key inputs

KAMA Efficiency Length
Controls the lookback used in the KAMA efficiency logic. Lower values react faster. Higher values smooth more noise.

KAMA Fast Response and KAMA Slow Response
Define the adaptive responsiveness range of the KAMA engine.

ATR Length
Used to normalize slope and distance so the tool behaves more consistently across different symbols and volatility conditions.

KAMA Slope Lookback
Controls how the script measures directional slope over time.

Persistence Length
Influences how much consistency price must show around KAMA before a move is treated as more structured.

Efficient Trend Threshold and Noise Threshold
These thresholds help determine when the model classifies a move as higher quality or lower quality.

Zone Band ATR Width
Adjusts the width of the adaptive visual zone.

State Hold Bars
Helps reduce rapid state flipping by requiring a condition to persist before the active state changes.

Panel Font Size and Label Size
Allow visual customization for different chart layouts and monitor sizes.

Alerts

The script includes state-oriented alerts intended to notify the user when market condition changes. These are designed around state transitions and movement-quality shifts rather than promotional “buy now” style messaging.

Examples include bullish and bearish efficiency shifts, transition detection, noise-zone detection, efficiency recovery, efficiency breakdown, and trend strengthening.

Alerts should be interpreted as contextual information. They are intended to support review and analysis, not to function as a standalone decision system.

What this script is not

This script is not a guarantee engine.
It does not predict future price with certainty.
It does not eliminate risk.
It is not a substitute for broader market structure analysis, execution planning, or risk management.

It should not be treated as a self-sufficient entry/exit system without additional confirmation and user judgment.

Limitations and transparency

All adaptive models are sensitive to parameter choices. Changing responsiveness, thresholds, smoothing, or persistence settings can materially affect the way states appear on the chart.

Because the script is state-based, some shifts will naturally occur after the earliest turning point in price. That is part of the tradeoff involved in using confirmation and persistence to reduce noise.

In highly erratic or news-driven conditions, classification can also become less stable. During those periods, transition or noise-oriented readings may occur more often, and users should interpret the visual output in that context.

The script is best viewed as an analytical framework for movement quality and adaptive context, not as a promise of directional success.

Practical use cases

Users may find the script useful for:

• separating cleaner trend phases from mixed or unstable phases
• filtering chart environments before applying another workflow
• evaluating whether direction is gaining or losing efficiency
• adding adaptive context to discretionary analysis
• comparing how different symbols behave around a KAMA-centered efficiency structure

Risk disclosure

This script is for analytical and educational use. It does not provide financial advice, investment advice, or guaranteed outcomes. Market conditions can change quickly, and any indicator can produce false, delayed, or incomplete signals. Users remain responsible for their own decisions, validation process, and risk management.

In short, AG Pro KAMA Efficiency Zones is designed to help read the quality of movement, not just the direction of movement. It uses KAMA as an adaptive reference point and converts that reference into a structured zone and state model so users can assess whether price behavior appears efficient, transitional, or noisy.
Notas de prensa
UPDATE NOTES - V2.3

This update is a presentation-focused refinement for the chart layer of AG Pro KAMA Efficiency Zones. The goal was to make the KAMA map easier to read at a glance, visually more complete on the chart, and more attractive to test without changing the core purpose of the script.

V2.3 keeps the same KAMA-based efficiency framework: the script still uses Kaufman’s Adaptive Moving Average as the adaptive reference, still separates efficient directional travel from noisier price behavior, and still organizes that behavior into the same state structure. This release is primarily about visual hierarchy, chart readability, and cleaner identification of the active adaptive path.

WHAT WAS REFINED

1) New visual intensity control
A new Visual Intensity setting was added so users can choose how bold the on-chart presentation should appear.

Soft:
Keeps the map lighter and more understated.

Premium:
Balances clarity and presence for a richer default look.

Strong:
Pushes the ribbon, fills, and emphasis further for users who want a more pronounced chart display.

This allows the same script to fit different chart styles without changing its underlying analytical role.

2) Richer KAMA ribbon structure
The KAMA zone band now has a more layered visual presentation. Additional outer shell elements were introduced around the existing adaptive band structure so the KAMA area reads more clearly as a reference zone rather than a single isolated line.

This helps the chart communicate the active regime with better visual depth while preserving the original adaptive KAMA concept.

3) Stronger hero KAMA emphasis
The main KAMA path was upgraded visually so efficient trend phases stand out more clearly on the chart. During stronger directional conditions, the active adaptive line now carries more visual authority, which makes the trend path easier to identify without requiring users to inspect the panel first.

4) Better band separation and fill depth
The inner, mid, and outer KAMA areas were rebalanced to improve layer distinction. This makes the zone presentation feel more organized and less flat, especially during efficient trend conditions where visual clarity matters most.

The result is a cleaner premium-style map that still stays readable across busy chart environments.

5) Improved candle tint behavior
Trend candle tint behavior was refined so directional phases can stand out more cleanly while avoiding unnecessary visual heaviness. The presentation is more coherent with the active state colors and better aligned with the rest of the KAMA zone map.

6) Cleaner state label placement
State-change labels were adjusted so they sit more naturally around the active zone structure. This helps reduce the feeling of crowding while keeping state transitions visible when they matter.

7) New active KAMA line tag
A single compact tag can now be shown on the active KAMA line near the latest bar. This was added to make the adaptive reference line immediately identifiable without repeating labels across the chart.

The line tag is intentionally limited to one compact latest-bar marker so the chart stays clean and does not become label-heavy.

8) Line tag now follows Label Size
The active KAMA line tag is now linked to the existing Label Size control. This keeps the chart typography more consistent and prevents the final line tag from feeling disconnected from the rest of the visual layout.

9) Panel contrast and premium polish
The information panel received contrast and palette refinements so the active state, bias, zone, and efficiency rows read more clearly, especially in dark-theme use. The goal here was not to redesign the panel concept, but to improve its legibility and make the panel feel more intentional and better integrated with the rest of the script.

WHAT DID NOT CHANGE

This update is not a methodology rewrite.

The following core components remain aligned with the existing script logic:
- the KAMA efficiency engine
- the state classification framework
- the efficiency score concept
- the main purpose of the script as a KAMA-based efficiency map
- the documented alert structure

In other words, this release improves presentation and user-facing readability while preserving the script’s analytical identity.

WHY THIS UPDATE MATTERS

AG Pro KAMA Efficiency Zones is designed to help users judge whether price is moving with efficient directional quality or drifting in lower-quality noise and reversion conditions. For a script built around visual state recognition, chart presentation matters. A cleaner and more expressive visual structure can improve first-glance understanding, reduce ambiguity, and make the tool easier to work with in live chart review.

V2.3 moves the script in that direction by making the adaptive KAMA path, zone structure, and active state more visually coherent while keeping the script’s role intact.

As always, this script is a decision-support tool. It does not predict future outcomes and should be used alongside context, structure, and risk management.
Notas de prensa
AG Pro KAMA Efficiency Zones [AGPro Series]
Update Notes - V2.3

This update focuses on visual balance, panel standardization, and chart readability.

What was improved:
- Reworked the panel header into the new AG Pro standard with a single merged first row and blue header styling.
- Refined panel presentation for a cleaner compact layout with better visual hierarchy.
- Set the default panel font size to Small for a tighter and more professional footprint.
- Kept chart labels at a Normal default size to preserve readability without making the chart feel crowded.
- Reduced the visual dominance of the KAMA zone structure so price remains the primary focus.
- Softened the outer band layers and reduced excess visual pressure from the ribbon stack.
- Lowered background zone intensity to make state shading less intrusive during live chart reading.
- Rebalanced the hero KAMA highlight so it remains visible without overpowering candles.
- Improved spacing and placement of state labels to reduce overlap with price action.
- Cleaned up the overall chart presentation for a more stable and institutional visual profile.

Behavior and methodology:
- The core KAMA efficiency framework remains intact.
- This update is mainly a presentation, readability, and chart-balance refinement rather than a full engine redesign.
- Efficient trend, transition, and noise/reversion logic continue to follow the same general adaptive structure.

Practical result:
- Cleaner chart reading
- Better candle visibility
- Less overlay congestion
- More consistent AG Pro panel styling
- Stronger visual balance for public release

Limitations and transparency:
- This tool is designed to organize adaptive KAMA behavior into readable market states.
- It does not predict future price movement.
- It should be used as a contextual charting and state-mapping tool, not as a standalone trading system.

Risk disclosure:
This script is for chart analysis and educational use only. It does not provide financial advice, trade guarantees, or automated execution logic.
Notas de prensa
Update Notes - Version 3.0

This update expands the script beyond live KAMA efficiency state detection and introduces a new projected structure called Efficiency Memory Zones.

What is new:

- Added Efficiency Memory Zones that project a rectangular adaptive reclaim or rejection area when an efficient bull or bear trend ends.
- Added first retest detection for fresh memory zones to help users monitor early revisit behavior after an efficient state breaks.
- Updated the panel to the current AG Pro layout standard with a merged blue title row, adjustable position, adjustable theme, and a dedicated Memory Zone row.
- Applied the new naming standard to the published title while keeping AG Pro branding on the panel and short title.
- Refined the KAMA zone rendering, background balance, and label spacing for a cleaner and more premium chart presentation.
- Expanded alert coverage with memory-zone creation, retest, and invalidation events.

What stays the same:

- The script remains centered on KAMA-based adaptive efficiency analysis.
- Core market states are still Efficient Bull Trend, Efficient Bear Trend, Transition, and Noise / Reversion.
- The indicator is still designed as a visual analysis tool rather than a strategy.

Why this matters:

Version 3.0 does not only classify whether price is moving efficiently right now. It also preserves the last efficient adaptive structure after the trend loses quality, giving users an additional way to track reclaim and rejection behavior around the former KAMA path.

Exención de responsabilidad

La información y las publicaciones no constituyen, ni deben considerarse como, asesoramiento o recomendaciones financieras, de inversión, de trading u otro tipo, proporcionadas o respaldadas por TradingView. Obtenga más información en Condiciones de uso.