Это руководство к двум индикаторам, которые вместе дают вам «язык» смарт‑денег в терминах VSA и Вайкоффа:

• StudentWyckoff VSAStrength — показывает признаки силы (появление спроса).
• StudentWyckoff VSAWeakness — показывает признаки слабости (появление предложения).

Они не «торговая система со стрелочкой входа», а инструмент чтения рынка в духе Тома Вильямса и Ричарда Вайкоффа: цена + объём + спред свечи + контекст.

1. От Вайкоффа до VSA и Тома Вильямса — короткая история

• Ричард Вайкофф ещё в 1930‑х описал рынок как игру крупных операторов против публики и предложил читать рынок «по его собственному поведению»: через цену, объём и форму волн спроса/предложения.
• В его курсе вы найдёте всё: тренды, фазы накопления/распределения, климаксы, тесты, остановки — всё через закон спроса и предложения и анализ спреда и объёма.
• Тейп‑ридинг (чтение ленты), о котором писал и Вайкофф, и другие трейдеры начала XX века, по сути уже был примитивной VSA: смотреть, как далеко пошла цена относительно того, сколько торговалось объёма.

Том Вильямс сделал следующий шаг:

• Был профессиональным оператором «по ту сторону бара» и затем систематизировал опыт в виде VolumeSpreadAnalysis (VSA) — набора повторяющихся паттернов: NoDemand, NoSupply, Shakeout, BagHolding, Buying/SellingClimax, Upthrust и т. д.
• Эти паттерны легли в основу программы TradeGuider и всей «лексики» VSA, которой мы пользуемся до сих пор.
• Современные авторы типа Anna Coulling уже прямо говорят: ключ к рынку — связка price+volume, продолжая линию Dow–Livermore–Wyckoff–VSA.

Наши индикаторы — это попытка аккуратно перенести эту школу в TradingView, максимально сохранив оригинальный дух.

2. Что такое VSA простыми словами
VolumeSpreadAnalysis — это способ смотреть не на индикаторы, а на сам бар:

• Спред свечи (high–low): широкий / узкий.
• Позиция закрытия: у high, посередине, у low.
• Объём: низкий, средний, высокий, климаксный (очень высокий).
• Контекст: тренд, свежие максимумы/минимумы, фон предыдущих баров.

Дальше логика детского конструктора:

• Широкий ап‑бар на ультра‑высоком объёме, закрытие не у high после долгого роста → вероятен сброс крупного объёма (BuyingClimax).
• Узкий ап‑бар на низком объёме, закрытие внизу → никто особо не покупает (NoDemand).
• Даун‑бар на очень высоком объёме, закрытие далеко от low после снижения → кто‑то крупный выкупает панику (SellingClimax / StoppingVolume).

VSA не говорит: «купи тут, продай здесь».
 Она говорит: «здесь, с высокой вероятностью, крупные игроки делают вот это».

3. Обзор пакета индикаторов
Student Wyckoff VSA Strength
Индикатор рисует зелёные стрелки под барами, когда видит классические признаки силы (SOS — SignsofStrength) в терминах Тома Вильямса и VSA:

• Климаксы и остановка падения: Selling Climax, Stopping Volume, Bag Holding, Shakeout, Climactic Stop‑Volume.
• Тесты и отсутствие предложения: Test, No Supply, Test after Shakeout.
• Появление спроса и продолжение роста: Professional Buying, Strength Appearing, Strength Coming In, Demand Overcoming Supply, Effort vs Result (strength).

Поддерживаются профили таймфрейма (Minute / H1 / H4 / Daily / Weekly / Custom) — индикатор сам подстраивает длины окон под выбранный стиль торговли.
StudentWyckoff VSAWeakness
Индикатор рисует красные стрелки над барами, когда видит признаки слабости (SOW — SignsofWeakness):

• Климаксы роста и начало распределения: Buying Climax, End of a Rising Market, Supply Coming In, Selling Pressure, Effort vs Result (bearish).
• Ловушки и выносы: Upthrust, Hidden Upthrust, UTAD, Trap Up‑Move, Gotcha‑bar.
• Прямые маркеры появления явной слабости: Weakness Has Appeared, Supply Overcoming Demand.
• Нехватка спроса: No Demand.
• Двухбарные развороты: 2‑bar Top Reversal.

Оба индикатора:

