Phoenix Range Detector

Про індикатор

Phoenix Range Detector знаходить на графіку тихі відрізки. На цих відрізках ціна тримається у вузькій смузі. Індикатор малює кожен такий відрізок як прямокутник або як похилий канал.

Кнопки й налаштування самого графіка написані англійською.

Щоб додати його, натисніть Indicators («Індикатори») вгорі графіка в KAGAMI. Він у групі KAGAMI і називається Phoenix Range Detector. На графіку його назва показується як Phoenix RD.

Цього індикатора поки немає в списку Indicators у кожному обліковому записі.

KAGAMI розраховує малюнки на власних серверах. Він дотримується правил оригінального скрипту, написаного для TradingView.

Що ви бачите на графіку

Свічка (або бар) — це один відрізок часу на графіку, наприклад 15 хвилин. Діапазон — це низка свічок, які тримаються у вузькій смузі.

• Золотий прямокутник — це рівний діапазон. Усередині нього ціна рухалася вбік.
• Світло-синій канал — це похилий діапазон. Він має два суцільні сині краї з ледь помітною синьою заливкою між ними.
• Червона пунктирна лінія йде посередині. Вона позначає половину висоти.
• Дві точкові лінії позначають чверті: на чверті й на трьох чвертях висоти.
• Невелика мітка стоїть угорі, на правому кінці. На ній написано STATIC для прямокутника і DYNAMIC для каналу.

Найновіший діапазон росте з кожним закриттям свічки. Його правий край рухається разом із графіком.

Коли діапазон закінчується, змінюється ось що:

• Свічка закрилася вище за нього: він стає зеленим.
• Свічка закрилася нижче за нього: він стає червоним.
• Він просто вичерпався, бо став надто довгим чи надто широким: він зберігає свій колір.
• Канал отримує короткі пунктирні лінії. Вони продовжують його ще на дві свічки.
• Тонка пунктирна лінія йде праворуч від верху чи низу діапазону. Вона зупиняється, коли свічка закривається крізь неї, або через 100 свічок.

Одночасно росте лише один діапазон. Діапазони ніколи не перекриваються.

Як його часто читають трейдери

• Багато трейдерів називають відрізок руху вбік діапазоном або консолідацією.
• Багато трейдерів бачать у верху й низу діапазону ціни, на яких рухи зупинялися раніше.
• Деякі трейдери стежать за кольором, якого набуває діапазон. Він показує, з якого боку закрилася свічка, коли діапазон закінчився.
• Деякі стежать за пунктирною лінією після кінця діапазону. Вони дивляться, чи повертається до неї ціна.
• Деякі користуються середньою лінією. Вона показує, чи ціна у верхній, чи в нижній половині.

Індикатор лише описує минулі ціни. Він не може передбачити майбутнє.

Налаштування

Цей індикатор не має налаштувань, які можна змінити. Він завжди використовує ті самі фіксовані значення:

• Новий діапазон охоплює 10 свічок. Діапазон триває щонайбільше 150 свічок.
• Новий діапазон може бути заввишки щонайбільше 2 ATR.
• ATR означає average true range — середній справжній діапазон. Це середній розмір руху однієї свічки за останні 14 свічок.
• Діапазон, що росте, може трохи розширюватися, до 2,4 ATR.
• Діапазон закінчується, коли свічка закривається за його краєм більш ніж на 0,15 ATR.
• Кольори: золотий для прямокутників, світло-синій для каналів, зелений і червоний, коли діапазон закінчується.

Коли індикатор може ввести в оману

• Він знаходить діапазони заднім числом. Діапазон з'являється, лише коли всередині нього закрилися 10 свічок. Тож він починається на 10 свічок назад.
• Найновіший діапазон ще може змінитися. Доки він не закінчився, його верх, низ, нахил і тип можуть змінюватися з кожним закриттям.
• Колір — це не тренд. Зелений чи червоний лише каже, де закрилася одна свічка. Ціна може незабаром повернутися всередину.
• Великі свічки розтягують правила. Усі обмеження залежать від ATR. Коли свічки великі, навіть широка смуга рахується вузькою.
• Крихітні свічки їх звужують. Коли ринок дуже тихий, невеликий рух може закінчити діапазон.
• Розриви рахуються як рухи. Стрибок між свічками, як-от нічний стрибок акції, може закінчити діапазон.
• Свічка, що формується, не враховується. Свічка, що ще формується, не рахується, доки не закриється.
• Старі малюнки можуть відрізнятися. На крайньому лівому краї малюнки можуть не збігатися з TradingView. KAGAMI може читати менше минулих свічок.

Графіки — для навчання. Це не порада. Прочитайте наше Застереження щодо ризиків.

