able HTF

# able HTF - Complete User Guide

## 📱 Overview
This is an advanced **WaveTrend oscillator** with iOS-inspired design aesthetics, featuring multi-timeframe analysis, divergence detection, and the unique **SmartMCDX HTF Convergence System**. It provides institutional-grade market analysis with a clean, modern interface.

---

## 🎯 Core Features

### 1. **WaveTrend Oscillator**
The foundation of this indicator - measures momentum and market cycles:
- **WT1** (Primary line): Fast momentum indicator
- **WT2** (Signal line): Smoothed average of WT1
- **Standard levels**: ±60 (extreme), ±53 (warning)

### 2. **SmartMCDX HTF Convergence System** ⭐
Revolutionary feature that tracks multiple timeframes simultaneously:
- Monitors up to **4 higher timeframes** (4H, Daily, Weekly, Monthly)
- **Convergence histogram** shows alignment strength
- Alerts when 2+ or 3+ timeframes agree (medium/strong convergence)

### 3. **Advanced Divergence Detection**
Three types of divergence analysis:
- **Simple Divergence**: Quick price/indicator disagreements
- **Regular Divergence**: Potential trend reversals
- **Hidden Divergence**: Trend continuation signals

### 4. **Dual Visualization Modes**
- **Traditional Lines**: Classic WT1/WT2 line display
- **Candlestick Mode**: Shows WaveTrend as OHLC candles

---

## 🚀 Getting Started

### Basic Setup (3 Steps)

1. **Add to Chart**: Apply indicator to any timeframe (recommended: 15m - 4H)

2. **Choose Your View**:
- Enable **"Show Traditional Lines"** for standard view
- OR enable **"Show WaveTrend Candlesticks"** for candle view
- OR enable both for comprehensive analysis

3. **Activate HTF Analysis**:
- Enable **"Enable SmartMCDX HTF Histogram"**
- Turn on desired HTF channels (at least 2 recommended)

---

## 📊 Understanding the Display

### Main Oscillator Panel

#### **Reading WT Lines**
```
+60 ━━━━━━━━━ Overbought Zone (Sell signals)
+53 ┄┄┄┄┄┄┄┄┄ Warning Zone
0 ━━━━━━━━━ Neutral Line
-53 ┄┄┄┄┄┄┄┄┄ Warning Zone
-60 ━━━━━━━━━ Oversold Zone (Buy signals)
```

- **Above +60**: Extreme overbought - watch for reversal
- **Above +53**: Warning zone - momentum weakening
- **Between ±53**: Normal trading range
- **Below -53**: Warning zone - oversold conditions developing
- **Below -60**: Extreme oversold - potential bounce

#### **Signal Markers**
- 🔺 **Green Triangle Up**: Strong bullish signal (crossover in oversold)
- 🔻 **Red Triangle Down**: Strong bearish signal (crossunder in overbought)
- ⬤ **Circles**: Crossover points (color indicates direction)
- 💎 **Small Diamonds**: Simple divergence detected
- ⭕ **Large Circles**: Regular/Hidden divergence pivots
- 💠 **"HTF" Diamonds**: SmartMCDX convergence signal (strongest!)

---

## 🎨 SmartMCDX HTF Convergence System

### How It Works

The histogram at the bottom shows **timeframe alignment**:

```
+60 ▓▓▓▓ = All 4 HTFs overbought (strongest sell signal)
+45 ▓▓▓░ = 3 HTFs overbought (strong sell)
+30 ▓▓░░ = 2 HTFs overbought (medium sell)
+15 ▓░░░ = 1 HTF overbought (weak sell)
0 ░░░░ = No alignment
-15 ▓░░░ = 1 HTF oversold (weak buy)
-30 ▓▓░░ = 2 HTFs oversold (medium buy)
-45 ▓▓▓░ = 3 HTFs oversold (strong buy)
-60 ▓▓▓▓ = All 4 HTFs oversold (strongest buy signal)
```

### Reading Convergence Strength

| Bars | HTFs Aligned | Signal Strength | Action |
|------|--------------|-----------------|--------|
| **4 bars** | All 4 timeframes | 🔴 **EXTREME** | Major reversal likely |
| **3 bars** | 3 timeframes | 🟠 **STRONG** | High-probability setup |
| **2 bars** | 2 timeframes | 🟡 **MEDIUM** | Confirm with other signals |
| **1 bar** | 1 timeframe | ⚪ **WEAK** | Wait for more alignment |