• Не перерисовываются — каждый сигнал ставится только на закрытом баре, после проверки следующей свечи, и не исчезает.
• Показывают подтверждённые и неподтверждённые сигналы разным оттенком цвета.
• У каждого паттерна есть всплывающая подсказка при наведении на стрелку, где кратко описано, что происходит.
  

4. Цвета, подтверждение и подсказки
Чтобы было не только умно, но и удобно:

• Слабость (Weakness)
  • Неподтверждённый сигнал — светло‑красный треугольник над баром.
  • Подтверждённый — тёмно‑красный треугольник.
• Сила (Strength)
  • Неподтверждённый — светло‑зелёный/лаймовый треугольник под баром.
  • Подтверждённый — тёмно‑зелёный.

Логика подтверждения очень простая:

• Для силы сигнал подтверждён, если следующий бар пошёл вверх (закрытие или максимум выше).
• Для слабости — если следующий бар пошёл вниз (закрытие или минимум ниже).

На графике:

1. Бар Х формирует паттерн.
2. Бар Х+1 закрывается.
3. Индикатор рисует стрелку на баре Х (offset = −1) уже с пониманием, подтвердилось ли движение.

Поэтому:

• Стрелки не исчезают и не «переезжают».
• Вы всегда видите честный, завершённый сигнал.

При наведении мышкой на стрелку появляется tooltip:

• Для неподтверждённого варианта — короткое описание паттерна:

«VSA: NoDemand — ап‑бар, узкий спред, низкий объём…»

• Для подтверждённого — текст вида:

«NoDemand подтверждён — следующий бар вниз».
Это максимально приближено к формулировкам Тома Вильямса: вы прямо на графике видите, какой именно VSA‑сетап сработал, а не просто «иконку».

5. Профили таймфреймов и настройки
В обоих индикаторах есть параметр «Выбор профиля»:

• M1–M30 (Minute)
• H1 (Hourly)
• H4 (4‑Hour)
• D1 (Daily)
• W1 (Weekly)
• Custom

Это делает:

1. Масштабирует длины окон (SMA объёма, SMA спреда, lookback по High/Low) под выбранный таймфрейм.
   
   • На минутках окна удлиняются (шумнее рынок → нужно больше баров для статистики).
   • На дневке используется базовое «каноническое» окно.
   • На неделе окна немного укорочены, чтобы сигналов было больше.
2. Сохраняет характер паттернов. Test на минутках и Test на дневке ищут одинаковую идею поведения смарт‑денег, а не просто «что‑то где‑то на низком объёме».

В настройках сигналы разбиты на логичные группы:

• «Сигналы» — чекбоксы включения/выключения конкретных паттернов.
• «Фильтры: Test», «Фильтры: Upthrust» и т. д. — параметры объёма, спреда, закрытия, lookback для каждого сетапа.
• «Визуал» — цвета, включение/отключение подсказок.

Даже если вы впервые видите VSA, по названиям групп и параметров понятно, куда смотреть.

6. Признаки силы (Student Wyckoff VSA Strength)
Ниже — человеческое описание того, что делает каждый паттерн сила‑индикатора.
6.1. Test — классический VSA‑тест
Идея: рынок «прощупывает» наличие продавцов.

• Даун‑бар, спред узкий.
• Объём низкий (ниже средней и двух предыдущих).
• Закрытие в верхней части бара.

Смысл: цена немного опускается, чтобы проверить — есть ли ещё желающие продавать. Если объёма нет — крупным игрокам спокойно держать и поднимать цену, сигнал силы.
6.2. Selling Climax (SC)
Климакс продаж.

• Широкий даун‑бар, очень высокий объём (паника).
• Закрытие далеко от low (часть объёма выкупают).

Смысл: слабые руки капитулируют, сильные покупают «со скидкой». Часто начало фазы накопления.
6.3. Two‑BarReversal (2BR)
Двухбарный разворот вверх.

• Бар A вниз: широкий спред, высокий объём.
• Бар B вверх: тоже достаточно широкий, закрытие высоко, часто выше середины бара A.

Смысл: сначала выбили стопы и напугали всех барышком A, затем сразу же вошли покупатели баром B. Часто начало бычьего разворота.
6.4. BagHolding (BH)
«Держатели мешка» — классический VSA‑паттерн.

• Очень узкий даун‑бар на ультра‑высоком объёме.
• Закрытие далеко от минимума, иногда ближе к середине/верхней части бара.

Смысл: толпа продаёт в панике, крупный оператор «держит мешок» — забирает всё, что ему дают.
6.5. Stopping Volume (SV)
Останавливающий объём.