Приклад

Візьмімо NASDAQ:AAPL на 15-хвилинному графіку. Кожна свічка — це 15 хвилин. Числа нижче вигадані.

1. Припустімо, ATR дорівнює 0,50 і не змінюється.
2. Протягом 10 свічок AAPL рухається вбік між 100,00 і 100,80. Смуга має висоту 0,80.
3. Обмеження — 2 × 0,50 = 1,00. Смуга вміщається, тож з'являється золотий прямокутник STATIC.
4. Усередині закривається більше свічок. Прямокутник росте вправо.
5. Потім свічка закривається на 100,90. Верх прямокутника — 100,80.
6. Рівень пробою — 100,80 + 0,15 × 0,50 = 100,875. Ціна закриття вища за нього.
7. Діапазон закінчується, і прямокутник стає зеленим. Він закінчується на свічці перед пробоєм.
8. Від низу прямокутника, на 100,00, праворуч іде зелена пунктирна лінія.
9. Ця лінія зупиняється на першому закритті нижче 99,925 або через 100 свічок.

Технічні деталі

Ця частина подає точні правила для читачів, яким вони потрібні. Кожне правило застосовується лише до закритих свічок, по одній свічці, від найстарішої свічки, яку читає KAGAMI, до найновішої.

Розрахунок

Терміни, якими користуються правила:

• Справжній діапазон свічки = найбільше з high − low, |high − previous close| і |low − previous close|. На найпершій свічці це high − low.
• ATR = середня Вайлдера від справжнього діапазону за 14 свічок. Перший ATR — це звичайна середня перших 14 справжніх діапазонів. Далі ATR = (true range + 13 × previous ATR) ÷ 14. Перші 13 свічок не мають ATR.
• Середина свічки = (high + low) ÷ 2.
• Лінія підгонки = пряма лінія найменших квадратів через середини свічок діапазону (формули нижче).
• Верхній відступ = найбільше значення high − fit(x) серед свічок діапазону. Нижній відступ = найменше значення low − fit(x) (зазвичай менше за нуль). Краї каналу — це fit(x) + upper offset і fit(x) + lower offset, тож вони торкаються справжнього найвищого максимуму й найнижчого мінімуму навколо лінії.
• Статична висота = найвищий максимум − найнижчий мінімум свічок діапазону.
• Динамічна висота = верхній відступ − нижній відступ.
• Дрейф = |slope| × (n − 1) — наскільки лінія підгонки піднімається чи опускається на всьому діапазоні.
• Рівний: дрейф ≤ 0.35 × the larger of (static height, tick size).
• Розмір тіку = найменший крок ціни. KAGAMI бере 0.01 для акцій США (0.0001, коли остання ціна закриття нижче 1) і одну одиницю цінової точності графіка для всіх інших ринків. Він важить лише в перевірці на рівність.

Лінія підгонки: пронумеруйте свічки діапазону x = 0, 1, 2 … від його першої свічки, де y = середина свічки, а n = кількість свічок. Тоді:

• slope = (n × Σxy − Σx × Σy) ÷ (n × Σx² − (Σx)²), або 0, коли знаменник цього дробу дорівнює 0
• start = (Σy − slope × Σx) ÷ n
• fit(x) = start + slope × x

ATR у кожній перевірці нижче — це ATR свічки, яку оцінюють.

Початок діапазону

На кожній закритій свічці, поки жоден діапазон не росте:

1. Перед цією свічкою має бути щонайменше 10 свічок.
2. Вікно — це ця свічка і 9 свічок перед нею: 10 свічок. Вікно має починатися після останньої свічки попереднього діапазону.
3. Розрахуйте лінію підгонки, статичну висоту й динамічну висоту на вікні.
4. Статичний підходить, коли статична висота ≤ 2.0 × ATR. Динамічний підходить, коли динамічна висота ≤ 2.0 × ATR.
5. Коли підходить будь-який із них, діапазон починається на першій свічці вікна.
6. Він динамічний, коли динамічний підходить, і або статичний не підходить, або вікно не рівне й динамічна висота ≤ 0.85 × static height. Інакше він статичний.

Після того як діапазон закінчився, наступне вікно може початися щонайраніше на свічці, яка його закінчила. Тож наступний діапазон може з'явитися щонайраніше через 9 свічок після кінця.

Ріст або кінець діапазону

На кожній наступній закритій свічці, де n = кількість свічок від першої свічки діапазону до цієї:

