OPEN-SOURCE SCRIPT
已更新 Range Control Transfer Map [AGPro Series]
Range Control Transfer Map [AGPro Series]
🧠 Core Idea
Who controls the range now, and did control transfer from the buyer side to the seller side or from the seller side to the buyer side?
📌 Overview / What it does
Range Control Transfer Map is a range-control visualization tool built to study sideways markets where price rotates between upper and lower boundaries.
The script builds a mature range, separates it into buyer-control and seller-control zones, maps the internal control transfer band, tracks acceptance through that band, scores transfer quality, monitors failed-transfer risk, and summarizes the current control state in a compact AG Pro panel.
It does not predict future price, automate trades, or claim that a control-transfer event must continue. It is a structured decision-support map for reading range control, acceptance, failed transfer risk, and next-context conditions.
🎯 Purpose & Design Philosophy
Many range tools answer only one question:
Where are support and resistance?
This script was built to answer a more useful question:
Who controls the range now?
The design goal is to help traders separate passive sideways movement from meaningful control transfer inside a mature range.
⚡ Why This Script Is Different
Most range tools draw a box, mark the high, mark the low, and stop there.
This script does NOT treat every range touch as equally important.
Instead, it divides the range into buyer-control and seller-control halves, watches the midpoint transfer band, checks candle body commitment, reviews volume participation, evaluates range health, and tracks whether the active control side is still protected or starting to fail.
The focus is not only where the range is.
The focus is who is gaining or losing control inside it.
⚙️ Methodology
1. Range Detection
The script identifies a working range using recent high/low structure, ATR-normalized range height, and repeated edge interaction.
2. Range Health Scoring
Range Health combines range height balance, edge-touch behavior, and current position relative to the control line.
3. Control Zone Mapping
The upper half becomes the Seller Control Zone.
The lower half becomes the Buyer Control Zone.
The midpoint area becomes the Control Transfer Band.
4. Transfer Evaluation
When price accepts through the transfer band with enough candle body commitment, the script evaluates whether buyer or seller control has transferred.
5. Transfer Quality Scoring
Transfer Quality combines range health, candle body commitment, and volume participation into a 0-100 score.
6. Failure Risk Review
The script monitors whether the active transfer is losing the transfer band and moving back toward control reset.
7. Visual Output
The chart displays buyer/seller control zones, the control transfer band, active transfer labels, failed-transfer labels, right-side control tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Seller Control Zone = the upper half of the mature range where seller-side control is evaluated.
Buyer Control Zone = the lower half of the mature range where buyer-side control is evaluated.
Control Transfer Band = the internal midpoint band where control handoff is judged.
SELLER CONTROL = price has accepted through the transfer band in favor of the seller side.
BUYER CONTROL = price has accepted through the transfer band in favor of the buyer side.
BALANCE = the range is mature, but neither side has clean active control.
RANGE BUILDING = the current structure is not mature enough for control-transfer mapping.
Panel = summarizes control side, transfer quality, range health, failure risk, control zone, and next context.
🚦 Signals & States
• CONTROL TRANSFER UP → buyer-side control transfer detected.
• CONTROL TRANSFER DOWN → seller-side control transfer detected.
• FAILED BUYER CONTROL → buyer-side transfer failed back through the control band.
• FAILED SELLER CONTROL → seller-side transfer failed back through the control band.
• BUYER EDGE CONTROL → price reacts from the lower control side.
• SELLER EDGE CONTROL → price reacts from the upper control side.
• BALANCE → no clean control transfer is active.
• RANGE BUILDING → the structure is not mature enough yet.
🔔 Alerts Logic
Alerts trigger when a major range-control event appears.
• Buyer Control Transfer → buyer-side transfer detected.
• Seller Control Transfer → seller-side transfer detected.
• High-Quality Control Transfer → transfer quality reaches the required threshold.
• Failed Control Transfer → active control transfer loses the control band.
• Buyer Edge Control → optional alert for lower-edge control reaction.
• Seller Edge Control → optional alert for upper-edge control reaction.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• The range has enough ATR-normalized height
• The range has repeated edge interaction
• Price accepts through the transfer band
• Candle body commitment supports the transfer direction
• Volume participation is not weak
• Transfer Quality is above the required threshold
• Failure Risk remains low after the transfer
• The panel state agrees with the chart label
When these elements do not align, the script avoids treating every range movement as a meaningful control shift.
📊 When to Use
• Range-control review
• Sideways market analysis
• Buyer/seller control mapping
• Failed transfer review
• Range acceptance study
• Crypto, stocks, futures, forex, and liquid markets
• 15m, 30m, 1H, 4H, and 1D charts
⚠️ When NOT to Use
• Very low-liquidity assets
• Extremely noisy micro timeframes
• Strong news spikes that distort range structure
• Clean one-directional trend environments with no mature range
• Markets where every midpoint cross is being over-interpreted
• Situations where a single label is expected to act as a guaranteed signal
🎛️ Key Inputs
• Range Lookback → defines the recent structure window used for range high, range low, and control line.
• Minimum Range Height ATR → defines the minimum range height required for a meaningful control map.
• Maximum Range Height ATR → prevents very wide structures from being treated as clean range-control maps.
• Use Intraday Adaptive Range → allows intraday charts to keep useful control maps without making higher-timeframe charts too noisy.
• Edge Touch Tolerance ATR → controls how close price must come to a range edge to count as an edge interaction.
• Control Band ATR → controls the thickness of the internal transfer band.
• Minimum Transfer Score → defines the quality threshold for meaningful control transfer.
• Minimum Body / Range → controls how much candle body commitment is required.
• Volume Confirm Ratio → defines how much participation is required for full volume credit.
• Failure Buffer ATR → controls where an active transfer starts to fail.
• Maximum Transfer Age → defines how long an active transfer can remain under review.
🖥️ Interface & Visual Design
The visual hierarchy is built around the active range:
The full range box defines the structure.
The upper half shows seller-control territory.
The lower half shows buyer-control territory.
The transfer band marks the internal handoff area.
Event labels mark control transfer and failed-control states.
Right-side tags keep buyer control, seller control, and transfer references visible.
The AG Pro panel compresses the current range-control context into a fast, readable summary.
🧪 Practical Usage Workflow
1. Read the panel Control Side.
2. Check whether the chart is Range Building, Balance, Buyer Control, or Seller Control.
3. Review where price is relative to the Control Transfer Band.
4. If a transfer label appears, compare it with Transfer Quality.
5. Watch whether Failure Risk remains low or starts rising.
6. Use the buyer and seller control zones as context areas, not automatic trade levels.
7. Confirm with broader market structure, liquidity, volume, and risk planning.
🔍 Interpretation Guidelines
A buyer-control transfer does not guarantee upside continuation.
A seller-control transfer does not guarantee downside continuation.
A failed-transfer label means the active control idea weakened.
A range-building state means the structure is not mature enough yet.
The script is best used as a range-control context layer, not as a standalone trading system.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a simple support/resistance box.
It is not another generic range breakout indicator.
⚠️ Limitations & Transparency
Range quality depends on timeframe and market structure.
Very volatile markets can expand beyond a clean control map.
Low-liquidity symbols may create unreliable edge and transfer behavior.
Choppy markets can create repeated control-transfer attempts.
Volume behavior can differ across crypto, stocks, futures, and forex.
🧠 Market Context Notes
Ranges often move through recognizable control phases:
range building → balance → control transfer → defense → failure or continuation.
This script visualizes that sequence so users can avoid treating every support or resistance touch as equally meaningful.
🧾 Use Case Examples
If price accepts through the transfer band from the lower half, the script may mark CONTROL TRANSFER UP.
If price accepts through the transfer band from the upper half, the script may mark CONTROL TRANSFER DOWN.
If an active buyer-control transfer loses the band, the script may mark FAILED BUYER CONTROL.
If an active seller-control transfer loses the band, the script may mark FAILED SELLER CONTROL.
🧱 System Philosophy
The goal is not to predict the next breakout.
The goal is to understand control inside the range.
This script treats range behavior as a sequence:
structure → control zone → transfer band → acceptance → defense or failure.
🔐 Non-Promise Statement
No control-transfer label guarantees continuation.
No failed-transfer label guarantees reversal.
No range zone guarantees support or resistance.
All outputs should be interpreted as analytical context.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical purposes only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are fully responsible for their own decisions, risk management, and trade execution.
📚 Educational Note
Use the script to study how control shifts inside mature ranges.
The most useful question is not only where the range high and low are.
The better question is whether control has actually transferred inside the range.
🧠 Core Idea
Who controls the range now, and did control transfer from the buyer side to the seller side or from the seller side to the buyer side?
📌 Overview / What it does
Range Control Transfer Map is a range-control visualization tool built to study sideways markets where price rotates between upper and lower boundaries.
The script builds a mature range, separates it into buyer-control and seller-control zones, maps the internal control transfer band, tracks acceptance through that band, scores transfer quality, monitors failed-transfer risk, and summarizes the current control state in a compact AG Pro panel.
It does not predict future price, automate trades, or claim that a control-transfer event must continue. It is a structured decision-support map for reading range control, acceptance, failed transfer risk, and next-context conditions.
🎯 Purpose & Design Philosophy
Many range tools answer only one question:
Where are support and resistance?
This script was built to answer a more useful question:
Who controls the range now?
The design goal is to help traders separate passive sideways movement from meaningful control transfer inside a mature range.
⚡ Why This Script Is Different
Most range tools draw a box, mark the high, mark the low, and stop there.
This script does NOT treat every range touch as equally important.
Instead, it divides the range into buyer-control and seller-control halves, watches the midpoint transfer band, checks candle body commitment, reviews volume participation, evaluates range health, and tracks whether the active control side is still protected or starting to fail.
The focus is not only where the range is.
The focus is who is gaining or losing control inside it.
⚙️ Methodology
1. Range Detection
The script identifies a working range using recent high/low structure, ATR-normalized range height, and repeated edge interaction.
2. Range Health Scoring
Range Health combines range height balance, edge-touch behavior, and current position relative to the control line.
3. Control Zone Mapping
The upper half becomes the Seller Control Zone.
The lower half becomes the Buyer Control Zone.
The midpoint area becomes the Control Transfer Band.
4. Transfer Evaluation
When price accepts through the transfer band with enough candle body commitment, the script evaluates whether buyer or seller control has transferred.
5. Transfer Quality Scoring
Transfer Quality combines range health, candle body commitment, and volume participation into a 0-100 score.
6. Failure Risk Review
The script monitors whether the active transfer is losing the transfer band and moving back toward control reset.
7. Visual Output
The chart displays buyer/seller control zones, the control transfer band, active transfer labels, failed-transfer labels, right-side control tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Seller Control Zone = the upper half of the mature range where seller-side control is evaluated.
Buyer Control Zone = the lower half of the mature range where buyer-side control is evaluated.
Control Transfer Band = the internal midpoint band where control handoff is judged.
SELLER CONTROL = price has accepted through the transfer band in favor of the seller side.
BUYER CONTROL = price has accepted through the transfer band in favor of the buyer side.
BALANCE = the range is mature, but neither side has clean active control.
RANGE BUILDING = the current structure is not mature enough for control-transfer mapping.
Panel = summarizes control side, transfer quality, range health, failure risk, control zone, and next context.
🚦 Signals & States
• CONTROL TRANSFER UP → buyer-side control transfer detected.
• CONTROL TRANSFER DOWN → seller-side control transfer detected.
• FAILED BUYER CONTROL → buyer-side transfer failed back through the control band.
• FAILED SELLER CONTROL → seller-side transfer failed back through the control band.
• BUYER EDGE CONTROL → price reacts from the lower control side.
• SELLER EDGE CONTROL → price reacts from the upper control side.
• BALANCE → no clean control transfer is active.
• RANGE BUILDING → the structure is not mature enough yet.
🔔 Alerts Logic
Alerts trigger when a major range-control event appears.
• Buyer Control Transfer → buyer-side transfer detected.
• Seller Control Transfer → seller-side transfer detected.
• High-Quality Control Transfer → transfer quality reaches the required threshold.
• Failed Control Transfer → active control transfer loses the control band.
• Buyer Edge Control → optional alert for lower-edge control reaction.
• Seller Edge Control → optional alert for upper-edge control reaction.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• The range has enough ATR-normalized height
• The range has repeated edge interaction
• Price accepts through the transfer band
• Candle body commitment supports the transfer direction
• Volume participation is not weak
• Transfer Quality is above the required threshold
• Failure Risk remains low after the transfer
• The panel state agrees with the chart label
When these elements do not align, the script avoids treating every range movement as a meaningful control shift.
📊 When to Use
• Range-control review
• Sideways market analysis
• Buyer/seller control mapping
• Failed transfer review
• Range acceptance study
• Crypto, stocks, futures, forex, and liquid markets
• 15m, 30m, 1H, 4H, and 1D charts
⚠️ When NOT to Use
• Very low-liquidity assets
• Extremely noisy micro timeframes
• Strong news spikes that distort range structure
• Clean one-directional trend environments with no mature range
• Markets where every midpoint cross is being over-interpreted
• Situations where a single label is expected to act as a guaranteed signal
🎛️ Key Inputs
• Range Lookback → defines the recent structure window used for range high, range low, and control line.
• Minimum Range Height ATR → defines the minimum range height required for a meaningful control map.
• Maximum Range Height ATR → prevents very wide structures from being treated as clean range-control maps.
• Use Intraday Adaptive Range → allows intraday charts to keep useful control maps without making higher-timeframe charts too noisy.
• Edge Touch Tolerance ATR → controls how close price must come to a range edge to count as an edge interaction.
• Control Band ATR → controls the thickness of the internal transfer band.
• Minimum Transfer Score → defines the quality threshold for meaningful control transfer.
• Minimum Body / Range → controls how much candle body commitment is required.
• Volume Confirm Ratio → defines how much participation is required for full volume credit.
• Failure Buffer ATR → controls where an active transfer starts to fail.
• Maximum Transfer Age → defines how long an active transfer can remain under review.
🖥️ Interface & Visual Design
The visual hierarchy is built around the active range:
The full range box defines the structure.
The upper half shows seller-control territory.
The lower half shows buyer-control territory.
The transfer band marks the internal handoff area.
Event labels mark control transfer and failed-control states.
Right-side tags keep buyer control, seller control, and transfer references visible.
The AG Pro panel compresses the current range-control context into a fast, readable summary.
🧪 Practical Usage Workflow
1. Read the panel Control Side.
2. Check whether the chart is Range Building, Balance, Buyer Control, or Seller Control.
3. Review where price is relative to the Control Transfer Band.
4. If a transfer label appears, compare it with Transfer Quality.
5. Watch whether Failure Risk remains low or starts rising.
6. Use the buyer and seller control zones as context areas, not automatic trade levels.
7. Confirm with broader market structure, liquidity, volume, and risk planning.
🔍 Interpretation Guidelines
A buyer-control transfer does not guarantee upside continuation.
A seller-control transfer does not guarantee downside continuation.
A failed-transfer label means the active control idea weakened.
A range-building state means the structure is not mature enough yet.
The script is best used as a range-control context layer, not as a standalone trading system.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a simple support/resistance box.
It is not another generic range breakout indicator.
⚠️ Limitations & Transparency
Range quality depends on timeframe and market structure.
Very volatile markets can expand beyond a clean control map.
Low-liquidity symbols may create unreliable edge and transfer behavior.
Choppy markets can create repeated control-transfer attempts.
Volume behavior can differ across crypto, stocks, futures, and forex.
🧠 Market Context Notes
Ranges often move through recognizable control phases:
range building → balance → control transfer → defense → failure or continuation.
This script visualizes that sequence so users can avoid treating every support or resistance touch as equally meaningful.
🧾 Use Case Examples
If price accepts through the transfer band from the lower half, the script may mark CONTROL TRANSFER UP.
If price accepts through the transfer band from the upper half, the script may mark CONTROL TRANSFER DOWN.
If an active buyer-control transfer loses the band, the script may mark FAILED BUYER CONTROL.
If an active seller-control transfer loses the band, the script may mark FAILED SELLER CONTROL.
🧱 System Philosophy
The goal is not to predict the next breakout.
The goal is to understand control inside the range.
This script treats range behavior as a sequence:
structure → control zone → transfer band → acceptance → defense or failure.
🔐 Non-Promise Statement
No control-transfer label guarantees continuation.
No failed-transfer label guarantees reversal.
No range zone guarantees support or resistance.
All outputs should be interpreted as analytical context.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical purposes only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are fully responsible for their own decisions, risk management, and trade execution.
📚 Educational Note
Use the script to study how control shifts inside mature ranges.
The most useful question is not only where the range high and low are.
The better question is whether control has actually transferred inside the range.
發行說明
UPDATE NOTES - v1.3This update focuses on measurement and presentation quality.
The core purpose of the script remains unchanged.
This release adds a measured follow-rate layer for control transfers
and tightens internal code style, without touching how the range, the
control band, transfers, or failures are detected.
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
------------------------
- A Transfer Follow layer was added to the panel. Every confirmed
control transfer on the current chart is tracked once: it counts as
followed when price reaches the far edge of the controlled half (the
range edge minus the touch tolerance) before closing back through the
failure line, and as failed when the failure line is reclaimed first
or the tracking window times out. The panel reports the follow rate
with its sample size (for example 54% n=26) and stays neutral until
at least 8 resolved transfers exist, so small samples are never
presented as evidence. Transfer Quality still describes each event's
internal state; the new row shows how such transfers actually
resolved on this chart.
- The tracker freezes the target and failure levels at registration,
so later range drift cannot disturb an open measurement, and it
registers only on confirmed bars so the statistic never repaints.
- The panel title now carries the AG Pro prefix for brand consistency
with the rest of the series.
- Event labels are now anchored to the recent candle cluster extremes
instead of a single bar, with a slightly larger default offset, so
transfer and failure labels no longer sink between candles inside
tight ranges.
- Internal branching expressions were restructured for stricter Pine
v6 style compliance, with identical outputs.
------------------------
Visual Improvements
------------------------
- The panel gained one row while keeping the same width, alignment,
and AGPro surface in both themes, so the information flow remains
balanced.
- Adjusted label positioning to avoid overlap with candles in
compressed range structures.
------------------------
Interface & Usability
------------------------
- No settings were changed, defaults remain identical, and existing
chart layouts are not affected.
------------------------
Behavior Notes
------------------------
This update does not change range maturity detection, the control
band, transfer acceptance, failure logic, edge reactions, labels, or
alerts.
The goal is to back the control-transfer claim with measured history,
not to introduce new predictive behavior.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
The follow rate is measured on the current chart and timeframe only.
It describes how past transfers resolved under this configuration; it
does not guarantee that future transfers will resolve the same way.
Market conditions such as volatility, liquidity, and timeframe
differences may affect how signals and statistics appear.
------------------------
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提供或認可的任何形式的財務、投資、交易或其他類型的建議或推薦。請閱讀使用條款以了解更多資訊。