📈 Smart Alert System — EMA/MA/Volume/SMC Alerts

Here's a detailed description of your custom TradingView **Pine Script v6**:

---

### 📌 **Title**: Smart Alert System — Webhook Ready (with EMA, MA, Volume, and SMC)

This script is designed to **monitor price behavior**, detect important **technical analysis events**, and **send real-time alerts via webhook to a Telegram bot**.

---

## 🔧 SETTINGS

| Setting | Description |
| ----------------------- | ------------------------------------------------------------------------------ |
| `volumeSpikeMultiplier` | Multiplier to determine a volume spike compared to the 20-bar average volume |
| `testAlert` | If `true`, sends a test alert when the indicator is first applied to the chart |

---

## 🔍 COMPONENT BREAKDOWN

### 1. **EMA & MA Calculations**

These indicators are calculated and plotted on the chart:

* **EMAs**: 13, 25, 30, 200 — used for trend and touch detection
* **MAs**: 100, 300 — used for break and retest detection

```pinescript
ema_13 = ta.ema(close, 13)
ema_200 = ta.ema(close, 200)
ma_100 = ta.sma(close, 100)
```

---

### 2. **📈 Volume Spike Detection**

* A volume spike is identified when the current bar's volume is **2x (default)** greater than the 20-period average.
* A red triangle is plotted above such candles.
* A **JSON alert** is triggered.

```pinescript
volSpike = volume > avgVol * volumeSpikeMultiplier
```

---

### 3. **📊 EMA Touch Alerts**

* The script checks if the current close is:

* Within 0.1% of an EMA value **OR**
* Has crossed above/below it.
* If so, it sends an alert with the EMA name.

```pinescript
touch(val, crossed) =>
math.abs(close - val) / val < 0.001 or crossed
```

---

### 4. **📉 MA Break and Retest Alerts**

* A **break** is when price falls **below** a moving average.
* A **retest** is when price climbs **above** the same average after breaking below.

```pinescript
breakBelow(ma) => close[1] > ma[1] and close < ma
```

---

### 5. 🧠 **SMC Alerts (Break of Structure \[BOS] & Change of Character \[CHOCH])**

These follow **Smart Money Concepts (SMC)**. The script identifies:

* **BOS**: New higher high in uptrend or lower low in downtrend
* **CHOCH**: Opposite of trend, e.g. lower low in uptrend or higher high in downtrend

```pinescript
bos = (high > high[1]) and (low > low[1]) and (low[1] > low[2])
choch = (low < low[1]) and (high < high[1]) and (high[1] < high[2])
```

---

### 6. 🧪 Dummy Test Alert (1-time fire)

* Sends a `"✅ Test Alert Fired"` to verify setup
* Executes **once only** after adding the indicator

```pinescript
var bool sentTest = false
if testAlert and not sentTest
```

---

### 7. 🚀 Alert Delivery (Webhook JSON)

All alerts are sent as a JSON payload that looks like this:

```json
{
"pair": "BTCUSD",
"event": "🔺 Volume Spike",
"timeframe": "15",
"timestamp": "2024-06-29T12:00:00Z",
"volume": "654000"
}
```

This format makes it compatible with your **Telegram webhook server**.

---

### 🔔 Alerts You Can Create in TradingView

* Set **Webhook URL** to your `xxxx.ngrok-free.app/tradingview-webhook`
* Use alert condition: `"Any alert()`" — because all logic is internal.
* Select **"Webhook URL"** and leave the message body blank.

---

### 🛠️ Use Cases

* Notify yourself on **EMA interaction**
* Detect **trend shifts or retests**
* Spot **volume-based market interest**
* Get real-time **BOS/CHOCH alerts** for Smart Money strategies
* Alert through **Telegram using your Node.js webhook server**

---

Would you like me to break down the full Pine Script block-by-block as well?