### Warning Zone Bars (Optional)
Light-colored bars show timeframes in ±53 warning zones - early indication of developing convergence.

---

## 📋 Info Table Breakdown (Top Right)

### Table Structure
```
╔═ able-WT ═╗ │ 15m │ ████████ │ MCDX │
────────────────────────────────────────
WT1▲ │ 45.2 │ ████░░░░ │ █▓▒░ │
▣SIG │ WAIT │ ░░░░░░░░ │ · │
RSI▼ │ 58 │ ██████░░ │ ▓▒░ │
DIV │ NONE │ ░░░░░░░░ │ · │
X● │ NO │ ░░░░░░░░ │ · │
═HTF═ │ ═CON═│ ████████ │ █ │
OB⚠ │ 2/4 │ ████░░░░ │ ▓▒░ │
OS○ │ 0/4 │ ░░░░░░░░ │ · │
◄MARKET► │ WAIT │ ██░░░░░░ │ ▒░ │
```

### Row Explanations

**1. Header Row**
- **able-WT**: Indicator name
- **15m**: Current timeframe
- **████████**: Activity bar
- **MCDX**: SmartMCDX active

**2. WT1 Row** (▲/▼/► shows trend)
- Current WT1 value
- **Horizontal progress bar**: Position in range (-100 to +100)
- **Vertical gradient bar**: Visual intensity indicator

**3. Signal Row** (▣SIG)
- **◆BUY**: Strong bullish signal active
- **◇SELL**: Strong bearish signal active
- **WAIT**: No clear signal
- Dark background = active signal

**4. RSI Row** (▲/▼ shows momentum direction)
- RSI(14) value
- Highlights when extreme (<30 or >70)

**5. Divergence Row** (DIV)
- **BULL**: Bullish divergence detected
- **BEAR**: Bearish divergence detected
- **NONE**: No divergence

**6. Cross Row** (X)
- **X▲**: Bullish cross just occurred
- **X▼**: Bearish cross just occurred
- **X●**: No recent cross

**7. HTF Convergence Header**
- Separates HTF analysis section

**8. Overbought Row** (OB)
- **🚨**: 3+ HTFs overbought (critical)
- **⚠**: 2 HTFs overbought (warning)
- **○**: <2 HTFs overbought
- Shows ratio (e.g., "2/4" = 2 out of 4 HTFs)

**9. Oversold Row** (OS)
- **🚨**: 3+ HTFs oversold (critical buy zone)
- **⚠**: 2 HTFs oversold (watch closely)
- **○**: <2 HTFs oversold

**10. Market Sentiment Row**
- **HBUY**: HTF strong buy convergence
- **HSELL**: HTF strong sell convergence
- **BULL**: Regular bullish signal
- **BEAR**: Regular bearish signal
- **WAIT**: No clear direction
- Confidence bar shows signal quality (more filled = stronger)

---

## 📈 Trading Strategies

### 🥇 Strategy 1: HTF Convergence Power Plays

**Best for**: Swing trading, position entries

**Setup**:
1. Wait for **3+ HTFs** to reach oversold (OS 🚨) or overbought (OB 🚨)
2. Histogram shows **3-4 bars** stacked
3. **💠 HTF diamond** appears on chart
4. Info table shows **HBUY** or **HSELL**

**Entry**:
- **BUY**: When 3+ HTFs oversold + WT1 crosses above WT2
- **SELL**: When 3+ HTFs overbought + WT1 crosses below WT2

**Why it works**: Multiple timeframes agreeing = institutional-grade confirmation

---

### 🥈 Strategy 2: Enhanced Signal Filter Trading

**Best for**: Intraday trading, quick moves

**Setup**:
1. Enable **"Enhanced Signal Filter"** in settings
2. Watch for signal markers on chart
3. Check info table **▣SIG** row for confirmation

**Entry Rules**:
- **🔺 Green Triangle + ◆BUY in table**: Enter long
- **🔻 Red Triangle + ◇SELL in table**: Enter short
- Must occur in extreme zones (±60)

**Filter**: Built-in RSI filter reduces false signals

---

### 🥉 Strategy 3: Divergence Trading

**Best for**: Catching reversals, counter-trend plays

**Types to trade**:

**Regular Divergence** (Trend Reversal):
- **Bullish**: Price makes lower low, WT1 makes higher low
- **Bearish**: Price makes higher high, WT1 makes lower high
- Look for **large circles** connected by lines

