@tradejs/strategy-value-area-reclaim 0.0.0-stage → 0.1.1-beta.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +3 -0
- package/README.md +235 -2
- package/dist/index.cjs +588 -0
- package/dist/index.d.cts +121 -0
- package/dist/index.d.ts +121 -0
- package/dist/index.js +547 -0
- package/examples/backtest-grid-1h.json +22 -0
- package/examples/backtest-grid.json +22 -0
- package/examples/backtest-plan-1h.json +40 -0
- package/examples/backtest-plan.json +35 -0
- package/package.json +57 -4
package/LICENSE
ADDED
package/README.md
CHANGED
|
@@ -1,3 +1,236 @@
|
|
|
1
|
-
#
|
|
1
|
+
# ValueAreaReclaim
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Самостоятельный пакет `@tradejs/strategy-value-area-reclaim` экспортирует
|
|
4
|
+
`strategyEntries` для TradeJS. Версия 1 работает на закрытых свечах `15m` и `1h`.
|
|
5
|
+
Она ищет неудачный выход из области основного объёма и возврат внутрь неё,
|
|
6
|
+
после чего ставит цель у POC, центра корзины с наибольшим объёмом.
|
|
7
|
+
|
|
8
|
+
Пакет создан по требованиям задачи. Источник идеи указан в
|
|
9
|
+
[Fade Break Volume Profile Fade Breakout Strategy](https://www.tradingview.com/script/1OnkbAiE-HVN-Fade-Break-Volume-Profile-Fade-Breakout-Strategy/).
|
|
10
|
+
Страница источника была недоступна при разработке, поэтому пакет не является
|
|
11
|
+
проверенным переносом Pine Script. Код написан самостоятельно.
|
|
12
|
+
|
|
13
|
+
## Установка
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
yarn add @tradejs/strategy-value-area-reclaim
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Добавьте `"@tradejs/strategy-value-area-reclaim"` в список `strategies`
|
|
20
|
+
файла `tradejs.config.ts`. Для исполнения на `1h` нужна версия TradeJS с
|
|
21
|
+
`StrategyAPI.getClosedCandles`. Совместимая опубликованная сборка
|
|
22
|
+
`@tradejs/core`, `@tradejs/types` и `@tradejs/node` — `3.1.29-beta.302`.
|
|
23
|
+
Используйте одну версию этих пакетов в проекте.
|
|
24
|
+
|
|
25
|
+
## История 15m и исполнение 1h
|
|
26
|
+
|
|
27
|
+
Для `INTERVAL: "15"` ядро восстанавливает ограниченную историю из `data`
|
|
28
|
+
строго до текущей свечи и затем добавляет каждую закрытую свечу один раз.
|
|
29
|
+
Для `INTERVAL: "60"` оно получает те же исходные `15m` через новый метод
|
|
30
|
+
`strategyApi.getClosedCandles({ interval: "15", start, end, limit })`.
|
|
31
|
+
Часовые свечи используются только для распознавания возврата и ATR.
|
|
32
|
+
|
|
33
|
+
API привязан к символу и подключению текущего runtime. Полуоткрытое окно
|
|
34
|
+
`[start, end)` задаётся временем открытия свечей в миллисекундах UTC.
|
|
35
|
+
Граница `asOf` равна времени закрытия текущей свечи исполнения и фиксируется
|
|
36
|
+
до чтения данных. Каждая исходная свеча должна удовлетворять условию
|
|
37
|
+
`timestamp + 15m <= asOf`. Будущий запрос отклоняется до чтения.
|
|
38
|
+
Размер окна ограничен 1536 пятнадцатиминутными слотами, включая пропуски.
|
|
39
|
+
|
|
40
|
+
API возвращает свечи по времени, признак `complete` и интервалы пропусков
|
|
41
|
+
`missingRanges`. Повреждённые OHLCV и повторные timestamps отклоняются.
|
|
42
|
+
В BACKTEST и PARITY используется `cacheOnly: true`. CRON может получать
|
|
43
|
+
закрытую историю через обычное подключение с кэшем.
|
|
44
|
+
|
|
45
|
+
На `1h` ядро читает ровно `profileDays * 96` слотов завершённых UTC-дней
|
|
46
|
+
один раз за день и сохраняет только рассчитанный профиль. При неполном
|
|
47
|
+
окне или ошибке источника входы запрещены до следующей смены дня.
|
|
48
|
+
Коды причины равны `VAR_15M_HISTORY_INCOMPLETE` и
|
|
49
|
+
`VAR_15M_HISTORY_UNAVAILABLE`. Выход существующей позиции по сроку удержания
|
|
50
|
+
продолжает работать даже при ошибке источника.
|
|
51
|
+
|
|
52
|
+
Профиль не строится из часовых свечей, пропущенные `15m` не заменяются
|
|
53
|
+
свечами с нулевым объёмом. При одинаковых исходных данных дневные
|
|
54
|
+
POC/VAH/VAL и все корзины на `15m` и `1h` совпадают.
|
|
55
|
+
|
|
56
|
+
## Правила профиля
|
|
57
|
+
|
|
58
|
+
По умолчанию используются три завершённых UTC-дня. Время свечи считается
|
|
59
|
+
временем открытия в миллисекундах UTC. Профиль активного дня `D` использует
|
|
60
|
+
строго `[D - 3 дня, D)`. Текущий день исключён.
|
|
61
|
+
|
|
62
|
+
Профиль строится на первом обработанном закрытом баре с временем открытия
|
|
63
|
+
в новом UTC-дне, обычно на свече `00:00`, доступной в `00:15` для `15m` и в `01:00` для `1h`.
|
|
64
|
+
Последний бар с открытием до полуночи относится к предыдущему дню. Уровни не применяются задним числом к этому бару.
|
|
65
|
+
При запуске внутри дня профиль восстанавливается по тому же пути переходов.
|
|
66
|
+
Повторного расчёта внутри дня нет, даже если дневное окно неполное.
|
|
67
|
+
|
|
68
|
+
Границы профиля равны минимальному `low` и максимальному `high` всего окна,
|
|
69
|
+
включая свечи с нулевым объёмом. Диапазон делится на 48 равных корзин.
|
|
70
|
+
Объём каждой свечи распределяется равномерно по её `low–high`, пропорционально
|
|
71
|
+
длине пересечения с корзиной. Последняя пересечённая корзина получает остаток
|
|
72
|
+
округления. Сумма объёма сохраняется с точностью арифметики JavaScript.
|
|
73
|
+
|
|
74
|
+
Свеча нулевой ширины отдаёт весь объём корзине своей цены. Внутренняя граница
|
|
75
|
+
принадлежит верхней корзине, а максимальная цена профиля принадлежит последней.
|
|
76
|
+
Если весь диапазон нулевой, объём хранится в первой корзине, POC/VAH/VAL равны
|
|
77
|
+
одной цене и входы запрещены. При нулевом общем объёме профиля нет.
|
|
78
|
+
|
|
79
|
+
POC находится в центре корзины с наибольшим объёмом. При точном равенстве
|
|
80
|
+
выбирается нижняя корзина. Область объёма начинается с POC и расширяется
|
|
81
|
+
на одну соседнюю корзину за шаг. Выбирается сосед с большим объёмом,
|
|
82
|
+
при равенстве выбирается нижний. Если с одной стороны корзины закончились,
|
|
83
|
+
расширение идёт в другую. Пустые промежуточные корзины включаются.
|
|
84
|
+
Расширение заканчивается при достижении заданной доли общего объёма.
|
|
85
|
+
VAL равен нижнему краю области, VAH равен верхнему. Доля по умолчанию 70%.
|
|
86
|
+
|
|
87
|
+
Существующий `priceVolumeProfile` складывает весь объём свечи в одну из
|
|
88
|
+
24 корзин по типичной цене. `volumeStructure` распределяет объём по телу
|
|
89
|
+
и теням в 20 строках последних 180 баров и пропускает свечи нулевой ширины.
|
|
90
|
+
Оба текущих контракта возвращают POC, но не VAH/VAL. Их результаты здесь
|
|
91
|
+
не используются.
|
|
92
|
+
|
|
93
|
+
## Вход и сопровождение
|
|
94
|
+
|
|
95
|
+
Новое ожидание выхода разрешено, если предыдущее закрытие строго внутри
|
|
96
|
+
текущей области. Для LONG нужен `low < VAL`, для SHORT нужен `high > VAH`.
|
|
97
|
+
Вход появляется только при закрытии строго между VAL и VAH.
|
|
98
|
+
Выход и возврат могут произойти в одной закрытой свече. Само касание границы
|
|
99
|
+
возвратом не считается. Свеча, пересёкшая обе границы, отменяет ожидание,
|
|
100
|
+
поскольку порядок движений неизвестен.
|
|
101
|
+
|
|
102
|
+
На возврат отводится четыре следующих бара, включая четвёртый.
|
|
103
|
+
Более поздний возврат отменяется. Ожидание также отменяется при пропуске
|
|
104
|
+
свечи, смене дневного профиля или закрытии за противоположной границей.
|
|
105
|
+
После истечения срока продолжение движения вне области не запускает новое
|
|
106
|
+
ожидание. Для нового выхода требуется предыдущее закрытие внутри области.
|
|
107
|
+
Успешный пробой не создаёт позицию по направлению пробоя.
|
|
108
|
+
|
|
109
|
+
Цель равна POC профиля входа. Стоп для LONG расположен ниже минимума всего
|
|
110
|
+
выхода, для SHORT выше максимума. В экстремум входит свеча возврата.
|
|
111
|
+
Буфер равен `0.25 * ATR`. ATR считается как среднее последних 14 истинных
|
|
112
|
+
диапазонов закрытых баров исполнения, включая свечу возврата.
|
|
113
|
+
После пропуска свечи его накопление начинается заново.
|
|
114
|
+
|
|
115
|
+
Минимальное отношение ожидаемой прибыли к риску равно 1.5 после оценок
|
|
116
|
+
комиссии и проскальзывания. При цене входа `E`, стопе `S`, цели `T` и
|
|
117
|
+
односторонней оценке затрат `c` риск на единицу равен
|
|
118
|
+
`abs(E - S) + (E + S) * c`, прибыль равна `abs(T - E) - (E + T) * c`.
|
|
119
|
+
Перед расчётом проверяется правильная сторона стопа и цели.
|
|
120
|
+
`c = RISK_FEE_RATE + (RISK_SLIPPAGE_BPS + RISK_MARKET_IMPACT_BPS) / 10000`.
|
|
121
|
+
Объём позиции равен `MAX_LOSS_VALUE / риск на единицу`. Затраты исполнения
|
|
122
|
+
бэктеста задаются отдельно от этих оценок допуска сделки.
|
|
123
|
+
Поле `prices.riskRatio` общий runtime считает без затрат. Для проверки допуска
|
|
124
|
+
в сигнале сохранено `indicators.valueAreaReclaim.netRiskRatio` с учётом затрат.
|
|
125
|
+
|
|
126
|
+
По умолчанию разрешено одно решение о входе на направление за дневной профиль
|
|
127
|
+
и пауза восемь баров между решениями для обоих направлений вместе.
|
|
128
|
+
Ровно на границе восьми баров пауза ещё действует. Даже решение, позднее
|
|
129
|
+
отклонённое политикой host, расходует дневную попытку. Число попыток
|
|
130
|
+
сбрасывается в новом UTC-дне, а пауза сохраняется.
|
|
131
|
+
|
|
132
|
+
Открытая позиция сохраняет исходные стоп и цель при смене профиля.
|
|
133
|
+
Новые выходы за границы во время позиции не накапливаются.
|
|
134
|
+
Через 32 бара от решения о входе ядро возвращает `strategyApi.exit()`.
|
|
135
|
+
Ожидание возврата, пауза, ATR и удержание считаются в барах исполнения.
|
|
136
|
+
Например, 32 бара означают 8 часов на `15m` и 32 часа на `1h`.
|
|
137
|
+
TP/SL исполняет общий runtime. Если после холодного запуска обнаружена
|
|
138
|
+
позиция без восстановленного времени входа, ядро возвращает выход
|
|
139
|
+
`VAR_POSITION_WITHOUT_CHECKPOINT`. Время открытия позиции отсутствует
|
|
140
|
+
в текущем контракте `getCurrentPosition()`.
|
|
141
|
+
|
|
142
|
+
## Восстановление и ресурсы
|
|
143
|
+
|
|
144
|
+
`createValueAreaReclaimEngine({ initialCandles, config })` прогоняет историю
|
|
145
|
+
через те же переходы, что `next(candle)`. `getState()` возвращает полную
|
|
146
|
+
копию состояния с версией `value-area-reclaim/v1`. Для восстановления
|
|
147
|
+
передайте её как `checkpoint`; JSON-сериализация поддерживается.
|
|
148
|
+
Для чистого движка `1h` передайте также `profileForDay(day)`, возвращающий
|
|
149
|
+
заранее рассчитанный профиль из закрытых `15m` или `null` при его отсутствии.
|
|
150
|
+
Функция вызывается только при смене UTC-дня, включая начальную историю.
|
|
151
|
+
Уже сохранённый профиль после восстановления повторно загружать не нужно.
|
|
152
|
+
Несовместимые версия или конфигурация отклоняются.
|
|
153
|
+
|
|
154
|
+
Ядро хранит обычные сериализуемые объекты в `createStateController()`.
|
|
155
|
+
Ключ включает всю разобранную конфигурацию, чтобы разные ячейки сетки
|
|
156
|
+
не разделяли ожидания и ограничения входов. Для полного восстановления
|
|
157
|
+
нужны состояние движка, дневные попытки, пауза и время решения об открытии.
|
|
158
|
+
Движок сам не восстанавливает исполненные сделки из ценовой истории.
|
|
159
|
+
Холодный запуск без checkpoint не сохраняет прежние попытки входов.
|
|
160
|
+
Пакет не добавляет хранение состояния в Redis или на диск.
|
|
161
|
+
|
|
162
|
+
В памяти остаются максимум `96 * (profileDays + 1)` исходных свечей,
|
|
163
|
+
до 96 истинных диапазонов, 48 корзин и одно ожидание выхода.
|
|
164
|
+
На `1h` массив исходных свечей в состоянии пуст, после дневного расчёта
|
|
165
|
+
сохраняется только профиль. На обоих интервалах память ограничена.
|
|
166
|
+
`profileDays` ограничен диапазоном от 2 до 14. Пересчёт стоит
|
|
167
|
+
`O(profileDays * 96 * 48)` один раз за UTC-день.
|
|
168
|
+
Начальное чтение `data` выполняется один раз на новое состояние контроллера.
|
|
169
|
+
Повтор текущего timestamp не продвигает движок и не создаёт второй вход.
|
|
170
|
+
Более ранний timestamp отклоняется.
|
|
171
|
+
|
|
172
|
+
Figures содержат VAH, VAL, POC, период исходных данных, цену входа,
|
|
173
|
+
стоп и цель. Уровни рисуются с момента доступности профиля, а период
|
|
174
|
+
расчёта показан отдельной областью и UTC-аннотацией. Линии входа, стопа и цели
|
|
175
|
+
начинаются с момента решения и продолжаются на один бар исполнения. Это
|
|
176
|
+
проекция известных уровней; будущие свечи для неё не читаются.
|
|
177
|
+
Стабильный `setupId` связывает сигнал с исходным выходом за границу
|
|
178
|
+
и сохраняется после восстановления состояния.
|
|
179
|
+
|
|
180
|
+
## Проверка пакета и будущий бэктест
|
|
181
|
+
|
|
182
|
+
Нужны Node.js 24 и Yarn 4.13.0. В каталоге стратегии установите
|
|
183
|
+
зависимости из lockfile и запустите проверки:
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
yarn install --immutable
|
|
187
|
+
yarn checks
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
В `examples/backtest-grid.json` сохранена сетка из одной конфигурации,
|
|
191
|
+
в `examples/backtest-plan.json` заданы точное окно, USDT-инструменты,
|
|
192
|
+
прогрев и отдельная модель затрат исполнения. Вариант для `1h` сохранён
|
|
193
|
+
в `examples/backtest-grid-1h.json` и `examples/backtest-plan-1h.json`.
|
|
194
|
+
Он требует кэш `15m` для профиля и отдельный кэш `1h` для исполнения.
|
|
195
|
+
Подключение пакета в Project и импорт сетки в backtest-конфигурацию потребуют отдельного изменения.
|
|
196
|
+
Состав и runtime-конфигурация Project не менялись. Исследовательские прогоны
|
|
197
|
+
выполнялись из Project через отдельную загрузку пакета из исходников.
|
|
198
|
+
Для них использовались отдельные backtest-конфигурации Redis.
|
|
199
|
+
Для запуска `1h` нужны `@tradejs/core` и `@tradejs/types` версии
|
|
200
|
+
`3.1.29-beta.281` или новее с поддержкой `getClosedCandles`.
|
|
201
|
+
|
|
202
|
+
После подключения проверенного пакета и импорта сетки под именем
|
|
203
|
+
`ValueAreaReclaim:v1` будущий запуск из `tradejs-project` выглядит так:
|
|
204
|
+
|
|
205
|
+
```bash
|
|
206
|
+
TRADEJS_SOURCE_REPOSITORY_ROOT=/Users/aleksnick/dev/tradejs/tradejs-strategy-value-area-reclaim \
|
|
207
|
+
TRADEJS_FRAMEWORK_REPOSITORY_ROOT=/Users/aleksnick/dev/tradejs/investing \
|
|
208
|
+
yarn backtest -c ValueAreaReclaim:v1 -t BTCUSDT,ETHUSDT -f 15 \
|
|
209
|
+
--startTime 1790121600000 --endTime 1792713600000 \
|
|
210
|
+
--backtestPriceMode close --backtestEntryDelayBars 0 \
|
|
211
|
+
--executionCosts '{"fees":{"makerRate":0.0006,"takerRate":0.0006},"slippage":{"baseBps":2,"spreadMultiplier":0,"marketImpactBps":0,"delayRiskMultiplier":0},"funding":{"enabled":false}}' \
|
|
212
|
+
--cacheOnly --fast -p 1
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
Нулевая задержка и `close` обязательны для версии 1. Иные значения
|
|
216
|
+
отклоняются парсером. При отсутствии достаточного прогрева пакет ждёт
|
|
217
|
+
завершённые дни, поэтому холодный короткий запуск и срез длинного запуска
|
|
218
|
+
могут иметь разные результаты. Перед исследованием нужно зафиксировать
|
|
219
|
+
Git SHA пакета, framework и Project, сумму SHA-256 файлов конфигурации
|
|
220
|
+
и фактическое покрытие кэша. Результаты исследования относятся только
|
|
221
|
+
к зафиксированным правилам, данным и модели затрат.
|
|
222
|
+
|
|
223
|
+
Для будущего запуска `1h` используйте конфигурацию `ValueAreaReclaim:v1-1h`
|
|
224
|
+
и `-f 60` с тем же точным окном и моделью затрат. Профиль по-прежнему требует
|
|
225
|
+
историю `15m` от начала трёх завершённых дней перед стартом.
|
|
226
|
+
|
|
227
|
+
## Ограничения OHLCV
|
|
228
|
+
|
|
229
|
+
Равномерное распределение по диапазону свечи является выбранной моделью,
|
|
230
|
+
а не измеренным биржевым объёмом по цене. OHLCV не показывает путь цены,
|
|
231
|
+
очередность сделок и фактическое распределение объёма внутри свечи.
|
|
232
|
+
POC и границы области зависят от модели, числа корзин и длины окна.
|
|
233
|
+
Объём разных провайдеров и единиц измерения нельзя смешивать.
|
|
234
|
+
Вход по закрытию также не доказывает возможность исполнения по этой цене.
|
|
235
|
+
Стоп с буфером и расчётный риск не ограничивают потери при разрывах цены
|
|
236
|
+
или фактическом проскальзывании сверх заложенной оценки.
|