AG Pro Cross-Timeframe Value Overlay [AGPro Series]AG Pro Cross-Timeframe Value Overlay
----- OVERVIEW / WHAT IT DOES -----
AG Pro CVO overlays up to three independent rolling value bands — one per
selected higher timeframe — onto a single chart. Each band represents where
price has been accepted on that timeframe over a configurable lookback window.
The script then detects when those bands agree, overlap, or diverge, and
labels the current market structure with one clear state so that cross-
timeframe context is readable at a glance.
Unlike a bias dashboard or a full volume profile, this tool is deliberately
kept compact. It is not meant to replace structural analysis — it is meant
to give a trader a fast visual answer to a single question: "Do the
timeframes I care about agree on what price is worth right now?"
----- UNIQUE EDGE -----
Most multi-timeframe tools either (a) overlay HTF candles, which add noise
and compress price action, or (b) show directional HTF bias with arrows and
backgrounds, which tells you where the HTF trend points but nothing about
the price zone the HTF considers "fair".
AG Pro CVO takes a different angle. It isolates the accepted value zone of
each higher timeframe and layers those zones on the chart with a consistent
opacity hierarchy — the slowest timeframe drawn lightest so it frames the
chart without dominating it. Traders can see in a single glance whether a
level is defended by one timeframe, two, or all three at the same price.
----- METHODOLOGY -----
For each enabled timeframe, the script computes a rolling value band:
center = rolling VWAP over N HTF-bars (or HLC3 SMA if volume is unreliable)
half = ATR over N HTF-bars multiplied by a width factor
band =
The computation is run inside request.security() on the requested timeframe,
so the band reflects that timeframe's own bars — not a reprojection of
chart-timeframe data. Lookahead is set to OFF, so the band values on
historical bars are the values that were actually available at the time.
The state engine then classifies the current relationship between the
enabled bands:
- ALIGNED — All enabled centers cluster within a user-selectable ATR
threshold of their mean.
- OVERLAP — At least one pair of bands shares a price region.
- CONFLICT — At least one pair of bands is fully disjoint and no
alignment condition is met.
- NEUTRAL — None of the above applies.
----- SIGNALS & ALERTS -----
Three alerts are provided:
1. Value Overlap Detected — fires when a new pair of timeframe bands
begins to overlap on the current bar.
2. Higher-Timeframe Value Lost — fires when price closes outside the
dominant (highest enabled) timeframe value band after having been
inside it on the previous bar.
3. Cross-Timeframe Conflict Emerged — fires when the state transitions
into CONFLICT.
These are structural alerts, not entry or exit signals. They are intended
to flag meaningful changes in multi-timeframe agreement so the trader can
review the chart and make a discretionary decision.
----- KEY INPUTS -----
- TF 1 / TF 2 / TF 3 — each timeframe can be enabled independently. The
script never needs all three; two timeframes already produce a valid
overlay.
- Rolling Window — number of bars (on each timeframe) used for the rolling
VWAP and ATR. Higher values produce wider, slower bands.
- Band Width (ATR multiplier) — controls how wide each value band is
around its center. 1.0 ATR approximates a one-sigma accepted zone on
most markets.
- Anchor Method — VWAP + ATR for markets with reliable volume; HLC3 MA
+ ATR for markets without.
- Alignment Strictness — Loose / Standard / Strict thresholds for the
ALIGNED state.
- Show Only Overlapping Bands — hides timeframe bands that are currently
isolated, so only confluence zones remain visible.
- Box Opacity, Band Colors, Label Size, Panel Position, Panel Font Size —
standard AGPro visual controls.
----- HOW TO USE -----
1. Choose the three timeframes that matter for your trading horizon. A
common setup for intraday crypto is 1H / 4H / 1D.
2. Watch for confluence: when price reacts from a region where two or
three bands overlap, that region is being defended by multiple
timeframes at once.
3. Watch for the ALIGNED state: when all enabled centers cluster tightly,
cross-timeframe agreement on "fair value" is high and directional
moves usually require a catalyst.
4. Watch for CONFLICT: when bands have fully separated, timeframes are
pricing very different things and breakouts between the bands tend to
be more directional.
5. Use the alerts as notification triggers, not as entries.
----- LIMITATIONS & TRANSPARENCY -----
- The value bands are rolling — they update as new HTF bars close. On
very recent bars the higher-timeframe band can still be forming.
- request.security() is called with lookahead = OFF. Historical values
reflect only data that was available at the time.
- The script does not predict direction. A band is a descriptive zone,
not a forecast.
- Results depend on the user's choice of timeframes and lookback. Shorter
lookbacks react faster but are noisier; longer lookbacks are smoother
but slower to adapt.
- Volume-based VWAP is only as good as the exchange's reported volume.
On markets where volume is unreliable, use the HLC3 MA + ATR mode.
- This is an indicator, not a strategy. It produces no entries, no exits,
no position sizing, and no backtest.
----- RISK DISCLOSURE -----
This script is provided for educational and research purposes only. It is
not financial advice, not a recommendation, and not a strategy. Trading
involves substantial risk and you can lose more than you invest. Past
behavior of price within any value band does not guarantee future behavior.
Always do your own analysis and manage risk appropriately.
Pine Script® インジケーター






