**Hidden Divergence** (Trend Continuation):
- **Bullish**: Price makes higher low, WT1 makes lower low
- **Bearish**: Price makes lower high, WT1 makes higher high
- Look for **dotted lines** connecting pivots

**Entry**: Wait for WT crossover after divergence forms

---

### 🎯 Strategy 4: Multi-Confirmation Scalping

**Best for**: Lower timeframes (5m-15m), active trading

**Perfect Setup** (Take immediately):
1. ✅ WT crossover in extreme zone
2. ✅ 2+ HTFs showing convergence
3. ✅ RSI confirms (<30 for buy, >70 for sell)
4. ✅ Info table shows signal (◆BUY or ◇SELL)
5. ✅ Market sentiment confidence bar >60% filled

**This is your highest-probability trade**

---

## ⚙️ Settings Guide

### WaveTrend Core
```
Channel Length (10): Lower = faster, Higher = smoother
Average Length (21): Signal line smoothing
Over Bought/Sold Levels: Adjust for your market volatility
```

### HTF Channels (The Secret Sauce)

**Recommended Configurations**:

**Conservative** (Lower timeframes):
- HTF 1: 1H
- HTF 2: 4H
- HTF 3: Daily
- HTF 4: OFF

**Balanced** (Most users):
- HTF 1: 4H
- HTF 2: Daily
- HTF 3: Weekly
- HTF 4: OFF

**Aggressive** (Higher timeframes):
- HTF 1: Daily
- HTF 2: Weekly
- HTF 3: Monthly
- HTF 4: Quarterly

### SmartMCDX Histogram Settings

```
Base Bar Height (15): Height of each convergence bar
- Lower (5-10): Subtle, minimal space
- Higher (30-50): Prominent, clear signals

Show Warning Zone: Enable to see ±53 level bars (early alerts)

Convergence Alerts: Get notified of strong alignments
```

### Visualization Options

**Show Traditional Lines**: Classic WT1/WT2 lines
**Show Candlesticks**: OHLC representation of WaveTrend
**Show Divergence**: Enable all divergence types
**Enhanced Signal Filter**: Adds RSI confirmation to signals

---

## 🎨 Color Customization

### Complete Theme Control

The indicator includes **100+ color options** organized by category:

**Main Categories**:
- WT Lines (WT1, WT2, Area fill)
- Level Lines (Zero, OB/OS levels)
- Signal Colors (Bullish, Bearish, Neutral)
- HTF Colors (Convergence bars)
- Divergence Colors (Bull/Bear divergence)
- Table Colors (Header, cells, alerts)
- Background Colors (Trends, convergence zones)

**Popular Themes**:

**Dark Mode Classic**:
- WT1: White
- WT2: Gray
- Signals: Lime/Red
- Background: Dark

**Light iOS Mode** (Default):
- WT1: RGB(28,28,30) - Dark gray
- WT2: RGB(99,99,102) - Medium gray
- Signals: Dark/Light contrast
- Background: Light

**Custom Trading Theme**:
- Use your platform's color scheme
- Match your other indicators
- Optimize for your monitor/lighting

---

## 🔔 Alert System

### Available Alerts

**Signal Alerts**:
- Strong Bullish Signal (filtered)
- Strong Bearish Signal (filtered)
- Simple Divergence (both directions)
- Regular Divergence (both directions)
- Hidden Divergence (both directions)

**HTF Convergence Alerts** ⭐:
- **STRONG HTF CONVERGENCE BUY** (3+ timeframes)
- **STRONG HTF CONVERGENCE SELL** (3+ timeframes)
- Medium HTF Convergence (2 timeframes)

### Alert Setup

1. Enable **"Enable Alerts"** in settings
2. Enable **"Convergence Alerts"** for HTF notifications
3. Click "Create Alert" on TradingView
4. Select "able wt" as condition
5. Choose "Any alert() function call"
6. Set your notification preferences

---

## 💡 Pro Tips & Best Practices

### 1. **HTF Convergence is King**
- Always check the histogram before taking trades
- 3+ bars = institutional-grade setup
- Don't fight strong convergence signals

### 2. **Use the Info Table**
- Quick glance at market conditions
- Vertical bars show intensity visually
- Market sentiment row = overall bias

### 3. **Combine Signal Types**
```
Best Setups (in order):
1. HTF Convergence (3+) + Signal Cross + Divergence
2. HTF Convergence (3+) + Signal Cross
3. HTF Convergence (2+) + Signal Cross + RSI extreme
4. Signal Cross + Regular Divergence
5. Signal Cross in extreme zone
```

