# AlgoPro Bot V3

## AlgoPro Bot V3 — USER GUIDE

<figure><img src="https://2670427150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_7L9oSN_kD-GgM2Hhg%2Fuploads%2FHZObkHCK5sBcExDuC558%2Fv3bot14.png?alt=media&#x26;token=5b1ce20f-4260-4bf4-8d3f-45cc0fbf8cf8" alt=""><figcaption></figcaption></figure>

#### Why AlgoPro Bot V3 is Powerful

* **Confluence engine:** Pick a *Main Trading Signal* and stack confirmations (from the Long/Short Signal Setups) so only high‑quality setups pass.
* **Precision timing:** *Signal Candle Expiry* forces confirmations to agree within a tight window—filters late/early noise.
* **Adaptive exits:** Choose between *TP Methods* (ATR/Percentage/Risk‑Reward/Spread), enable *Trailing TP*, or switch to *Swing Trading Mode* for ATR/MA/HL/Percent/Volume trails.
* **Professional risk rails:** Enforce prop‑style rules in **RISK MANAGEMENT** (intraday loss, max drawdown, streak caps, daily/weekly trade limits) so new entries halt when limits are hit.
* **Session discipline:** Use **TIME FILTERS** for sessions, weekdays, date ranges, custom timezone, and optional *Close at Session End* to avoid off‑hours exposure.
* **Automation‑ready:** Define **Open/TP/Close Commands** once in **TRADE AUTOMATION COMMANDS** and pipe them to alerts/webhooks with `{{strategy.order.alert_message}}`.
* **Clean execution logic:** Global cooldowns, break‑even by bars, opposite‑signal early‑close, and tiered TPs give you granular control over trade lifecycle.
* **Backtest → live continuity:** The same rules you test are the ones that fire alerts—helpful for futures and evaluations where consistency matters.

> **What it is:** AlgoPro Bot V3 is a TradingView **strategy** that lets you build a rules‑based system from multiple signals, strict entry filters, flexible TP/SL (including swing trails), session/time controls, and robust risk limits. It also supports **automation** via alert messages you define.

*This guide maps 1:1 to the titles you see in the Inputs panel.*

***

### 1) How it Operates (Big Picture)

1. You define a **Main Trading Signal** and optional confirmations inside **LONG TRADE SIGNAL SETUP AND SHORT TRADE SIGNAL SETUP**.
2. If the chosen signal and enabled confirmations agree **within your candle expiry window**, a setup qualifies (long or short).
3. **TRADE SETUP** controls sides, cooldown, and early‑close behavior.
4. Exits and trailing come from **TAKE PROFIT METHOD**, **STOP LOSS METHOD**, and **STOP LOSS MANAGEMENT**. **SWING TRADING MODE** can replace fixed TP/SL with swing trails.
5. **TIME FILTERS** and **RISK MANAGEMENT** can restrict trading and halt/flatten based on time and risk rules.
6. **TRADE AUTOMATION COMMANDS** sends your Open/Close messages to alerts/webhooks.

***

### 2)  TRADE AUTOMATION COMMANDS

**Purpose:** Provide the exact alert text to send on entries/exits. In your TradingView Alert, set **Message** to `{{strategy.order.alert_message}}`.

* **Open Long Command**
* **Open Short Command**
* **Long TP1 Command** • **Long TP2 Command** • **Long TP3 Command** • **Long TP4 Command** • **Long TP5 Command**
* **Short TP1 Command** • **Short TP2 Command** • **Short TP3 Command** • **Short TP4 Command** • **Short TP5 Command**
* **Long 100% Close Command (SL, Swing Exit, Early Close)**
* **Short 100% Close Command (SL, Swing Exit, Early Close)**

> Tip: These fields are your automation payloads (plain text or JSON). They’ll be injected into alerts via `{{strategy.order.alert_message}}` when those events fire.

***

### 3)  LONG TRADE SIGNAL SETUP

**Purpose:** Choose the main long signal, set how long its validity lasts, and enable confirmations/filters.

* **Long Signal Candle Expiry** — bars allowed for confirmations to appear after your leading signal.
* **Main Trading Signal (L)** — choose one: *AlgoPro Core System*, *Rational Quadratic Kernel (RQK)*, *Supertrend*, *Half Trend*, *True Strength Indicator (TSI)*, *Trend Direction Force Index (TDFI)*, *Heiken-Ashi Candlestick Oscillator*, *Donchian Trend Ribbon*, *Stochastic*, *RSI*, *Rate of Change (ROC)*, *VWAP*, *CCI*, *B-Xtrender*, *Bull Bear Power Trend*, *Detrended Price Oscillator (DPO)*, *BB Oscillator*, *Chandelier Exit*, *DMI (Adx)*, *Parabolic SAR (PSAR)*, *MACD*, *SSL Channel*, *Waddah Attar Explosion*, *Chaikin Money Flow*, *Vortex Index*, *Schaff Trend Cycle (STC)*, *Awesome Oscillator*, *Volatility Oscillator*, *QQE Mod*, *Hull Suite*.

