ORB Breakout Strategy w/ Filters - Dynamic Sizing - MTF

Here is a comprehensive description of the strategy, written in a clear and structured format. You can use this for your script's "how-to-use" guide or documentation.

---

## 📈 Opening Range Breakout (ORB) Strategy

This is a comprehensive, multi-timeframe strategy built for trading opening range breakouts. It is designed with a "filters-first" approach, allowing you to validate a breakout with trend, volume, and volatility.

The strategy's core power comes from its flexibility. You can trade on a low timeframe (like a 1-minute chart) while basing your breakout levels on a higher timeframe's opening bar (e.g., the first 15-minute bar). It includes dynamic position sizing based on risk and a wide array of advanced exit management options.

### Key Features

* **Multi-Timeframe Opening Range:** The core of the strategy. You can define the "Opening Range" timeframe (5, 10, 15, 30, or 60 min) *independently* of your chart timeframe.
* **Custom Trading Session:** Define the exact session (e.g., "0930-1600" in "America/New_York") you want to trade.
* **One Trade Per Session:** The strategy will only take the *first valid breakout* signal per day to avoid over-trading.

---

### 🚦 Entry Signals & Filters

A trade is only initiated when the price closes above the Session High or below the Session Low **AND** all active filters are passed.

* **Trend Filter:** (Optional) Requires price to be above a long-term MA (e.g., 100 EMA) for long trades and below it for short trades.
* **Volume Filter:** (Optional) Requires the breakout bar's volume to be a specified multiplier (e.g., 1.5x) of the recent average volume.
* **Volatility Filter:** (Optional) Requires the current ATR to be higher than its long-term average, ensuring you only trade during periods of expanding volatility.
* **Direction Filter:** Allows you to isolate the strategy to **Long Only**, **Short Only**, or **Both**.

---

### 💰 Dynamic Position Sizing

The strategy includes a robust "Risk %" sizing model.

* **Risk-Based Sizing:** Instead of fixed contracts, it calculates the position size based on your **Account Size**, **Risk % per Trade**, and the **Stop Loss distance**.
* **Auto-Detect Point Value:** It automatically detects the correct point value for popular futures contracts (ES, NQ, MES, MNQ) and provides a manual override for other assets.

---

### 📤 Exit & Risk Management

This strategy features a multi-layered exit system, giving you complete control over how trades are managed.

#### 1. Stop Loss (SL)
Your initial stop loss can be calculated using a fixed **Tick** offset or an **ATR** multiplier. It can be anchored from two different points:
* **Breakout Level:** The stop is placed relative to the `sessionHigh` or `sessionLow` level.
* **Entry Bar:** The stop is placed relative to the high/low of the bar that *triggered* the entry.

#### 2. Take Profit (TP)
A standard Take Profit can be set using a fixed **Tick** offset or an **ATR** multiplier.

#### 3. Advanced Exit Logic
These options override the standard Take Profit to allow for more dynamic trade management:

* **Trailing Take Profit (TTP):**
* **Fixed/ATR Trail:** A standard trailing stop that activates after price moves a certain amount in your favor.
* **MA Price Cross:** Exits the trade as soon as the price closes across a fast-moving average (e.g., 9-EMA).
* **MA Crossover:** Exits the trade as soon as a fast MA crosses below a slow MA (for longs) or above (for shorts).
* **Close on Reversal:** (Optional) Exits immediately if the **very next bar** after entry closes back *inside* the opening range (a "failed breakout" signal).
* **Close on Opposite Range Cross:** (Optional) Exits a long trade if the price ever closes below the `sessionLow` (and vice-versa for shorts).
* **End of Session Exit:** All open positions are automatically closed at the end of the defined trading session.