1. Розрахуйте лінію підгонки заново разом із цією свічкою. Статична висота тепер теж враховує максимум і мінімум цієї свічки.
2. Обмеження — 2.0 × ATR × 1.20, тобто 2.4 × ATR.
3. Статичний підходить, коли статична висота ≤ обмеження. Динамічний підходить, коли динамічна висота ≤ обмеження.
4. Пробій угору: ціна закриття > попередній верх + 0.15 × ATR. Пробій униз: ціна закриття < попередній низ − 0.15 × ATR. Попередній означає діапазон таким, яким він був після останньої свічки: верх і низ прямокутника або краї каналу на останній свічці.
5. Допуск для тіней, лише поки діапазон статичний: прямокутник усе ще підходить, коли пробою немає і статична висота ≤ обмеження + 0.60 × ATR (тобто 3.0 × ATR). Тінь може виходити назовні й розтягувати прямокутник; пробиває його лише закриття за його межами.
6. Діапазон закінчується, коли він уже містить 150 свічок (n > 150), або стається пробій угору чи вниз, або не підходить ні статичний (із допуском для тіней), ні динамічний.
7. Інакше ця свічка приєднується до діапазону. Прямокутник охоплює її максимум і мінімум, а лінія підгонки оновлюється.
8. Тип визначається заново: динамічний, коли динамічний підходить, і або статичний (із допуском для тіней) не підходить, або діапазон не рівний і динамічна висота ≤ 0.85 × static height. Інакше — статичний.

Тож діапазон, що росте, може перемикатися між STATIC і DYNAMIC, а разом із тим і змінювати колір.

Що малюється

Поки діапазон росте, він малюється заново на кожній закритій свічці, від його першої свічки до найновішої закритої свічки.

Мітка вказує вниз на своє місце. Вона залита кольором діапазону з прозорістю 15%, з білим текстом #FFFFFF дрібного розміру. На низхідному каналі мітка висить над правим кінцем каналу, на висоті його лівого кінця.

Коли діапазон закінчується

Завершений діапазон зберігає малюнок із попередньої свічки. Його правий край — це остання свічка всередині нього; свічка, яка його закінчила, до нього не входить. Далі:

1. Перефарбування, лише після пробою. Рамка й заливка прямокутника, краї й заливка каналу, лінії 25% і 75% та мітка стають бірюзово-зеленими #26A69A після пробою вгору або червоними #EF5350 після пробою вниз. Вони зберігають свою прозорість (заливка 92%, лінії чвертей 40%, мітка 15%). Лінія 50% залишається червоною. Мітка зберігає своє слово.
2. Проєкція, лише для динамічного діапазону. Дві пунктирні лінії завширшки 2 пкс продовжують верхній і нижній краї з тим самим нахилом, від останньої свічки всередині до точки на 2 свічки пізніше. Вони отримують остаточний колір: зелений, червоний або світло-синій, коли діапазон просто вичерпався. Червона точкова лінія завширшки 1 пкс так само продовжує лінію 50%. Проєкція закінчується через одну свічку після свічки, яка закінчила діапазон.
3. Рівні: стеля й підлога можуть і далі йти праворуч (нижче).

Стеля — це верх діапазону на його останній свічці; для каналу — значення верхнього краю там. Підлога — це низ, так само.

• Стеля йде далі, коли свічка, що закінчила діапазон, не закрилася вище ceiling + 0.15 × ATR. Підлога йде далі, коли вона не закрилася нижче floor − 0.15 × ATR.
• Тож після пробою вгору йде лише підлога, після пробою вниз — лише стеля, а коли діапазон просто вичерпався, ідуть обидві.
• Рівень — це горизонтальна пунктирна лінія завширшки 1 пкс остаточного кольору з прозорістю 20%. Для каналу вона теж горизонтальна.
• На кожній наступній закритій свічці рівень дотягується до цієї свічки. Він зупиняється на першій свічці, яка закривається вище ceiling + 0.15 × ATR (для стелі) або нижче floor − 0.15 × ATR (для підлоги), або через 100 свічок після останньої свічки діапазону.
• Зупинений рівень залишається на графіку там, де зупинився.

Скільки малюнків залишається

Кожен завершений діапазон залишається на графіку. KAGAMI зберігає обмеження оригінального скрипту: 500 прямокутників, 500 ліній і 500 міток. Понад 500 одного виду прибирається найстаріший малюнок цього виду, хоч би якому діапазону він належав. Заливка каналу зникає, коли зникає будь-який із його країв.

Першими закінчуються лінії. Статичний діапазон залишає до 5 ліній, динамічний — до 10. Тож на довгій історії найстаріші діапазони ліворуч першими втрачають свої лінії. Прямокутник може залишитися без своєї лінії 50%.

Вхідні параметри

