🌍 Able Heatmap V2.0

# 🌍 Able Global Macro Heatmap V2.0 - User Guide

## Overview
The Able Global Macro Heatmap V2.0 is a comprehensive multi-asset monitoring system that tracks 40 global instruments across equities, bonds, currencies, and commodities in real-time. It provides institutional-grade market regime detection, breadth analysis, and momentum scoring to help you understand global market dynamics at a glance.

## What This Indicator Shows

### 📊 Asset Coverage (40 Instruments)
- **20 Equity Markets**: US (S&P, Nasdaq), Canada, Mexico, Brazil, UK, Germany, France, Switzerland, Spain, Japan, China, Hong Kong, South Korea, Australia, India, Indonesia, Thailand, Singapore, South Africa
- **10 Government Bonds**: US, German, Japanese, UK, French, Australian, Canadian, Indian, Brazilian, Mexican 10-year yields
- **5 Major Currencies**: Dollar Index, EUR/USD, USD/JPY, GBP/USD, USD/CNY
- **5 Commodities/Vol**: Gold, Oil, Copper, VIX, Bitcoin

### 🎯 Key Features

#### 1. **Real-Time Heatmap Display**
- Color-coded performance visualization (deep green = strong gains, deep red = heavy losses)
- Live ranking system (Top 1-5 and Bottom 36-40 highlighted)
- Percentage change display for each asset
- Asset type classification (EQ=Equity, BD=Bond, FX=Currency, CM=Commodity, VL=Volatility)

#### 2. **Market Regime Detection**
Automatically identifies 6 market regimes based on VIX levels and equity performance:
- **BULL-LowVol**: Low volatility uptrend (VIX <15, positive equity performance)
- **EUPHORIA**: High participation rally with elevated VIX (risky)
- **SIDEWAYS**: Range-bound, low conviction market
- **GRINDING**: Slow decline or choppy weakness
- **PANIC**: High volatility selloff (VIX >25, heavy losses)
- **TRANSITION**: Unclear regime between states

Each regime shows a **confidence score** (50-90%) indicating signal reliability.

#### 3. **Breadth Analysis**
Measures how many assets are participating in the move:
- **STRONG** (75%+): Healthy broad-based rally
- **HEALTHY** (60-75%): Good participation
- **NEUTRAL** (40-60%): Mixed market
- **WEAK** (25-40%): Narrow leadership, vulnerable
- **VERY-WEAK** (<25%): Deteriorating internals, warning sign

#### 4. **Momentum Scoring**
Evaluates the strength of directional moves:
- **VV** (Very Volatile): >2% change
- **V** (Volatile): 1.5-2% change
- **M** (Moderate): 1-1.5% change
- **L** (Low): 0.5-1% change
- **VL** (Very Low): <0.5% change

#### 5. **Flow Direction**
Visual indicators showing money flow:
- **UP2**: Strong inflows (>1.5%)
- **UP**: Positive inflows
- **FL**: Flat/neutral
- **DN**: Negative outflows
- **DN2**: Strong outflows (<-1.5%)

## How to Use It

### Setup
1. Add the indicator to any TradingView chart (it runs in a separate pane)
2. Recommended timeframes: 5min, 15min, 1H, 4H, Daily
3. The indicator updates automatically based on your "Update Speed" setting

### Display Settings
- **Show Country Names**: Toggle asset names on/off
- **Show % Change**: Toggle percentage displays
- **Show Rankings**: Toggle ranking numbers
- **Update Speed**: 1-5 (1=fastest, 5=every 5 bars for performance)

### Analysis Layers (Toggle on/off)
- **Show Regime Detection**: Market regime classification header
- **Show Breadth Analysis**: Breadth percentage in header
- **Show Momentum Score**: Momentum strength in header

### Reading the Table

**Header Row (Row 0):**
- **ABLE V2.0**: Indicator name
- **REALTIME**: Status indicator
- **Regime Box**: Current market regime (e.g., "BULL-LowVol", "PANIC")
- **Breadth Box**: Participation level (e.g., "STRONG 78%")
- **Momentum Box**: Overall momentum classification
- **VIX Box**: Current VIX level with color coding

**Column Headers (Row 1):**
- **RANK**: Current performance ranking (1=best, 40=worst)
- **ASSET**: Country/asset name with emoji flag
- **TYPE**: Asset classification
- **CHANGE**: % change with heatmap color
- **MOMENTUM**: Volatility classification
- **FLOW**: Directional flow indicator

**Asset Rows (Rows 2-41):**
Each row represents one asset, sorted by performance (best to worst)

### Chart Plots (Lower Pane)
The indicator plots 4 key metrics:
1. **Green Line (Top 5)**: Average performance of top 5 assets
2. **Red Line (Bottom 5)**: Average performance of bottom 5 assets
3. **Orange Area (Spread)**: Difference between top and bottom performers
4. **Blue Line (Breadth)**: Market breadth centered at zero (-50 to +50 scale)

**Horizontal Reference Lines:**
- Zero line (gray dashed)
- +25 line (green dotted): Strong divergence threshold
- -25 line (red dotted): Negative divergence threshold

## Trading Applications

### 1. **Regime-Based Strategy**
- **BULL-LowVol**: Best environment for trend-following and momentum strategies
- **EUPHORIA**: Take profits, reduce size, expect reversal
- **PANIC**: Wait for stabilization or fade extremes (contrarian)
- **SIDEWAYS**: Mean reversion, range trading
- **GRINDING**: Avoid longs, consider defensive positioning