**Enable/Configure any confirmations (L):**

* **AlgoPro Core System (L)**
* **EMA Filter (L)** + **EMA¹**
* **Rational Quadratic Kernel (L)**
* **SuperTrend (L)**
* **Half Trend (L)**
* **Donchian Trend Ribbon (L)**
* **Rate of Change (L)**
* **True Strength Indicator (L)** + **TSI¹** (Signal Cross / Zero line cross)
* **Trend Direction Force Index (L)**
* **McGinley Dynamic (L)**
* **Detrended Price Oscillator (L)**
* **Heiken-Ashi Candlestick Oscillator (L)**
* **B-Xtrender (L)** + **BX¹**
* **Bull Bear Power Trend (L)** + **BT¹**
* **VWAP (L)**
* **BB Oscillator (L)** + **BB¹**
* **Chandelier Exit (L)**
* **CCI (L)**
* **Awesome Oscillator (L)** + **AO¹**
* **ADX (L)** + **ADX¹**
* **Parabolic SAR (L)**
* **Waddah Attar Explosion (L)**
* **Volatility Oscillator (L)**
* **Damiani Volatility (L)** + **DV¹**
* **Stochastic (L)** + **STOCH¹**
* **RSI (L)** + **RSI¹**
* **RSI MA Direction (L)**
* **MACD (L)** + **MACD¹**
* **SSL Channel (L)**
* **Schaff Trend Cycle (L)**
* **Chaikin Money Flow (L)**
* **Volume (L)** + **V¹**
* **QQE Mod (L)** + **QQE¹**
* **Hull Suite (L)**
* **Vortex Indicator (L)** + **VI¹**

> Each enabled item acts as a confirmation/gate aligned with the selected mode for that indicator (e.g., crossovers, zero‑line, thresholds).

***

### 4)  SHORT TRADE SIGNAL SETUP

**Purpose:** Mirror of the Long setup, for shorts.

* **Short Signal Candle Expiry**
* **Main Trading Signal (S)** — same menu as long.

**Enable/Configure any confirmations (S):**

* **AlgoPro Core System (S)**
* **EMA Filter (S)** + **EMA²**
* **Rational Quadratic Kernel (S)**
* **SuperTrend (S)**
* **Half Trend (S)**
* **Donchian Trend Ribbon (S)**
* **Rate of Change (S)**
* **True Strength Indicator (S)** + **TSI²**
* **Trend Direction Force Index (S)**
* **McGinley Dynamic (S)**
* **Detrended Price Oscillator (S)**
* **Range Detector (S)**
* **Heiken-Ashi Candlestick Oscillator (S)**
* **B-Xtrender (S)** + **BX²**
* **Bull Bear Power Trend (S)** + **BT²**
* **VWAP (S)**
* **BB Oscillator (S)** + **BB²**
* **Chandelier Exit (S)**
* **CCI (S)**
* **Awesome Oscillator (S)** + **AO²**
* **ADX (S)** + **ADX²**
* **Parabolic SAR (S)**
* **Waddah Attar Explosion (S)**
* **Volatility Oscillator (S)**
* **Damiani Volatility (S)** + **DV²**
* **Stochastic (S)** + **STOCH²**
* **RSI (S)** + **RSI²**
* **RSI MA Direction (S)**
* **MACD (S)** + **MACD²**
* **SSL Channel (S)**
* **Schaff Trend Cycle (S)**
* **Chaikin Money Flow** (S)
* **Volume (S)** + **V²**
* **QQE Mod (S)** + **QQE²**
* **Hull Suite (S)**
* **Vortex Indicator (S)** + **VI²**

***

### 5)  TRADE SETUP

* **Long Trades** / **Short Trades** — master side toggles.
* **Close Trades on Opposite Signal** — optional early exit when the other side qualifies.
* **Close Early # Bars** — force close after X bars.
* **Break Even # Bars** — move SL to BE after X bars in the trade.
* **Cool Down # Bars** — wait this many bars before any new trade.
* **Show Take Profit / Stop Loss** — draw TP/SL on chart.

***

### 6)  SWING TRADING MODE

**Purpose:** Replace fixed TP/SL with dynamic swing trailing.

* **Swing Trading Mode -** — master toggle.
* **Swing Trail Method** — *ATR Trail* / *Volume Trail* / *MA Trail* / *HL Trail* / *Percent Trail*.
* **ATR Trail (ʟ / 🇸)** — ATR multipliers for long/short swing stops.
* **Percent Trail (ʟ / 🇸)** — initial % and **P¹ (ʟ / 🇸)** trail decrement.
* **MA Trail (ʟ / 🇸)** — **MA SL Type** and **MA¹ (ʟ / 🇸)** length.
* **High/Low Trail (ʟ / 🇸)** — **HL¹ (ʟ / 🇸)** lookback and source.
* **Vol. Trail (ʟ / 🇸)** — **V¹ (ʟ / 🇸)** momentum / **V² (ʟ / 🇸)** band distance.
* **Swing TP (ʟ / 🇸)** — ATR‑based swing target markers (used to trigger BE/After behaviors below).
* **BE¹ … BE⁵** — move to Break Even after reaching the corresponding Swing TP.
* **After¹ … After⁵** — exit after a higher Swing TP is reached (closes at the prior TP marker).

