mql5/Indicators/MyIndicators/Session_Analysis_Pro.md

Session Analysis Pro Suite

1. Summary (Introduction)

The Session Analysis Pro Suite is an advanced set of analytical tools designed to visualize and analyze price action within specific, user-defined trading sessions. It is particularly useful for traders who focus on the dynamics of major market opens (e.g., London, New York, Tokyo).

The suite includes two specialized indicators:

1. Session_Analysis_Pro (Multi-Market): A powerhouse indicator capable of simultaneously analyzing up to three independent markets on a single chart. Ideal for global macro traders monitoring cross-market correlations.
2. Session_Analysis_Single_Pro (Single-Market): A streamlined version focused on a single market, designed for focused intraday trading on specific assets.

For each defined session (Pre-Market, Core, Post-Market, Full Day), both indicators can display:

1. Session Range Box: A rectangle encompassing the high and low of the session.
2. Volume Weighted Average Price (VWAP): The true average price for the session, weighted by volume.
3. Mean Price: The simple arithmetic average of the session's prices.
4. Linear Regression Line: A statistical trendline showing the "best fit" for the session's price action.

Both indicators fully support standard and Heikin Ashi data sources.

2. Calculation Logic

The indicators identify bars belonging to specific time windows and perform distinct calculations on the data within those sessions.

1. Session Range: Identifies the highest High and lowest Low within the session boundaries.
2. VWAP: Calculates the cumulative, volume-weighted average of the Typical Price (H+L+C)/3, resetting at the start of each new session.
3. Mean Price: Calculates the simple arithmetic average of the user-selected Source Price.
4. Linear Regression Line: Calculates the "least squares fit" trendline.

3. MQL5 Implementation Details

Our MQL5 implementation follows a modern, robust, and high-performance hybrid architecture.

• Unified Calculation Engines: Both indicators share the exact same core logic:

  • Session_Analysis_Calculator.mqh: Handles the session timing, box drawing, Mean, and Linear Regression calculations.
  • VWAP_Calculator.mqh: A dedicated engine for high-precision VWAP calculations. This ensures 100% consistency between the Single and Multi versions.

• Hybrid Drawing Architecture:

  • VWAP via Indicator Buffers: VWAP lines are drawn using high-performance indicator buffers (DRAW_LINE) for maximum speed.
  • Boxes & Stats via Graphical Objects: Session boxes and trendlines are drawn using standard graphical objects (OBJ_RECTANGLE, OBJ_TREND), allowing for complex visual overlays.

• Unified Heikin Ashi Integration: When CANDLE_HEIKIN_ASHI is selected, the indicators automatically switch to using smoothed Heikin Ashi data for all calculations (VWAP, Mean, LinReg, and Box High/Low).

• History Optimization: The Max History Days parameter limits the drawing of objects and buffers to the recent past, keeping chart loading times fast and template files small.

4. Parameters

Common Parameters (Both Versions)

• Global Settings:
  • InpFillBoxes: Toggles filled/outline boxes.
  • InpMaxHistoryDays: Limits the history depth (Default: 5).
  • InpVolumeType: Selects Tick Volume or Real Volume for VWAP.
  • InpCandleSource: Selects Standard or Heikin Ashi candles.
  • InpSourcePrice: Source price for Mean/LinReg calculations.

Session Settings

• Pre-Market / Core / Post-Market / Full Day:
  • Enable: Turns the session analysis on/off.
  • Start / End: Session times (HH:MM) based on broker server time.
  • Color: Color for the session's visual elements.
  • Show VWAP / Mean / LinReg: Toggles individual components.

Multi-Market Specific (Session_Analysis_Pro)

• Market 1 / 2 / 3: Master switches to enable/disable entire market configurations.

5. Trading Session Times Reference

This section provides a detailed reference for the trading hours of major global exchanges to help configure the indicator.

IMPORTANT: All times are listed in various time zones for comparison. You must use the times that correspond to your broker's server time in the indicator settings. Be aware that you may need to adjust these times twice a year due to Daylight Saving Time (DST) changes.

---

New York Stock Exchange (NYSE)

• Time Zone: Eastern Time (ET)
• DST (USA) in 2025: Starts March 9, Ends November 2.

Summer (EDT, UTC-4)

Time Zone	Pre-Market	Core Trading	Post-Market
New York (EDT)	06:30–09:30	09:30–16:00	16:00–20:00
UTC	10:30–13:30	13:30–20:00	20:00–00:00
Nicosia (EEST, UTC+3)	13:30–16:30	16:30–23:00	23:00–03:00
Budapest (CEST, UTC+2)	12:30–15:30	15:30–22:00	22:00–02:00

Winter (EST, UTC-5)