KAGAMI не показує вхідних параметрів для цього індикатора. Він завжди використовує значення оригінального скрипту за замовчуванням:

Чого немає в KAGAMI:

• зміни будь-якого зі значень вище;
• групи Moving Averages оригіналу (MA type, Source, Line width і три ковзні середні на 20, 50 і 200 свічок). В оригіналі вони за замовчуванням вимкнені. KAGAMI їх не малює.

Коли значення змінюються

• KAGAMI бере до уваги лише закриті свічки. Свічка, що формується, ніколи не рахується, тож поки вона формується, нічого не змінюється.
• Сторінка запитує малюнки в серверів KAGAMI на кожній новій закритій свічці і кожні 60 секунд. На дуже коротких таймфреймах — щонайбільше раз на 2 секунди.
• Діапазон, що росте, змінюється з кожним закриттям. Його правий край, верх, низ, нахил, тип і колір — усе може змінитися. Його перша свічка залишається.
• Завершений діапазон залишається незмінним. Лише його рівні ростуть далі, доки не зупиняться, а обмеження в 500 можуть прибрати його найстаріші частини.
• KAGAMI читає до 2 000 останніх свічок і починає застосовувати правила з найстарішої. Коли надходять нові свічки, цей початок зсувається вперед. Тож найстаріші діапазони на крайньому лівому краї можуть змінитися або зникнути.

Таймфрейми

• Правила однакові на кожному таймфреймі. Вони рахують свічки, а не години. ATR береться з власних свічок графіка.
• Секундні таймфрейми (1, 5, 10, 15 і 30 секунд) є лише для криптовалют. Акції та форекс починаються з 1 хвилини.
• Свічки акцій США охоплюють години ринку (09:30–16:00 за нью-йоркським часом). Правила не знають про сесії. Діапазон може тягнутися через ніч чи вихідні, а стрибок на відкритті рахується, як будь-який інший рух.
• На 1-секундному графіку малюнки оновлюються щонайбільше раз на 2 секунди.

Відмінності від оригінального скрипту Pine

KAGAMI малює ті самі діапазони, лінії, мітки й кольори, що й оригінальний скрипт із налаштуваннями за замовчуванням. Що відрізняється:

1. Немає налаштувань. Кожен вхідний параметр зафіксовано на значенні оригіналу за замовчуванням.
2. Немає ковзних середніх. Три необов'язкові ковзні середні оригіналу не малюються. Там вони за замовчуванням вимкнені.
3. Немає сповіщень. Двох сповіщень оригіналу — про те, що діапазон формується, і про те, що діапазон закінчується чи пробивається, — у KAGAMI немає.
4. Завжди закриті свічки. У TradingView параметр Evaluate on bar close only можна вимкнути. У KAGAMI він завжди ввімкнений.
5. Історія. KAGAMI читає до 2 000 останніх свічок. TradingView часто має більше. Найстаріші діапазони можуть відрізнятися.
6. Дані свічок. KAGAMI використовує власні ринкові дані. Невелика різниця у свічці може змінити те, які діапазони знайдено.
7. Розмір тіку. KAGAMI бере власне правило (дивіться розрахунок). Воно важить лише в перевірці на рівність.
8. Обмеження на об'єкти. TradingView називає своє обмеження в 500 приблизним. KAGAMI зберігає рівно 500 найновіших кожного виду.
9. Вигляд. KAGAMI користується власними інструментами малювання графіка: прямокутник, лінії тренду, фігура каналу для заливки й виноска для мітки. Розміри й шрифти виглядають трохи інакше. Ці малюнки не можна вибрати, перемістити чи змінити, і вони не зберігаються.
10. Майбутні точки. Проєкція каналу може сягати на одну свічку за найновішу закриту свічку. KAGAMI ставить цю точку на одну тривалість свічки пізніше за часом на годиннику. TradingView рахує бари.

Особливі випадки

• Менше ніж 3 закриті свічки: нічого не малюється.
• Перші 13 свічок не мають ATR, тож жоден діапазон не може початися. Перший діапазон може з'явитися щонайраніше на 14-й свічці.
• Ціни, які зовсім не рухаються: ATR дорівнює 0. Може з'явитися прямокутник нульової висоти, і будь-який пізніший рух його закінчить.
• Один діапазон за раз. Діапазони ніколи не мають спільних свічок.
• Довгі тихі відрізки: діапазон закінчується на 150 свічках, навіть якщо ціна й далі тиха. Наступний може початися через 9 свічок.
• Великі розриви збільшують справжній діапазон, тож ATR росте. Це послаблює обмеження для наступних свічок.
• Свічки, яких бракує: правила рахують свічки, тож прогалина в даних просто пропускається.