> Note: Swing TP markers are management levels, not partial TP orders.

***

### 7)  TAKE PROFIT METHOD

* **Take Profit Method** — choose *ATR*, *Percentage*, *Risk Reward*, or *Spread*.
  * **RR TP (ʟ / 🇸)**
  * **ATR TP (ʟ / 🇸)**
  * **Percent TP (ʟ / 🇸)**
  * **Spread TP (ʟ / 🇸)**
* **Trailing TP -** — enable trailing of TP.
  * **TP Trail Speed** — step toward price per bar.

***

### 8)  STOP LOSS METHOD

* **Stop Loss Method** — *ATR*, *True Range*, *Percentage*, *Moving Average*, *High/Low*, *Spread*.
  * **ATR/TR SL (ʟ / 🇸)**
  * **Percent SL (ʟ / 🇸)**
  * **MA SL Type (ʟ / 🇸)** + **MA² (ʟ / 🇸)**
  * **High/Low SL (ʟ / 🇸)** + **HL² (ʟ / 🇸)**
  * **Spread SL (ʟ / 🇸)**
* **Trailing SL -** — enable trailing stop for SL.
  * **SL Trail Speed** — how quickly the SL trails.
* **Stop Loss % Cap -** — cap SL distance in %.
  * **SL Cap (%)** — maximum allowed.

***

### 9)  STOP LOSS MANAGEMENT

* **Enable Move SL to Break Even after TP**
  * **BE after TP¹ / TP² / TP³ / TP⁴**
* **Enable Move SL after each TP is Hit**
  * **Move after TP¹ / TP² / TP³ / TP⁴**

***

### 10)  TAKE PROFIT LEVELS

Enable as many tiers as you want and set how much to close at each level:

* **TP¹** + **%¹**
* **TP²** + **%²**
* **TP³** + **%³**
* **TP⁴** + **%⁴**
* **TP⁵** + **%⁵**

> *% fields* control what portion of the **entire equity/position** to close at each TP.

***

### 11)  TIME FILTERS

* **Close at Session End** — flatten at the end of your trading session.
* **Custom Timezone** + **UTC±** — override chart timezone, if needed.
* **Start From / End To** — restrict backtest/live to a date range.
* **Mon • Tue • Wed • Thu • Fri • Sat • Sun** — select tradable weekdays.
* **Session 1 / Session 2** — define custom trading sessions (e.g., 0700‑1600).

***

### 12)  RISK MANAGEMENT

Limit activity and protect the account during evaluations or live trading:

* **Loss Streak** — cap consecutive losing trades.
* **Win Streak** — cap consecutive winning trades.
* **Row Loss InDay** — cap number of losing days in a row.
* **DrawDown ％** — cap maximum drawdown (as % of strategy equity).
* **InDay Loss ％** — cap intraday loss.
* **Daily Trades** — limit filled orders per day.
* **Weekly Trades** — limit filled orders per week.

> When any enabled limit is breached, new entries halt automatically (and, where applicable, positions can be flattened).

***

### 13) Backtesting & Alerts

* Use **Strategy Tester** to verify performance, behavior of TP/SL/Trails, and effects of **Time Filters** and **Risk Management**.
* For automation, create alerts and set **Message** to `{{strategy.order.alert_message}}`. The strategy will inject the matching **Open/TP/Close** command you defined in **► ＴＲＡＤＥ ＡＵＴＯＭＡＴＩＯＮ ＣＯＭＭＡＮＤＳ ◄**.

***

### 14) Tips

* Start with a single **Main Trading Signal** and a small set of confirmations; add more only if they improve **win quality** without killing valid trades.
* Use **Cool Down # Bars** to prevent over‑trading in chop.
* For prop‑style rules, combine **Close at Session End**, **InDay Loss ％**, **DrawDown ％**, and **Daily/Weekly Trades**.

***

### 15) Glossary (UI‑aligned)

* **Main Trading Signal (L/S)** — the primary trigger engine for entries.
* **Candle Expiry** — time window for confirmations to appear after the leading signal.
* **Confirmations** — additional indicators that must agree with the main signal.
* **Cool Down** — mandatory wait time after a trade.
* **Swing Trading Mode** — dynamic trailing framework using ATR/MA/HL/Percent or Volume trails.
* **Trailing TP/SL** — take‑profit and stop‑loss that move with price or swings.
* **BE (Break Even)** — move SL to entry price after hitting a management level.
* **Time Filters** — sessions, weekdays, date ranges.
* **Risk Management** — limits on losses, drawdown, and trades per period.

*Nothing here is financial advice. Markets carry risk.*