@tradejs/strategy-vwap-reversion
v0.1.2
Published
Closed-candle UTC-session VWAP mean reversion for TradeJS.
Maintainers
Readme
VwapReversion
Самостоятельный пакет @tradejs/strategy-vwap-reversion для TradeJS.
Стратегия торгует подтверждённый возврат к дневному VWAP по закрытым свечам.
Основной интервал 15 означает 15 минут. Интервал 60 означает один час.
Проведены исторические проверки на 180 днях и всей доступной сохранённой истории. Устойчивость результата
и низкая корреляция с CopyTrading не доказаны.
Для часового интервала подтверждена только техническая корректность.
Пакет экспортирует strategyEntries, defaultConfig, строгий parseConfig,
createVwapReversionCore, чистый createVwapEngine, buildVwapFigures
и необязательный локальный AI-gate. Runtime предоставляет приложение
через peerDependencies. Усреднения и увеличения позиции нет.
AI-gate выключен по умолчанию и остаётся исследовательским.
yarn add @tradejs/strategy-vwap-reversionДля проверенной предварительной версии используйте
yarn add @tradejs/strategy-vwap-reversion@beta.
Сначала CI публикует beta и проверяет установку в чистом потребителе,
затем ручной или еженедельный запуск выпуска продвигает её в latest.
Номер версии пакета не означает подтверждение прибыльности стратегии.
Формулы
Для каждой закрытой свечи используется её объём v и типичная цена
p = (high + low + close) / 3. timestamp обозначает начало свечи в
миллисекундах UTC. Торговый день определяется как
floor(timestamp / 86400000) * 86400000.
Для свечей текущего UTC-дня:
W = Σ vᵢ
μ = Σ (vᵢ × pᵢ) / W
σ² = Σ [vᵢ × (pᵢ − μ)²] / W
VWAP = μ
lower = μ − k × sqrt(σ²)
upper = μ + k × sqrt(σ²)
k = VWAP_BAND_MULT = 2Дисперсия является взвешенной дисперсией всей наблюдаемой совокупности,
без поправки на число наблюдений. Это приближение по OHLCV. Объём свечи
условно сосредоточен в одной типичной цене, поэтому внутрисвечная дисперсия
теряется. turnover и отдельные сделки не используются. Нужен сопоставимый
объём в базовом активе для всех свечей инструмента.
Последовательный расчёт использует взвешенное обновление Welford:
δ = p − μ_old
W = W_old + v
μ = μ_old + δ × v / W
M2 = M2_old + v × δ × (p − μ)
σ² = M2 / WПри первом положительном объёме получается μ=p, M2=0.
Метод избегает вычитания двух больших близких чисел E[p²] − E[p]².
Малое отрицательное значение дисперсии в пределах
64 × Number.EPSILON × max(1, μ²) округляется до нуля. Существенно
отрицательная дисперсия и переполнение запрещают входы до следующего дня.
При практически нулевой ширине полос сигналы также запрещены.
Ручной пример: p₁=10, v₁=1, p₂=14, v₂=3.
Тогда W=4, μ=13, M2=12, σ²=3.
При k=2 полосы равны примерно 9.535898 и 16.464102.
Пример и сравнение с независимым двухпроходным расчётом закреплены тестами.
Фильтр и вход
Единственный фильтр состояния рынка использует Efficiency Ratio, отношение чистого изменения цены к сумме всех изменений по модулю:
ERₜ = abs(Cₜ − Cₜ₋ₙ) / Σ[j=t−n+1..t] abs(Cⱼ − Cⱼ₋₁)
n = VWAP_ER_PERIOD = 8
Входы разрешены при ER <= VWAP_MAX_ER = 0.20.
Если все изменения равны нулю, ER = 0.Нужно n+1 последовательных закрытий. Расчёт использует только текущую
и предыдущие свечи. ER сбрасывается с началом UTC-дня.
Начальный порог был 0.30 при периоде 16. В исследовательской версии
после сравнения вариантов используется 0.20 при периоде 8. ER не измеряет абсолютную волатильность:
резкий двусторонний рынок также может пройти фильтр. Термин "спокойный"
в первой версии означает только отсутствие выраженного направления по ER.
Для LONG требуется закрытие строго ниже нижней полосы. Оно сохраняет
ожидание возврата и минимальный low. На отдельной последующей свече
закрытие должно оказаться строго между обеими полосами и ниже VWAP.
Условие слабой направленности должно выполняться и при формировании
ожидания, и при подтверждении. SHORT работает симметрично.
Касание тенью, закрытие ровно на полосе и возврат уже за VWAP входа не дают.
По умолчанию VWAP_REQUIRE_PRICE_REVERSAL=true: закрытие подтверждения
должно быть выше предыдущего закрытия для LONG и ниже для SHORT.
Возврат внутрь только из-за расширения полосы отменяет ожидание без входа.
Этот переключатель можно отключить для воспроизведения исходной версии.
Полосы обеих свечей рассчитываются с учётом собственной закрытой OHLCV.
Уменьшение отклонения может происходить и за счёт движения VWAP/полос.
Ожидание действует не более VWAP_MAX_EXCURSION_BARS=8 интервалов.
При продолжении отклонения учитываются все экстремумы, включая свечу
подтверждения. Смена стороны отклонения создаёт новое ожидание.
Фильтр, нулевой объём, дневной сброс, открытая позиция и пауза отменяют
ожидание. Во время открытой позиции новый вход запрещён.
Стоп, цель и срок позиции
Цель равна VWAP свечи подтверждения. Цель и стоп фиксируются в orderPlan
при сигнале и больше не пересчитываются. Для LONG стоп равен минимуму
low отклонения и подтверждения минус 0.1% цены подтверждения.
Для SHORT берётся максимум high плюс такой же запас.
Расширение полос не увеличивает первоначальный стоп.
Минимальное отношение ожидаемой прибыли к риску равно 1.2 после
заданных расходов. Общий помощник buildTradeEconomics учитывает комиссии
на входе и выходе, а также неблагоприятное проскальзывание с двух сторон.
Размер позиции равен MAX_LOSS_VALUE / lossPerUnit, где lossPerUnit
включает расстояние до стопа и оценку расходов при стопе.
Начальный MAX_LOSS_VALUE=10 предназначен для будущего исследования.
Начальная комиссия составляет 0.001 с каждой стороны, проскальзывание
составляет 2 базисных пункта с каждой стороны. Дополнительное влияние
размера заявки задаётся RISK_MARKET_IMPACT_BPS и по умолчанию равно нулю.
Расходы для отбора и расчёта размера задаются отдельно от модели исполнения
бэктеста. Равенство этих оценок реальным расходам не предполагается.
Максимальный срок равен VWAP_MAX_HOLD_BARS=16 интервалам от сигнала:
4 часа для 15m и 16 часов для 1h. Раньше сработает дневное закрытие.
На последней свече UTC-дня, закрывающейся в 00:00 UTC, стратегия запрашивает
выход через StrategyAPI.exit. Нового входа на этой свече нет.
VWAP_MIN_SESSION_BARS_LEFT=1 требует хотя бы один полный интервал до
конца дня после закрытия свечи входа. Значение 8 оставляло бы два часа
для 15m, но этот исследованный вариант не выбран.
Если последняя свеча отсутствует, выход запрашивается на первой доступной
закрытой свече следующего дня. Пропуск внутри дня также вызывает выход.
Стоп и цель исполняются общим runtime и коннектором, а не расчётным модулем.
После исчезновения позиции применяется пауза VWAP_COOLDOWN_BARS=4.
Граница паузы включена: при наблюдении закрытия на свече t входы запрещены
до t + 4 × interval включительно. Точная причина внешнего закрытия
отсутствует в StrategyAPI. Поэтому пауза применяется ко всем закрытиям,
а также к сигналу, по которому позиция не появилась на следующей проверке.
Так учитывается и стоп, исполненный между двумя проверками позиции.
Во время паузы новое ожидание возврата не накапливается.
Данные и восстановление
Полный день должен начинаться с доступной свечи 00:00 UTC. При загрузке с середины дня входы запрещены до следующего полного дня. Внутридневной пропуск или некорректная OHLCV запрещают входы до следующего UTC-дня. Пропуски не заполняются искусственными свечами. Новый день без своей свечи 00:00 также считается неполным.
Нужно не менее VWAP_MIN_VOLUME_BARS=8 свечей с положительным объёмом
за день и 9 последовательных допустимых закрытий для ER по умолчанию.
Общая минимальная величина объёма не задаётся, поэтому это не фильтр ликвидности.
При нулевом объёме VWAP и дисперсия сохраняются, ожидание отменяется,
а накопление закрытий для ER начинается заново. Отрицательные, бесконечные
и отсутствующие значения, неправильные OHLC и неположительные цены недопустимы.
Неупорядоченные и невыравненные по интервалу timestamps вызывают ошибку.
Повтор timestamp не обновляет расчёт. Исправленная свеча того же timestamp
требует перестроения расчёта из исправленной истории.
Чистый расчётный модуль воспроизводит initialCandles тем же методом next,
который используется при последовательной обработке. getState() возвращает
отделённый JSON-совместимый снимок. Его можно передать как state с тем же
разрешённым конфигом, но одновременно передавать initialCandles нельзя.
Снимок предназначен для доверенного состояния этой версии пакета.
core.ts хранит расчёт и состояние сделки через createStateController
с полным конфигом в ключе. Новый экземпляр CRON использует сохранённое
состояние только в рамках штатной области runtime. История при первом
решении фильтруется строго до текущей свечи. Опережающие данные не
используются. В памяти сохраняется не более одного дня точек графика,
ER_PERIOD+1 закрытий и одного ожидания/состояния сделки.
Восстановление расчётного модуля не восстанавливает сделки из OHLCV.
Полный снимок контроллера сохраняет срок позиции и паузу, что проверено
через JSON и настоящий публичный StrategyAPI. Пакет не добавляет постоянное
хранилище снимков. После остановки процесса без снимка открытая позиция
закрывается с кодом VWAP_UNRESTORED_POSITION, поскольку её возраст и
происхождение неизвестны. Историческую паузу без снимка восстановить нельзя.
Подключение
В вашем Project установите опубликованную стабильную версию:
yarn add --exact @tradejs/[email protected]Сохраните lock-файл. В конфигурации Project зарегистрируйте модуль:
import { defineConfig } from "@tradejs/core/config";
export default defineConfig({
strategies: ["@tradejs/strategy-vwap-reversion"],
});Добавьте строку к существующему массиву strategies, сохранив его остальные
элементы. Регистрация модуля сама по себе не включает торговлю в deployment.
Полную декларацию runtime следует задавать отдельно при явном запросе
на запуск. Общая композиция и runtime-конфигурация в рамках разработки
этого пакета не менялись.
Будущий бэктест
Файл examples/backtest-grid.json содержит одну конфигурацию для 15m
без перебора параметров. Оба направления активны по логике стратегии.
Часовой вариант находится в examples/backtest-grid-1h.json.
Все поля представлены массивами для контракта сетки TradeJS.
Файлы ещё не записаны в Redis.
После подключения пакета и отдельной загрузки выбранной сетки в именованный
backtest-конфиг VwapReversion:baseline будущий запуск из tradejs-project:
TRADEJS_SOURCE_REPOSITORY_ROOT=/Users/aleksnick/dev/tradejs/tradejs-strategy-vwap-reversion \
TRADEJS_FRAMEWORK_REPOSITORY_ROOT=/Users/aleksnick/dev/tradejs/investing \
yarn backtest -c VwapReversion:baseline -d 30 --cacheOnly --fast \
--backtestPriceMode close --backtestEntryDelayBars 0 -p 1CLI переопределяет режим цены и задержку, поэтому оба флага обязательны. В первой версии допустимы только вход на закрытии и задержка 0. Другие режимы явно отклоняются парсером вместо неявного изменения проверенной геометрии риска. Исполнение в точности на закрытии является идеализированным сценарием, а не доказательством реальной исполнимости. Для исследования с задержанным входом понадобится отдельная проверка геометрии и расходов по фактической цене входа.
До большого запуска проверьте активных тестировщиков, свободную память и полноту кеша. При первоначальном создании пакета бэктесты не запускались. Позднее проведено описанное ниже исследование core и отдельное исследование локального gate. Публикация пакета не включает стратегию в рабочую композицию.
Проверки и график
yarn install --immutable
yarn checksИспользуется Yarn 4 с PnP. Установка не создаёт и не изменяет node_modules.
yarn checks проверяет форматирование, типы, сборку ESM/CJS с декларациями
и тесты через node --test.
Тесты проверяют ручной расчёт, устойчивость дисперсии, UTC-сброс, оба направления, касания, пропуски, нулевой объём, фильтр, срок ожидания, срок позиции, паузу, последовательное воспроизведение, JSON-снимок, изоляцию конфигов и отсутствие влияния будущих свечей.
figures в сигнале содержат VWAP, обе полосы, зелёные/красные точки
разрешения входов по фильтру и данным, вход, фиксированные стоп и цель.
Подпись содержит ER. Цвет разрешения относится к фильтру расчётного модуля,
а не к доступности позиции, прохождению минимального отношения прибыли
к риску или разрешению внешней политики. Пакет передаёт график с сигналом;
пропущенные решения не имеют отдельного графика по контракту StrategyAPI.
Источники и ограничения
Прочитаны публичные описания Bull & Wolf Nifty Indicator и Z-Regime Switch. Первый описывает возврат от внешних VWAP-полос, второй описывает подтверждение возврата и фильтр ER. Код написан самостоятельно по требованиям задачи. Точное совпадение с Pine-скриптами не заявляется.
Готовый VWAP повторно искался в текущих packages/indicators,
packages/core и packages/types framework. Готового публичного расчёта
не найдено, поэтому формула реализована только в этом пакете.
Контракт проверен по актуальному локальному StrategyAPI и опубликованным
@tradejs/[email protected], @tradejs/[email protected], @tradejs/[email protected].
Параметры являются исходной гипотезой. ER не исключает быстрые колебания, объём OHLCV не воспроизводит поток сделок, а стоп не гарантирует предел фактического убытка при гэпе, округлении количества и проскальзывании. Максимальный срок и закрытие дня требуют поступления свечей и работающего runtime. Корреляцию с DoubleTap, HeadAndShoulders, LiquidityTails и TradingPatterns нужно измерять отдельно по сопоставимым результатам.
Исследование за 180 дней
Профиль examples/backtest-grid-180d-research.json и текущие значения
по умолчанию используют ER(8) <= 0.20 и явное движение закрытия
к среднему. Начальная конфигурация сохранена в
examples/backtest-grid-initial.json.
На заранее выбранных 20 USDT-инструментах Bybit за период с 12 апреля до 9 октября 2026 года профиль дал 58 завершённых сделок, PnL +16.8848 USDT, PF 1.0689 и реализованную просадку 78.2218 USDT. При расчёте использовались риск 10 USDT на сделку, комиссия 0.1% на каждом исполнении и проскальзывание 2 базисных пункта на каждом исполнении. Funding исключён. Данные старше даты исследования на шесть полных дней.
Перед открытием последних 72 дней проверены 12 новых вариантов на первых 108 днях. Выбранный вариант был лишь лучшим диагностическим вариантом, поскольку на рабочем участке он дал -4.0932 USDT на 39 сделках. Отложенный участок дал +20.9781 USDT на 19 сделках. Выборка отложенного участка меньше 20 сделок, поэтому подтверждение преимущества слабое.
Последние 30 дней дали -38.1419 USDT, последние 7 дней дали -15.1989 USDT. LONG за весь период дал -9.2821 USDT, SHORT дал +26.1669 USDT. Оба направления сохранены. Небольшой общий плюс не подтверждает устойчивость и не является основанием для включения реальной торговли. Результат относится к исследованной корзине, а не ко всему рынку. Проверка прибыльности 1h не проводилась.
Research options are disabled by default. VWAP_MAX_COST_SHARE=0 preserves
entry admission. A positive value up to 1 limits proposed round-trip costs
divided by the gross distance to the fixed VWAP target:
(feeRate + (slippageBps + impactBps)/10000) * (entry + target) / abs(target-entry).
It uses only the requested closed-candle entry and target, without future fills.
VWAP_RETURN_BAND_MULT=0 preserves the original outer-band confirmation.
A positive value no greater than VWAP_BAND_MULT requires a close strictly
inside that narrower band. Shallow returns keep the original pending age and
extreme; zero volume, gaps, session limits and expiry still invalidate it.
These options are research hypotheses, not validated production defaults.
Необязательный локальный AI-gate
VWAP_AI_GATE_ENABLED defaults to false. Setting it to true selects the
local deterministic gate at minQuality=4; it does not call an LLM. The
research profile in examples/backtest-grid-ai-gate-research.json uses the
confirmed return inside 1.5 sigma, a fixed 0.3% stop buffer, and the 7.5% cost
share cap from the frozen core study.
Valid LONG setups pass through. SHORT additionally requires requested stop distance at most 250 basis points and closed-signal Efficiency Ratio at least 0.07. The core still enforces its maximum ER. Missing or invalid setup values block approval. Approved signals receive quality 5 and rejected signals quality 1, so q4+ and q5+ contain the same signals; quality is not a probability.
This profile is research-only. Rules were selected on the first 60% of whole timestamp groups in the cached-history export and frozen before evaluating the remaining 40%. The history had already been inspected during core work. Only 13 approved SHORT events occur in that later partition. The last year and recent windows remain weak. No production configuration is changed.
The reported gate study filters completed raw-core trades. It does not simulate new detector opportunities or position occupancy after rejecting a signal, capital limits, or live fills. Validate those separately before activation.
