Crypto Market Breadth Risk Planner [AGPro Series]Crypto Market Breadth Risk Planner
🧠 Core Idea
Is the crypto market showing broad risk-on participation, weakening rotation, or a risk-off breadth environment?
📌 Overview / What it does
Crypto Market Breadth Risk Planner is a chart-first market breadth tool built to evaluate whether a selected crypto basket is participating broadly or weakening internally.
Instead of reading only the active chart symbol, the script reviews a configurable basket of major crypto pairs. It measures how many symbols are trading above their trend baseline, how many have positive momentum, how many have rising trend structure, and how much volatility stress is present across the basket.
The script produces a 0-100 Breadth Risk Score, a colored breadth risk corridor on the active chart, event labels, right-side tags, alerts, and a compact AG Pro panel. It does not predict price direction, automate execution, or claim that breadth alone is enough to trade.
🎯 Purpose & Design Philosophy
This script was built because single-chart analysis can look strong while the broader crypto market is quietly weakening, or look weak while breadth is beginning to rotate back into strength.
The purpose is to help traders read market participation before treating an individual setup as clean. Strong setups usually have a better context when the broader basket is aligned, while weaker breadth can warn that a chart may be more exposed to false follow-through.
The design supports traders who want broader market context without opening ten charts manually. It turns cross-market participation into a simple decision-support layer that can be read directly on the current chart.
⚡ Why This Script Is Different
Most crypto tools focus on the active symbol, a single benchmark, a simple correlation reading, or a raw relative-strength line.
This script does NOT act as a benchmark correlation meter, a relative-strength rotation map, a volume spike detector, or a generic trend dashboard.
Instead, it evaluates breadth across a user-defined crypto basket and converts that participation into a risk-readiness framework. The goal is not to say which coin to buy or sell. The goal is to show whether the broader crypto environment is supportive, mixed, stressed, or risk-off.
⚙️ Methodology
1. Context Detection
The script requests data from a configurable crypto basket and evaluates each symbol on the selected breadth timeframe.
2. Reference Mapping
Each symbol is compared against its own trend baseline, momentum reading, trend slope, and ATR-based volatility stress condition.
3. Reaction Evaluation
The script combines trend participation, momentum participation, slope confirmation, and volatility stress into a single Breadth Risk Score.
4. Visual Output
The final output includes a colored breadth risk corridor, centered corridor text, event labels, right-side tags, optional bar coloring, alerts, and an AG Pro panel.
🗺️ How to Read the Chart
Zones:
The breadth risk corridor is a visual context zone around price. Its color reflects the current breadth regime rather than a direct support or resistance level.
Labels:
Labels mark important breadth state transitions such as Risk-On, Rotation Watch, Risk-Off, Stress Review, and Cooling.
Colors:
Teal represents broad constructive participation.
Pink represents risk-off breadth or weak participation.
Gold represents stress or caution.
Indigo represents improving rotation or transitional breadth.
Panel:
The panel summarizes breadth participation, Breadth Risk Score, momentum, stress, regime, and action state.
🚦 Signals & States
• Risk-On Ready → Broad participation and momentum are strong enough to support risk-on review.
• Rotation Watch → Breadth is improving, but not yet strong enough for full risk-on classification.
• Stress Review → Volatility stress is elevated while breadth quality remains weak.
• Risk-Off → Basket participation is weak or deteriorating.
• Cooling → Stress is easing while breadth quality begins to improve.
• Wait Breadth → No strong breadth regime is currently active.
🔔 Alerts Logic
Alerts can trigger when the basket shifts into Risk-On, Rotation Watch, Risk-Off, Stress Review, or Cooling.
Alerts are attention markers only. They highlight changes in the breadth model. They are not trade instructions, automated entries, or guaranteed market calls.
🧩 Confluence Logic
The context becomes stronger when multiple breadth layers align together.
For example, a high Breadth Risk Score with many symbols above their trend baselines, positive momentum participation, rising trend slopes, and low stress suggests a cleaner risk-on environment than a rally led by only one or two symbols.
Likewise, weak participation combined with elevated stress can warn that individual bullish setups may need stricter review.
📊 When to Use
• Crypto market context review
• BTC, ETH, altcoin, and sector-style crypto watchlists
• 1H, 4H, and 1D market participation analysis
• Before treating individual setups as risk-on
• When the trader wants to know whether the broader crypto basket supports the active chart
⚠️ When NOT to Use
• Markets where selected symbols have unreliable data
• Very small or illiquid crypto pairs with distorted candles
• Situations where the basket does not match the user's trading universe
• Low-timeframe scalping where external-symbol breadth may be too slow
• News-driven events where correlation and breadth can change abruptly
🎛️ Key Inputs
• Crypto Basket Symbols → define the assets used in the breadth model
• Breadth Timeframe → controls whether the basket is evaluated on chart timeframe, 1H, 4H, or 1D
• Trend Baseline Length → controls the EMA reference used for participation
• Momentum Length → controls the ROC window used for positive or negative participation
• ATR Stress Threshold → controls when basket volatility begins to count as stress
• Minimum Risk-On Score → controls how selective the risk-on state should be
• Visual Settings → control corridor, labels, right-side tags, panel location, theme, and font size
🖥️ Interface & Visual Design
The interface is designed to make broad crypto participation readable without turning the chart into a large dashboard.
The corridor gives a fast visual state directly on the chart. The panel provides the structured readout. Labels mark only important transitions, while cooldown and memory controls keep historical events from overwhelming the chart.
The visual intent is premium, clean, and publication-friendly.
🧪 Practical Usage Workflow
1. Read the panel to identify the current breadth regime.
2. Check the Breadth Risk Score and participation percentage.
3. Review whether momentum and stress support or conflict with the active chart setup.
4. Use the corridor color as a market-context layer, not as a direct entry zone.
5. Combine breadth context with price structure, volatility, liquidity, and personal risk rules.
🔍 Interpretation Guidelines
A strong score means the selected crypto basket is broadly aligned according to the script's rules.
A Rotation Watch state means breadth is improving, but the market has not fully confirmed broad risk-on participation.
A Stress Review state means volatility pressure is elevated while breadth remains weak or mixed.
A Risk-Off state means the selected basket is not supporting broad participation under the current settings.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an automated trading system.
This script does not place orders.
This script does not guarantee market direction, continuation, reversal, or profitability.
⚠️ Limitations & Transparency
This script depends on the selected symbols, selected timeframe, and TradingView data availability.
Different baskets can produce different breadth readings. A BTC-heavy basket may behave differently from an altcoin-heavy basket. External symbol data may also load differently depending on market, exchange, and TradingView availability.
The script should be interpreted as market context, not as a standalone execution model.
🧠 Market Context Notes
Crypto often moves through participation waves. Sometimes BTC leads while altcoins lag. Sometimes the whole market rotates together. Sometimes volatility rises while breadth deteriorates, creating a more fragile environment.
This script is designed to make that internal participation easier to observe directly from the active chart.
🧾 Use Case Examples
Example 1:
BTC is breaking higher, but the panel shows weak breadth and high stress. The trader may decide that the move needs extra confirmation before treating it as broad risk-on.
Example 2:
ETH is consolidating, but the basket shifts into Rotation Watch with improving momentum. The trader can monitor whether the active chart begins to align with the broader rotation.
Example 3:
The basket prints Risk-Off while an individual altcoin setup looks technically clean. The script warns that the broader market backdrop is not supportive under the current model.
🧱 System Philosophy
AGPro Series tools are built as decision-support frameworks, not signal vending machines.
This script follows that philosophy by turning broad market participation into a structured context layer: define the basket, score the breadth, map the state, and show the next action clearly.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a risk-on breadth state will produce gains, or that a risk-off state will produce losses. It only organizes participation context so the user can evaluate the broader market with more clarity.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and breadth models can fail or become less useful during sudden volatility, exchange-specific moves, or news-driven repricing. Users remain responsible for their own decisions, execution, and risk management.
This script is for educational and analytical purposes only. It does not provide financial advice.
📚 Educational Note
Use this tool to study how crypto breadth changes before, during, and after major market moves.
Its strongest value comes from comparing the active chart with the broader basket context rather than reading any single label in isolation.
אינדיקטור Pine Script®






















