OPEN-SOURCE SCRIPT
更新済

AG Pro ORB Quality [AGPro Series]

1 665
AG Pro Opening Range Breakout Quality [AGPro Series]

OVERVIEW / WHAT IT DOES

AG Pro Opening Range Breakout Quality is a session-structure indicator built to evaluate how price behaves around the Opening Range rather than treating every early breakout as equally meaningful.

The script defines an Opening Range from a user-selected session window, locks that range when the session window ends, and then tracks whether price breaks above or below that range with constructive follow-through, delayed expansion, weak continuation, retest acceptance, or failure back into the range.

Instead of acting like a simple breakout marker, this tool is designed to help organize the sequence that often matters most after the range is formed:
range construction, first directional break, follow-through quality, retest behavior, acceptance, and failed continuation.

This makes it more useful for traders who want a structured way to study whether the market is truly accepting price outside the Opening Range, or only probing beyond it temporarily.

UNIQUE EDGE

Most Opening Range tools focus mainly on drawing the range and marking the first break.

This script is designed to go one step further by grading the quality of that break and the quality of post-break behavior.

Its main edge is not the box itself. Its edge is the attempt to classify whether the move is:
clean,
good but delayed,
weak,
accepted after retest,
or rejected back into the range.

That makes the script conceptually different from a generic breakout overlay and also different from a broad market-structure or break-retest map. This indicator is specifically anchored to the Opening Range and to the behavior that follows that range.

METHODOLOGY

1) Opening Range Construction
The script builds an Opening Range from the chosen session window and stores:
- range high
- range low
- optional midpoint

2) Break Detection
After the range is locked, the script scans for the first qualified directional break within a defined search window.

3) Quality Engine
Once a break appears, the script evaluates it using a rules-based scoring framework. The score can incorporate factors such as:
- displacement beyond the range
- body efficiency versus wick behavior
- timing of the break relative to the range lock
- optional relative volume context
- directional alignment versus a moving average reference
- post-break extension quality
- retest depth and retest acceptance

4) State Transition Logic
The script then maps price behavior into structured states such as:
- Building Range
- Watching Break
- Bull Break Detected
- Bear Break Detected
- Bull Acceptance
- Bear Acceptance
- Failed Back In
- Range Expired

5) Visual Organization
The chart can display the Opening Range, the active acceptance zone, and projected target levels so that the user can visually compare the range location, the active accepted area, and nearby expansion references.

SIGNALS & ALERTS

The script can generate alerts for:
- break events
- acceptance events
- failure events

These alerts are intended to notify the user when a defined state transition occurs under the script's internal rules.

They should be treated as workflow events, not as standalone trading instructions.

KEY INPUTS

Opening Range
- Session Label
- Opening Range Session
- Timezone
- Engine Timeframe
- Range Extension Bars
- Show Midline

Quality Engine
- Late Break Threshold
- Acceptance Confirmation Bars
- Break Search Window
- Failure Tolerance
- Relative Volume Length
- Use Volume in Score

Projected Targets
- Show Targets
- T1 / T2 / T3
- Target Multipliers
- Target Ray Width
- Target Label Style

Style
- Theme
- State Labels
- Background Tint
- Label Size
- Label Mode
- Hero OR display
- Acceptance Ribbon
- Minimal OR Tag
- Right-side layout controls

Panel
- Panel Position
- Panel Font Size
- Score Meter

HOW THIS SCRIPT IS DIFFERENT

This script is not meant to be a general-purpose support/resistance map, and it is not meant to be a broad break-retest engine applied to every chart structure.

Its scope is narrower by design.

The entire logic is centered on the Opening Range and what happens immediately after that range is established. Because of that, the script is more session-specific and more sequence-specific than many broader structure tools.

It is also not a plain "Opening Range breakout = signal" overlay. A break can still be weak, late, accepted after retest, or rejected back into the range. That distinction is the core of the script.

LIMITATIONS & TRANSPARENCY

This is a rules-based interpretation tool, not a predictive model.

The score is an internal quality estimate derived from the script's selected factors and thresholds. It should not be treated as an objective market truth.

Opening Range behavior can vary significantly by instrument, volatility regime, session participation, and timeframe. A configuration that is useful on one symbol may not behave the same way on another.

Projected targets are reference expansions based on the script's range logic. They are not guarantees, forecasts, or required destinations.

Retest and acceptance behavior are also dependent on the selected engine timeframe. Lower engine timeframes may capture more detail, while higher ones may smooth some intrabar behavior.

Users should review settings carefully and test the script on the instruments and sessions they actually follow.

WHAT IT IS NOT

This script is not:
- a guarantee of breakout continuation
- a promise that every accepted break will trend
- a substitute for independent risk management
- a standalone reason to enter or exit a trade
- financial advice