### 4. **Timeframe Selection**
- **Lower TF (5m-15m)**: Use closer HTFs (1H, 4H, Daily)
- **Mid TF (1H-4H)**: Use Daily, Weekly, Monthly
- **Higher TF (Daily+)**: Use Weekly, Monthly, Quarterly

### 5. **Avoid These Common Mistakes**
- ❌ Trading without HTF confirmation
- ❌ Ignoring divergence warnings
- ❌ Taking signals in the ±53 to ±60 zones without confirmation
- ❌ Fighting 3+ HTF convergence
- ❌ Not waiting for crossovers to complete

### 6. **Channel Overlay Feature**
Enable **"Show HTF Channel on Chart"** to see:
- Overbought/Oversold zones projected on price
- Dynamic support/resistance from HTF WaveTrend
- Multi-timeframe channel confluence zones

---

## 📊 Advanced Features

### 1. **Divergence Filter**
When **"Use Divergence Filter"** enabled:
- Only shows divergences that occur in extreme zones
- Reduces noise and false signals
- Higher quality setups only

### 2. **Pivot Length Adjustment**
```
Short (5): More frequent divergence signals
Medium (10): Balanced - default
Long (20): Only major divergences
```

### 3. **Line Style Customization**
- Regular Divergence: Solid/Dashed/Dotted
- Hidden Divergence: Solid/Dashed/Dotted
- Helps distinguish types visually

### 4. **Histogram Style**
- **Columns**: Sharp, distinct bars (recommended)
- **Area**: Smooth, flowing appearance

---

## 🎓 Understanding the Math

### WaveTrend Calculation
```
1. Calculate average price (HLC3)
2. Get exponential moving average (EMA)
3. Calculate deviation
4. Normalize to create channel indicator (CI)
5. Smooth CI to create WT1
6. Create WT2 as simple moving average of WT1
```

### HTF Convergence Logic
```
For each higher timeframe:
1. Calculate WaveTrend independently
2. Check if > +60 (overbought) or < -60 (oversold)
3. Count aligned timeframes
4. Stack histogram bars proportionally
5. Alert when 2+ or 3+ timeframes agree
```

---

## 🔧 Troubleshooting

**Problem**: No signals appearing
- **Solution**: Check if "Enhanced Signal Filter" is too restrictive
- Disable filter or adjust RSI thresholds

**Problem**: Histogram not showing
- **Solution**: Enable "SmartMCDX HTF Histogram"
- Make sure at least 1 HTF channel is active

**Problem**: Too many divergence lines
- **Solution**: Enable "Use Divergence Filter"
- Increase "Divergence Pivot Length"

**Problem**: Table not visible
- **Solution**: Enable "Show Info Table"
- Check if table is off-screen (drag chart)

**Problem**: Alerts not firing
- **Solution**: Verify "Enable Alerts" is ON
- Make sure alert is created in TradingView alert panel

---

## 📝 Quick Reference Card

### Signal Strength Hierarchy
```
🥇 Strongest: HTF Convergence (3-4) + Cross + Divergence
🥈 Strong: HTF Convergence (3-4) + Cross
🥉 Good: HTF Convergence (2) + Cross + RSI
4th: Cross + Regular Divergence
5th: Cross in extreme zone
```

### Info Table Quick Read
```
Look for:
- ▣SIG: ◆BUY or ◇SELL (dark background)
- OB/OS: 🚨 emoji (3+ convergence)
- ◄MARKET►: HBUY or HSELL
- Confidence bar >60% filled
```

### Best Entries
```
BUY when:
✓ WT1 crosses above WT2
✓ WT2 below -60
✓ 2+ HTFs oversold
✓ ◆BUY in table

SELL when:
✓ WT1 crosses below WT2
✓ WT2 above +60
✓ 2+ HTFs overbought
✓ ◇SELL in table
```

---

## 🌟 Summary

**WaveTrend iOS Style with SmartMCDX** combines:
- Classic WaveTrend oscillator accuracy
- Multi-timeframe institutional analysis
- Advanced divergence detection
- Beautiful iOS-inspired design
- Comprehensive alert system

**Best for**: Traders who want professional-grade analysis with clean, intuitive visualization.

**Key Innovation**: The SmartMCDX HTF Convergence System provides unique multi-timeframe alignment signals not found in standard indicators.

---

**Happy Trading! 📈**

*Remember: No indicator is perfect. Always use proper risk management, confirm signals with price action, and never risk more than you can afford to lose.*