🎯 VWAP Reclaim v2.3 (Timezone Filter)

🎯 VWAP Reclaim Fighter Jet (v2.3)
This indicator is built to capture high-momentum reversals at the Volume-Weighted Average Price (VWAP). In intraday trading, VWAP acts as the "line in the sand" or the day's fair value.

The "Fighter Jet" strategy is not a simple crossover. It is designed to identify a specific, powerful setup:

The Fight: Price is on one side of VWAP (e.g., bulls are above).

The Attack: The "enemy" (bears) attacks and breaks VWAP with a surge in volume.

The Reclaim: The original side (bulls) immediately fights back on the next candle, "reclaiming" the VWAP level and holding it.

This "reclaim" signals a powerful rejection and a high-probability continuation of the original trend. This script automates the detection of this entire setup.

⭐ Core Features ("Avionics")
A+ Volume Surge Filter: The script doesn't just look for a cross; it demands the reclaim candle is backed by a significant volume surge (e.g., 1.5x the 20-period average, all adjustable). This filters out low-conviction "drifts."

Confirmation Candle Logic: (Default: ON) This is the key to avoiding "fakeouts." The script separates the setup into two parts:

Potential Signal (?): The first high-volume reclaim candle.

Confirmed Signal (🎯): The second candle that also closes on the correct side, confirming that the level is now holding as support/resistance.

User-Defined Timezone Filter (v2.3): The most powerful feature. You can now define your "kill box" time window (e.g., "0930-1130") in your specific timezone (e.g., "America/New_York"), regardless of your chart's or the exchange's setting.

Full Trade Plan: Every confirmed signal (🎯) prints a label with the exact Entry Price, Stop Loss, and Take Profit target.

Dynamic Stop Loss: The Stop Loss isn't static; it's dynamically placed on the other side of VWAP plus a buffer (Stop Offset), making it a logical and relevant stop.

Mission Control HUD: A clean on-screen dashboard gives you a live "A+ Checklist" (Time Window, VWAP Reclaim, Volume Surge, Confirmation) so you can see the setup forming in real-time.

📈 How to Trade (Rules of Engagement)
This is a complete, non-discretionary system. Follow the rules precisely.

1. The Setup (Pre-Flight Check)

Set Your Timezone: Go to settings and set the Timezone to your local trading timezone (e.g., "America/New_York" for EST).

Set Your Session: Define your active trading window in Session Time (e.g., "0930-1130").

Wait: The chart background will turn blue during this "live" session. Do not take signals outside this window.

2. Taking a LONG Trade (Bullish Reclaim)

Condition: Price must first be below VWAP.

Potential Signal (?): A strong bullish candle closes above VWAP. This candle must have a volume surge. A yellow circle (?) will appear. This is your "target acquired" alert—get ready.

Confirmed Signal (🎯): (With Require Confirmation = ON) The very next candle also closes above VWAP. This confirms the buyers have successfully "reclaimed" the line and are holding it as support.

Action: The LONG (▲) signal appears. The label provides the full trade plan.

Stop Loss: Placed below VWAP by your Stop Offset setting.

Target: A fixed point value from your Target Points setting.

3. Taking a SHORT Trade (Bearish Reclaim)

Condition: Price must first be above VWAP.

Potential Signal (?): A strong bearish candle closes below VWAP. This candle must have a volume surge. A yellow circle (?) will appear.

Confirmed Signal (🎯): (With Require Confirmation = ON) The very next candle also closes below VWAP. This confirms sellers have "reclaimed" the line and are holding it as resistance.

Action: The SHORT (▼) signal appears with the trade plan.

Stop Loss: Placed above VWAP by your Stop Offset setting.

Target: A fixed point value.

⚙️ Key Settings ("Flight Controls")
Timezone (CRITICAL): This is the most important setting. Do not leave it blank. You must find the official "TZ Database Name" for your timezone.

New York (EST/EDT): America/New_York

Chicago (CST/CDT): America/Chicago

London (GMT/BST): Europe/London

Session Time: The "HHMM-HHMM" window you want to hunt for setups.

Require Confirmation: (Default: ON) Highly recommended. Turning this OFF will make the strategy much more aggressive, entering on the first reclaim candle (the yellow "?"). This will give more signals, but many will be fakeouts.

Volume Surge Multiple: (Default: 1.5) Your filter for "A+" setups. Higher numbers = fewer, but stronger, signals.

Stop Offset: How much "wiggle room" to give your stop loss around VWAP.

VWAP Buffer: How far price needs to cross VWAP to be considered a "reclaim." This prevents signals from tiny wicks or insignificant crosses.

❓ Frequently Asked Questions (Debrief)
Q: Why didn't a signal appear even though price crossed VWAP? A: This is the script's filtering system working for you. The most common reasons are:

Time Filter: It was outside your defined Session Time.

Volume Filter: The reclaim candle did not have a volume surge.

Confirmation Filter: The reclaim candle (the "?") appeared, but the next candle failed to hold the level (e.g., it closed back below VWAP), invalidating the setup.

VWAP Buffer: The cross was too shallow and didn't clear the VWAP Buffer (e.g., price is just "chopping" on the line).

Q: What is the yellow circle (?)? A: That is the Potential Setup. It is NOT a trade signal. It is an alert to pay attention because the first condition (a high-volume reclaim candle) has been met. Your trade is only valid if the next candle confirms the move (and the 🎯 signal appears).

Q: What's the difference between this and a simple VWAP cross? A: A simple cross is just close > vwap. This strategy is far more robust. It requires price to come from the opposite side (was_below), cross with a volume surge, and then be confirmed by a second candle holding the level. It's a filter for strength and conviction, not just a simple cross.