• Даун‑бар на очень высоком объёме.
• Закрытие не у low (часто выше середины).
• Широкий спред необязателен (по настройке).

Смысл: падение «отбили» — на низах активно покупали. Это не гарантирует разворот, но показывает, что вниз уже не так просто.
6.6. NoSupply (NS)
Отсутствие предложения.

• Узкий даун‑бар.
• Объём ниже двух предыдущих, может быть ниже средней.
• Закрытие в верхней части бара.

Смысл: продавать особо некому. Хорошо смотрится после сильных SOS‑паттернов — как подтверждение, что предложение высохло.
6.7. ProfessionalBuying (PB)
Профессиональные покупки на падении.

• Даун‑бар на ультра‑высоком объёме.
• Закрытие выше середины спреда.
• Широкий спред может быть обязателен или опционален (настраивается).

Смысл: рынок «рисует» страшную свечу вниз, но закрытие высоко — крупные игроки выкупают предложение, не давая цене закрыться внизу.
6.8. Shakeout (SO)
Шейкаут, вынос по стопам.

• Очень высокий объём, широкий даун‑бар.
• Свежий минимум за окно lookback (по умолчанию — «freshLL»).
• Закрытие в верхней части бара.

Смысл: быстрый выброс вниз, вынос стопов под поддержкой, после чего цену поднимают назад. Часто перед ростом.
6.9. Climactic Stop‑Volume (CSV)
Климакс + остановка.

• Климаксный объём (ещё выше, чем у обычного SV).
• Широкий спред вниз, закрытие высоко.
• Может сопровождаться свежим минимумом.

Смысл: финальный выброс слабых держателей. Часто точка окончания медвежьего движения.
6.10. StrengthAppearing (SA)
«Сила проявилась» — ап‑бар после фона силы.

• Ап‑бар, закрытие высоко.
• Объём и спред повышены.
• В коде проверяется, что недавно были SOS‑паттерны (SC, SV, PB, BH, SO, Test, NS, CSV, SCI, DOS, TaSO).
• Часто требуется закрытие выше какого‑то количества предыдущих High.

Смысл: после серии признаков силы появляется уверенный ап‑бар — подтверждение, что именно здесь «включили» рост.
6.11. Effort vs Result (EVR, strength)
Много усилий, хороший результат (для быков).

• Высокий объём.
• Спред относительно узкий, но закрытие высоко.
• Нет обновления минимума, избегаем свежих LL.

Смысл: при высоком объёме цена держится хорошо, не пробивает низы — давление продавцов поглощают.
6.12. Strength Coming In (SCI, bullish)
Прилив силы на падающем фоне.

• Даун‑бар на повышенном объёме и расширенном спреде.
• Закрытие высоко.
• На фоне — 2 из 3 последних баров были даун‑барами.

Смысл: в падающем движении появляется бар, где объём высокий, но закрытие хорошее — кто‑то активно выкупает падение.
6.13. Demand Overcoming Supply (DOS)
Спрос преодолевает предложение.

• Ап‑бар с повышенным объёмом и спредом.
• Закрытие высоко.
• По желанию сравнивается с последним даун‑баром: объём и спред должны быть не хуже, а лучше.

Смысл: быки не просто появились — они перебивают объём и активность последних продавцов.
6.14. Test after Shakeout (TaSO)
Тест после шейкаута.

• То же ядро, что у Test.
• Плюс условие, что недавно был Shakeout.

Смысл: сначала агрессивный вынос вниз (SO), потом тихий падик на низком объёме (Test) — классический «комбо‑паттерн» Тома Вильямса перед сильным ростом.

7. Признаки слабости (Student Wyckoff VSA Weakness)
Теперь зеркальная сторона — паттерны слабости.
7.1. NoDemand (ND)
Отсутствие спроса.

• Ап‑бар, спред узкий.
• Объём ниже двух предыдущих и (по желанию) ниже SMA объёма.
• Закрытие ближе к low или, по настройке, можно требовать закрытие выше/ниже определённой доли спреда.

Смысл: цена вроде подрастает, но покупатели вяло участвуют — некому поддерживать рост.
7.2. Upthrust (UT)
Классический ап‑траст.

• Ап‑бар, широкий спред.
• Закрытие в нижней части бара.
• Часто свежий High за lookback.
• Объём высокий (опционально можно ослабить фильтр).