RISK DISCLOSURE

This indicator is provided for educational and analytical use.

All trading involves risk. Markets can reverse quickly, fail to follow through, or invalidate a setup even when a breakout initially looks constructive.

Use the script as a structured chart-reading aid, not as a certainty engine. Position sizing, stop placement, execution quality, liquidity conditions, and broader market context remain the user's responsibility.

If you use alerts, projected targets, or the quality score in a workflow, they should be interpreted within a broader decision process rather than in isolation.
リリースノート
Update Notes - V1.1

This update focuses on visual structure, signal clarity, and consistency with the current AG Pro presentation standard.

What changed:
- Refined the panel layout to match the current AG Pro standard with a cleaner first-row header structure.
- Set the default panel text size to Small for a more compact and balanced chart view.
- Kept label sizing aligned with the current visual system using Normal as the default label size.
- Improved the right-side range presentation for a cleaner Opening Range display.
- Adjusted line, box, and ribbon styling to reduce chart obstruction and improve candle visibility.
- Smoothed the visual weight of the OR structure so the script remains readable on both active and compressed charts.
- Improved the general balance between state labels, range visualization, and panel readability.
- Applied small logic refinements to help reduce noisier break behavior around the Opening Range.
- Cleaned up presentation details to make the script feel more consistent with the latest AG Pro public releases.

Notes:
- This script is designed as a price-structure and session-behavior analysis tool.
- It does not predict direction and does not guarantee continuation after a breakout.
- Opening Range behavior can vary significantly across symbols, sessions, and volatility conditions.
- Users should evaluate settings based on the instrument, timeframe, and execution style they use.

Risk disclosure:
This indicator is for chart analysis and educational use only. It is not financial advice and should not be treated as a standalone trade decision system.
リリースノート
Update Notes - Version 1.2

- Refined the public title format to match the AGPro Series standard. The published script title is now ORB Quality [AGPro Series], while the on-chart panel keeps the AG Pro identity.
- Added Opening Auction Bias so the script can show whether the session is building with bull tilt, bear tilt, or a more balanced opening auction before the break resolves.
- Added a Drive Lane projection after confirmed acceptance to make post-break continuation space easier to read without turning the chart into a generic breakout dashboard.
- Rebuilt event labels with ATR-based offsets, spacing filters, cooldown control, and a max-visible limit so labels stay premium, readable, and out of the candles.
- Standardized the merged blue header row, panel palette, and right-side tags for a cleaner AGPro presentation.
- Kept the indicator anchored to opening range behavior so it stays distinct from our Daily Open, Inside Bar, Donchian, ATR Envelope, and failed-break scripts.
- Cleaned up comments, visuals, and panel wording for a lighter public-release package.
リリースノート
UPDATE NOTES - v1.3

This update focuses on decision clarity and panel readability.

The core purpose of the script remains unchanged.
This release improves how the existing opening range, breakout-quality,
acceptance, and projection logic is presented and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

- Next Action readout
The summary panel now leads with a plain-language Next Action line that
translates the current opening range state into a single suggested response
(for example Follow Long - Break Accepted, Watch Short - Break Unconfirmed,
Stand Aside - Break Failed, Watch - Range Set, or Wait - Range Building). It
turns the existing state, break, and acceptance readings into one clear
at-a-glance read instead of leaving the reader to combine the rows manually.

- Cleaner numeric quality readout
The old text-based meter row was removed in favor of a cleaner panel. The
Quality row already shows the score and grade together (for example 76 [A]),
so the quality reading is now fully numeric and easier to scan at a glance.

- Adaptive panel contrast
The Next Action cell uses a luminance-aware text color so it stays crisp and
readable across all panel themes.

- Naming alignment
The on-chart short title now follows the standard AG Pro naming format for a
more consistent look in the indicator legend.


------------------------
Visual Improvements
------------------------

- Improved first-glance interpretation by surfacing the most actionable
information at the very top of the panel.

- Refined the panel into a cleaner, fully readable layout by replacing the
text meter with the numeric quality grade.

- Kept the opening range box, drive lane, targets, acceptance ribbon, and event
labels at their existing balanced settings to preserve a premium chart.


------------------------
Interface & Usability
------------------------

- Optimized panel layout for clearer information flow from action to context.

- Improved label readability inside the panel.

- Enhanced overall user experience without changing core logic.


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The session engine, opening range construction, breakout-quality scoring,
acceptance and failure detection, drive lane, and projected targets behave
exactly as before. The Next Action line is a readability layer built directly on
top of those existing outputs.

Users should interpret outputs the same way as before, now with a clearer
summary of the current opening range context.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, session timing, and timeframe
differences may affect how breaks, acceptance, and failures 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が提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。