### 2. **Breadth Confirmation**
- **Strong breadth + Risk-on**: Confirm uptrend continuation
- **Weak breadth + Strong gains**: Warning of narrow leadership, fragile rally
- **Improving breadth + Bottoming**: Early reversal signal
- **Deteriorating breadth + New highs**: Negative divergence, distribution

### 3. **Cross-Asset Analysis**
- **Equities up + Bonds down + Dollar up**: Classic risk-on reflation
- **Equities down + Bonds up + Gold up**: Risk-off flight to safety
- **Everything red except VIX**: Panic liquidation, near-term bottom signal
- **Emerging markets leading developed**: Global growth acceleration
- **Defensive markets (Switzerland, Japan) outperforming**: Rotation to safety

### 4. **Divergence Trading**
- **Spread >5**: Extreme divergence, mean reversion opportunity
- **Top 5 strong + Bottom 5 weak**: Healthy rotation, not concerning
- **Top 5 weak + Bottom 5 weaker**: Broad-based decline, stay defensive
- **Breadth diverging from price**: Early warning of trend change

## Alert Conditions
The indicator includes 7 built-in alerts:
1. **Extreme Divergence**: Spread between top/bottom >5%
2. **Strong Risk-On**: Top 5 >2%, bottom 5 positive
3. **Risk-Off Panic**: All major assets declining
4. **PANIC Regime Detected**: VIX spike with heavy selling
5. **EUPHORIA Regime**: Overheated conditions
6. **Weak Breadth Alert**: <20% participation
7. **Strong Breadth Alert**: >80% participation

### Setting Up Alerts
1. Click the "⏰" icon on your TradingView toolbar
2. Select "Able Global Macro Heatmap V2.0"
3. Choose condition (e.g., "PANIC REGIME")
4. Set notification preferences (popup, email, webhook)

## Volatility Regime Settings
Fine-tune regime detection sensitivity:
- **Volatility Length** (default 20): Lookback period for VIX averaging
- **VIX Low Threshold** (default 15): Below this = low volatility regime
- **VIX High Threshold** (default 25): Above this = high volatility/panic regime

**Adjustments:**
- **More sensitive**: Reduce thresholds (e.g., 12/22)
- **Less sensitive**: Increase thresholds (e.g., 18/28)

## Performance Optimization
If the indicator loads slowly or lags:
1. Increase "Update Speed" to 3-5
2. Toggle off unused analysis layers
3. Use on higher timeframes (4H, Daily)
4. The indicator fetches 40 real-time securities, so some delay is normal

## Best Practices

### Daily Routine
1. **Morning Check**: Review overnight regime and breadth changes
2. **Identify Leaders/Laggards**: Check top 5 and bottom 5 rankings
3. **Cross-Asset Confirmation**: Verify your trading thesis against correlations
4. **Monitor VIX**: Use as risk management overlay

### What to Watch For
- **Regime transitions**: When regime changes, reassess positioning
- **Breadth deterioration**: Leading indicator of trend weakness
- **Extreme readings**: VIX >30, spread >6, breadth <15% or >85%
- **Bond-equity divergence**: Bonds rallying while stocks fall = fear
- **Currency strength**: Dollar strength impacts EM assets and commodities

### Common Patterns
- **Risk-On**: Equities green, bonds red, commodities green, VIX low, dollar mixed
- **Risk-Off**: Equities red, bonds green, gold green, VIX high, dollar up
- **Growth Scare**: Tech/cyclicals weak, defensives strong, bonds rally
- **Inflation Fears**: Bonds red, gold green, commodities green, equities mixed

## Limitations & Disclaimers
1. **Data Delays**: Some exchanges have 10-15min delays on free plans
2. **Weekend Gaps**: Crypto trades 24/7 but others don't - expect distortions Monday
3. **Not Financial Advice**: This is an analytical tool, not trading signals
4. **Requires Context**: Always combine with price action and fundamentals
5. **No Predictive Power**: Shows current state, not future direction

## Troubleshooting

**Problem: Data not loading**
- Check your internet connection
- Verify TradingView subscription level (some data requires Pro+)
- Refresh the chart or reload the indicator

**Problem: Strange values**
- Check if it's during market close or thin liquidity hours
- Some bond symbols may have data gaps depending on provider
- VIX shows strange values pre-market = normal, ignore until 9:30 EST

**Problem: Indicator freezing**
- Reduce update speed to 5
- Use higher timeframe (Daily instead of 1min)
- Restart TradingView browser/app

## Version History
**V2.0 (Current)**
- Added 3 advanced analysis layers (Regime, Breadth, Momentum)
- Enhanced heatmap color grading (10 levels)
- Added chart plots for Top5/Bot5/Spread/Breadth
- Improved ranking system with highlight zones
- Added 7 alert conditions
- Performance optimization

## Support & Feedback
This indicator is part of the Able trading system. For questions or suggestions:
- Tag **@AbleGlobalMacro** on TradingView ideas
- Join the community discussions in the comments
- Report bugs via TradingView's script messaging system

---

**Remember**: This indicator is most powerful when combined with your existing trading strategy, not used in isolation. It shows you *what* is happening globally, but you must decide *how* to trade it based on your risk tolerance, timeframe, and methodology.

Happy trading! 📈🌍