Смысл: вынос стопов над уровнями, заманивание в покупки, затем быстрый откат вниз внутри того же бара.
7.3. UTAD (верхняя ловушка)
UpthrustAfterDistribution — ловушка в фазе распределения.

• Широкий ап‑бар, свежий максимум за более длинное окно.
• Закрытие у low.
• Объём высокий/очень высокий.

Смысл: финальный вынос над вершиной диапазона, где крупный оператор окончательно раздаёт позицию.
7.4. BuyingClimax (BC)
Климакс покупок.

• Широкий ап‑бар, климаксный объём.
• Закрытие не у high (часть бара сверху «отдаётся»).
• Часто свежий High и/или длинный рост до этого.

Смысл: толпа врывается в покупки на пике, крупный оператор сливает им объём.
7.5. End of a Rising Market (EORM)
Конец растущего рынка.

• Узкий ап‑бар на очень высоком объёме.
• Закрытие не у high.

Смысл: цена почти не двигается, а объём огромный — кто‑то крупный тихо сливает «в потолок».
7.6. Supply Coming In (SCI, bearish)
Приход предложения на росте.

• Ап‑бар, широкий спред.
• Высокий объём.
• Закрытие смещается вниз от high (часто ближе к середине).

Смысл: внутри растущего бара появляется заметное давление продавцов — сверху активно продают.
7.7. SellingPressure (SP)
Давление продаж на ап‑баре.

• Ап‑бар на высоком объёме.
• Закрытие ближе к low.
• Может быть широкий спред или, по настройке, узкий спред на ультра‑высоком объёме (вариант EffortvsResult).

Смысл: цена пыталась расти, но продавцы продавили закрытие вниз.
7.8. Effort vs Result (EvR, bearish)
Много усилий, слабый результат (для быков).

• Высокий объём.
• Спред узкий или закрытие низко.
• Дополнительно может использоваться фильтр по корреляции объёма и спреда (эвристика).

Смысл: объёма много, а прогресса вверх нет — усилия быков не дают результата, значит, кто‑то их встречает встречным предложением.
7.9. Top Reversal (2‑bar Top)
Двухбарный разворот сверху.

• Бар A — ап‑бар, широкий спред, высокий объём, часто freshHigh.
• Бар B — даун‑бар, широкий спред, закрытие низко, часто ниже Low бара A.

Смысл: кульминация роста и разворот за два бара — классика VSA и Вайкоффа.
7.10. Hidden Upthrust (HUT)
Скрытый ап‑траст.

• High текущего бара выше High предыдущего.
• Объём низкий.
• Закрытие не у high, часто ближе к середине или ниже.

Смысл: цена чуть‑чуть прокалывает вверх на тонком рынке, но не удерживается — ловушка для тех, кто торгует по пробоям без объёма.
7.11. Weakness Has Appeared (WHA)
Слабость проявилась.

• Даун‑бар, широкий спред.
• Закрытие у low.
• Минимум и закрытие ниже нескольких предыдущих баров.
• По желанию — высокий объём.

Смысл: на фоне предыдущих событий вдруг появляется мощный бар слабости, который ломает предыдущую структуру. Часто начало новой нисходящей фазы.
7.12. SupplyOvercomingDemand (SOD)
Предложение преодолевает спрос.

• Ап‑бар на высоком объёме.
• Спред узкий или закрытие явно не у high.
• Требуется, чтобы это был именно ап‑бар (по закрытию выше предыдущего).

Смысл: покупатели пытаются толкать рынок, но повышение цены относительно объёма скромное — продавцы встречают и перевешивают спрос.
7.13. Trap Up‑Move (TUM)
Ловушка вверх.

• Гэп или рывок вверх (open > previous high) или свежий High за окно.
• Высокий объём, достаточно широкий спред.
• Закрытие низко.
• Часто обязательный даун‑клоуз.

Смысл: утренний/быстрый вынос вверх, который закрывается у лоу — жёсткий захват ликвидности над сопротивлением.
7.14. Gotcha‑bar (GB)
«А вот и мы» — бар, где слабость становится явной.

• Даун‑бар на повышенном объёме.
• Широкий спред, закрытие низко.
• В недавнем фоне уже были SOW‑паттерны (BC, EORM, UT, UTAD, SCI, SP, EvR, ND, 2‑bar Top, HUT, WHA, SOD, TUM).
• Часто закрытие ниже минимума N предыдущих баров.

