ASR / ADR by Vanya_zvwey

🇺🇦 Детальний Опис та Інструкція Користувача Індикатора ASR/ADR Grid

Цей індикатор є інструментом для візуалізації волатильності, який використовує історичні дані для прогнозування потенційних цінових рівнів розширення та корекції. Він будує сітки на основі середнього діапазону сесії (ASR) та середнього денного діапазону (ADR).

🔑 Ключові Концепції
ASR (Average Session Range): Середній діапазон High-Low, який зазвичай досягається протягом обраної торгової сесії (Азія, Лондон, Нью-Йорк) за останні N днів.
ADR (Average Daily Range): Середній діапазон High-Low, досягнутий протягом цілого 24-годинного торгового дня за останні N днів.
Синхронізація Часового Поясу: На відміну від багатьох індикаторів, цей індикатор залежить від введеного саме вами Session Timezone. Він гарантує, що ваші сесії та денні відкриття розраховуються правильно, незалежно від часового поясу вашого графіку.

⚙️ Посібник із Налаштування (Вхідні Параметри)
Налаштування згруповані для зручності:

1. General Settings (Загальні Налаштування)
Session Timezone: Виберіть часовий пояс, який використовуватиметься як єдиний орієнтир для всіх часів Start/End. Це може бути "UTC+2", "America/New_York" тощо.
Lookback Period (Days): Кількість днів, що використовується для обчислення середнього значення ASR та ADR.
Grid Direction:
"Up": Сітки будуються від поточного Low сесії/дня і розширюються вгору.
"Down": Сітки будуються від поточного High сесії/дня і розширюються вниз.
Grid Step %: Крок для внутрішніх ліній сітки (наприклад, 25% дасть лінії 25%, 50%, 75%).

2. Session Settings (Asia, London, New York)
Show [Session]: Увімкнення/вимкнення відображення сітки для конкретної сесії.
Start Time (HH:MM) / End Time (HH:MM): Час початку та кінця сесії, який відповідає вибраному вами Session Timezone.

3. ADR (Daily) Grid (Сітка Денного Діапазону)
Show ADR Grid: Увімкнення/вимкнення сітки, що охоплює весь день.
ADR Anchor: Визначає, від якої ціни починається відлік ADR (0%):
"Day Open": Як якір використовується ціна відкриття дня (00:00 у вашому часовому поясі).
"Day Low/High": Як якір використовується поточний денний екстремум (Low, якщо напрямок "Up", або High, якщо напрямок "Down").

📈 Використання та Інтерпретація
Сітка складається з рівнів від 0% до 100%, які візуалізують, наскільки далеко ціна просунулася щодо середнього історичного діапазону.

Структура Сітки
0% Рівень (Границя): Це якірна точка (High або Low) поточної сесії/дня, з якої починається розрахунок. Лінія суцільна.
100% Рівень (Границя): Це ціновий рівень, що дорівнює 0% Якір + ASR/ADR. Це статистично очікуваний максимальний рух. Лінія суцільна.

Внутрішні Рівні (Grid Step): Пунктирні лінії (25%, 50%, 75% тощо), які показують проміжні цілі або зони корекції.

Торгова Інтерпретація
Рух до 50%: Ціна досягла половини середнього діапазону.
Досягнення 100%: Ціна досягла "середнього" діапазону волатильності. Це часто служить хорошою ціллю для фіксації прибутку або точкою, де можна очікувати корекції/розвороту, оскільки рух вже відповідає історичним нормам.
Рух за межі 100% (Екстремум): Рух, що перевищує 100% ASR/ADR, вважається нетипово сильним або екстремальним.

🇬🇧 Detailed Description and User Guide for the ASR/ADR Grid Indicator
This indicator is a robust volatility visualization tool designed to project potential price extension and retracement levels based on historical data. It constructs price grids using the Average Session Range (ASR) and the Average Daily Range (ADR).

🔑 Key Concepts
ASR (Average Session Range): The average High-to-Low range typically achieved during a selected trading session (Asia, London, New York) over the last N days
ADR (Average Daily Range): The average High-to-Low range achieved during the entire 24-hour trading day over the last N days.

Timezone Synchronization: This is critical. The indicator relies on a single Session Timezone input to correctly calculate all session start/end times and daily opens, ensuring accuracy regardless of your charting platform's native exchange time.

⚙️ Setup Guide (Input Parameters)
The settings are organized into logical groups:

1. General Settings
Session Timezone: Select the timezone that will serve as the single reference point for all Start/End times below (e.g., "UTC+2", "America/New_York").
Lookback Period (Days): The number of preceding days used to compute the average ASR and ADR values.

Grid Direction:
"Up": The grids are anchored at the current session/day's Low and extend upwards.
"Down": The grids are anchored at the current session/day's High and extend downwards.
Grid Step %: The percentage increment for the inner grid lines (e.g., 25% will plot lines at 25%, 50%, 75%).

2. Session Settings (Asia, London, New York)
Show [Session]: Toggles the visibility of the grid for that specific session.
Start Time (HH:MM) / End Time (HH:MM): The start and end times for the session, which must correspond to your chosen Session Timezone. The script supports overnight sessions (e.g., starting at 22:00 and ending at 02:00 the next day).

3. ADR (Daily) Grid
Show ADR Grid: Toggles the visibility of the grid covering the entire trading day.
ADR Anchor: Determines the price point from which the ADR (0%) is measured:
"Day Open": The anchor is the day's opening price (at 00:00 in your chosen timezone).
"Day Low/High": The anchor is the current day's extreme (Low if Direction is "Up", or High if Direction is "Down").

📈 Usage and Interpretation
The grid levels, ranging from 0% to 100%, visualize how far the price has traveled relative to the average historical volatility for that specific period.

Grid Structure
0% Level (Border): This is the anchor point (High or Low) of the current session/day, serving as the starting reference for the calculation. This line is solid.
100% Level (Border): This is the price level equal to the 0% Anchor + ASR/ADR. It represents the statistically expected average maximum move. This line is also solid.
Inner Levels (Grid Step): These dotted lines (25%, 50%, 75%, etc.) serve as intermediate targets or potential zones for pullback.

Trading Interpretation
Reaching 50%: The price has achieved half of the average range.
Reaching 100%: The price has fulfilled the "average" volatility range. This level often acts as an excellent profit target or a point where you might expect correction or reversal, as the move has met historical norms.
Moving Beyond 100% (Extreme): A price move that exceeds 100% ASR/ADR is considered unusually strong or extreme volatility.