Time Zone	Pre-Market	Core Trading	Post-Market
New York (EST)	06:30–09:30	09:30–16:00	16:00–20:00
UTC	11:30–14:30	14:30–21:00	21:00–01:00
Nicosia (EET, UTC+2)	13:30–16:30	16:30–23:00	23:00–03:00
Budapest (CET, UTC+1)	12:30–15:30	15:30–22:00	22:00–02:00

---

London Stock Exchange (LSE)

• Time Zone: GMT / BST
• DST (Europe) in 2025: Starts March 30, Ends October 26.

Summer (BST, UTC+1)

Time Zone	Pre-Market	Core Trading	Post-Market
London (BST)	05:00–08:00	08:00–16:30	16:30–17:15
UTC	04:00–07:00	07:00–15:30	15:30–16:15
Nicosia (EEST, UTC+3)	07:00–10:00	10:00–18:30	18:30–19:15
Budapest (CEST, UTC+2)	06:00–09:00	09:00–17:30	17:30–18:15

Winter (GMT, UTC+0)

Time Zone	Pre-Market	Core Trading	Post-Market
London (GMT)	05:00–08:00	08:00–16:30	16:30–17:15
UTC	05:00–08:00	08:00–16:30	16:30–17:15
Nicosia (EET, UTC+2)	07:00–10:00	10:00–18:30	18:30–19:15
Budapest (CET, UTC+1)	06:00–09:00	09:00–17:30	17:30–18:15

---

Frankfurt Stock Exchange (Xetra)

• Time Zone: CET / CEST
• DST (Europe) in 2025: Starts March 30, Ends October 26.

Summer (CEST, UTC+2)

Time Zone	Pre-Market	Core Trading	Post-Market
Frankfurt (CEST)	08:00–09:00	09:00–17:30	17:30–20:00
UTC	06:00–07:00	07:00–15:30	15:30–18:00
Nicosia (EEST, UTC+3)	09:00–10:00	10:00–18:30	18:30–21:00
Budapest (CEST, UTC+2)	08:00–09:00	09:00–17:30	17:30–20:00

Winter (CET, UTC+1)

Time Zone	Pre-Market	Core Trading	Post-Market
Frankfurt (CET)	08:00–09:00	09:00–17:30	17:30–20:00
UTC	07:00–08:00	08:00–16:30	16:30–19:00
Nicosia (EET, UTC+2)	09:00–10:00	10:00–18:30	18:30–21:00
Budapest (CET, UTC+1)	08:00–09:00	09:00–17:30	17:30–20:00

---

Tokyo Stock Exchange (TSE)

• Time Zone: Japan Standard Time (JST), UTC+9 all year.
• No Daylight Saving Time.

Time Zone	Pre-Market	Core Trading	Post-Market
Tokyo (JST)	08:00–09:00	09:00–11:30	12:30–15:30
UTC	23:00–00:00	00:00–02:30	03:30–06:30
Nicosia	01:00–02:00 (W) / 02:00–03:00 (S)	02:00–04:30 (W) / 03:00–05:30 (S)	05:30–08:30 (W) / 06:30–09:30 (S)
Budapest	00:00–01:00 (W) / 01:00–02:00 (S)	01:00–03:30 (W) / 02:00–04:30 (S)	04:30–07:30 (W) / 05:30–08:30 (S)

---

Sydney Stock Exchange (ASX)

• Time Zone: AEST / AEDT
• DST (Australia) in 2025: Starts October 5, Ends April 6.

Summer (AEDT, UTC+11) (Oct - Apr)

Time Zone	Pre-Market	Core Trading	Post-Market
Sydney (AEDT)	07:00–10:00	10:00–16:00	16:00–19:00
UTC	20:00–23:00	23:00–05:00	05:00–08:00
Nicosia (EET, UTC+2)	22:00–01:00	01:00–07:00	07:00–10:00
Budapest (CET, UTC+1)	21:00–00:00	00:00–06:00	06:00–09:00

Winter (AEST, UTC+10) (Apr - Oct)

Time Zone	Pre-Market	Core Trading	Post-Market
Sydney (AEST)	07:00–10:00	10:00–16:00	16:00–19:00
UTC	21:00–00:00	00:00–06:00	06:00–09:00
Nicosia (EEST, UTC+3)	00:00–03:00	03:00–09:00	09:00–12:00
Budapest (CEST, UTC+2)	23:00–02:00	02:00–08:00	08:00–11:00

---

6. Usage and Interpretation

• Contextual Analysis: Understand price behavior during specific, high-volume sessions.
• VWAP as Benchmark: Price above session VWAP is bullish; below is bearish.
• Fair Value: The Mean and Linear Regression lines provide a statistical "fair value" for the session.
• Support/Resistance: The high and low of the session box act as critical levels for subsequent sessions.