Смысл: после серии «тонких» признаков слабости рынок наконец «проваливается» — на графике это тот самый бар, после которого становится очевидно, что всё, праздник закончился.

8. Всплывающие подсказки и «оригинальный дух» Тома Вильямса
Важная часть индикаторов — подсказки на каждом шаге:

1. На графике — при наведении на стрелку: короткое описание паттерна в терминах VSA, плюс информация о подтверждении. Тексты подсказок составлены так, чтобы соответствовать оригинальным определениям из VSA/TradeGuider‑подхода (NoDemand, NoSupply, Shakeout, BagHolding, BuyingClimax и т. д.), а не «своему» сленгу.
2. В окне настроек — каждая группа параметров названа по канону:
   
   • «Фильтры: Test», «Фильтры: NoSupply», «Фильтры: BuyingClimax» и т. д.
      Это помогает тем, кто изучал книги Тома Вильямса и Вайкоффа, сразу узнавать знакомые конструкции.

Плюс реализованы канонические пары: SOS/SOW, климаксы, тесты, шейкауты, ап‑трасты и двухбарные развороты — это и есть «язык», которым оперировал Том В., просто переведённый на формальные условия PineScript.

9. Чем эти индикаторы уникальны на TradingView
Коротко, в чём фишка именно этого пакета:

1. Полный набор VSA‑паттернов
   • Покрыты практически все ключевые сигналы Тома Вильямса (Test, NS/ND, Shakeout, Bag Holding, SC/BC, SV, PB, Upthrust, EORM и др.)
   • Плюс добавлены «комбо»‑паттерны типа Strength Coming In, Weakness Has Appeared, Demand Overcoming Supply, Trap Up‑Move, Test after Shakeout — то, что в книжках описано словами, тут реализовано в виде чётких условий.
2. Анти‑репейнт‑архитектура
   • Все сигналы считаются строго на закрытых барах (barstate.isconfirmed) и выводятся с задержкой в один бар, чтобы использовать информацию о следующей свече для подтверждения.
   • Сигналы не исчезают и не меняют позицию при появлении новых данных.
3. Контекст, а не голые стрелки
   • Многие паттерны завязаны на фон SOS/SOW (Gotcha‑bar, Strength Appearing, Test after Shakeout и др.).
   • Индикатор пытается воспроизвести именно кампании крупного оператора по Вайкоффу, а не просто точечные свечные модели.
4. Гибкая адаптация к таймфреймам
   • Профили Minute / H1 / H4 / D1 / W1 меняют длины окон так, чтобы «логика» паттерна сохранялась на разных ТФ.
   • Это реализовано как проектная эвристика поверх «канонических» дневных параметров.
5. Прозрачность и обучающий характер
   • Все названия сетапов и подсказки соответствуют классическим книгам по Wyckoff/VSA, поэтому индикатор можно использовать как «живой учебник»: смотреть, где именно на графике появляются знакомые паттерны.
6. Готовность к автоматизации
   • Для каждого подтверждённого паттерна заведены alertcondition(...), поэтому вы можете строить алерты и подключать их к ботам/уведомлениям без дополнительного кода.

10. Как использовать эти индикаторы в торговле
Самое главное:
Стрелка — это повод подумать, а не приказ нажать кнопку.
Типичный рабочий подход:

1. Определить фазу рынка по Вайкоффу — накопление, марки‑ап, распределение, марки‑даун.
2. Смотреть фон:
   • В зоне накопления ищем SC, SV, SO, BH, Test, NS, TaSO, SA, DOS, SCI (bullish).
   • В зоне распределения — UT, UTAD, BC, EORM, ND, SOD, SP, EvR, GB, WHA, TUM.
3. Ждать подтверждения — использовать тёмные стрелки (подтверждённые паттерны) как основной триггер, а светлые — как ранние предупреждения.
4. Комбинировать с уровнями/волнами — VSA идеально дружит с уровнями поддержки/сопротивления, каналами, волнами Вайкоффа и волновым анализом объёма.

Сами индикаторы дают:

• Ясный визуальный язык: где на графике проявлялась сила/слабость.
• Возможность «перечитывать» свои сделки в терминах VSA, обучая глаз.
• Удобный мост между книжной теорией и реальными свечами в TradingView.

Если коротко, этот пакет — не ещё один «стрелочник», а аккуратная попытка перенести метод Тома Вильямса и Вайкоффа в код Pine:
 цена + объём + спред + контекст → метки силы и слабости, которые можно и изучать, и использовать в принятии решений.