Руководство по интеграции
Синтез глубинного исследования по сеточной торговле. Главный тезис: **альфа грида в 2026 — не в «граале» параметров, а в надёжности риск-обёртки вокруг алгоритма.** Примитив «установил и забыл» в динамичном рынке — это гарантированная трансформация impermanent loss в постоянный убыток, а при плече — ликвидация.
## 1. Профиль риска: short gamma
Грид-бот = маркет-мейкер: лимитки на покупку ниже цены, на продажу выше, зарабатывает на спреде. Профиль **short gamma**: прибыль от стабильности и шума, убыток от направленного движения за пределы диапазона.
Три зоны состояния:
- **Зона прибыли** — цена пилит внутри границ, каждое колебание = реализованный профит.
- **Зона предупреждения** — растёт нереализованный убыток, пока компенсируется накопленной сеточной прибылью (impermanent loss).
- **Зона разорения** — цена пробила границы, усреднение не работает, убыток растёт линейно/экспоненциально, генерация профита остановлена. Риск из операционного → катастрофический.
## 2. Нормализация волатильности (ATR)
Нельзя гонять один шаг на BTC и на мемкоине. Калибровка через ATR:
• Класс — V_norm (дневной) — Примеры
• Низкая вола — 1.5–3.5% — BTC, стейбл-пары
• Средняя — 3.5–7.0% — ETH, SOL, крупные L1
• Высокая — 7.0–15%+ — мемы, GameFi, low-cap
Калибровать на **90-м перцентиле ATR за 180 дней**, не на медиане за 30 дней — иначе survivorship bias: узкая сетка в тихий период мгновенно вылетает за диапазон при возврате волатильности.
## 3. Два режима: Turbo и Wide
**Turbo (микро-скальпинг в зоне комфорта):**
- Шаг = `0.25 · ATR_daily`. Если ATR_d = 4%, шаг = 1% → цене нужно пройти четверть дневного диапазона до следующего уровня. Статистически — многократно в сутки.
- **Fee Firewall:** минимальный шаг = `комиссия_круга / (1 − profit_margin)`. При комиссии круга 0.06% и марже 0.5 → мин. шаг 0.12%. Ниже — OS форсит пол или уходит в ожидание. Иначе churning: комса съедает 80% профита.
**Wide (трендовая устойчивость):**
- Шаг = `1.5 · ATR_daily` — цене нужно неординарное движение (1.5σ), чтобы сработал следующий ордер. «Растягивает» капитал на глубокие просадки.
- Диапазон = `±3 · ATR_daily` (правило 3σ, 99.7% покрытие).
## 4. Переключение режимов с гистерезисом
Хаотичное «мерцание» режимов = постоянная отмена/пересоздание ордеров. Нужен гистерезис:
**Turbo → Wide (опасность, МГНОВЕННО)** при любом из:
- ATR-спайк: текущий ATR > 30d-MA на +20%.
- Пробой Боллинджера: закрытие свечи за 2.0 SD.
- ADX > 25 (сильный тренд — узкие Turbo-сетки сметёт).
**Wide → Turbo (успокоение, с задержкой):** условия стабильности держатся **48 часов** (8 свечей 4H).
## 5. Stop & Rebuild вместо жёсткого стопа
Жёсткий стоп (-10%) выбивается шпильками. Вместо него — **Grid Efficiency Ratio (GER)** = сеточный_профит / |плавающий_убыток|.
**Soft Stop:** если GER < 0.3 более 24ч (на каждый $1 плавающего убытка сетка дала <30¢) → стратегия неэффективна. Действие: **остановка новых ордеров + отмена лимиток, БЕЗ рыночной продажи** (не продаём в шпильку).
**Rebuild (рециркуляция инвентаря):** остался объём, купленный дорого. Разворачиваем новую Wide-сетку вокруг текущей цены; профит новой сетки не выводим, а **математически вычитаем из стоимости приобретения замороженного инвентаря** → снижаем breakeven. Как только цена достигает сниженного breakeven — выходим «в ноль» сильно раньше, чем цена вернётся к первоначальному входу.
## 6. Cross Firewall — сегментация рисков
- **Effective Leverage Cap:** Turbo ≤3x, Wide ≤2x, Rebuild 1x. Если расчётное эффективное плечо выше — OS блокирует новые ордера даже при доступной марже.
- **Delist-Score (0–100):** volume + spread + depth + Binance Monitoring Tag.
- 0–40 🟢 торговля разрешена; 41–70 🟡 только Wide, размер ×0.5; 71–100 🔴 hard exit.
- **Sub-account изоляция** некоррелированных стратегий (cross-margin заражает портфель при каскаде).
## 7. Funding-Drag Firewall
На фьючерсах/лоу-капах фандинг 0.05–0.1%/8ч (APR 50–100%). Если фандинг высокий, удержание позиции дороже колебательного профита — Turbo с мелкими профитами умирает первым. Отключать грид при превышении точки безубыточности по фандингу.
## 8. Hedge Basket — «дивергенция к центру»
Хеджировать «бету» всего портфеля корзиной ликвидных шортов: **ETH 40% / SOL 30% / DOGE 30%**. Прогрессивно:
- L1 Normal — хедж 0%.
- L2 Caution — 30% (BTC < EMA-20 Daily ИЛИ крипто-VIX +5%/день).
- L3 Emergency — 80–100% delta-neutral (просадка >10%/24ч ИЛИ margin load >50%).
## 9. Операционная надёжность
- **Density:** число ордеров = производная от депозита и мин-лота (×1.1 буфер). Если мало капитала для нужной плотности Turbo — расширять шаг (→Wide), а не делать «дыры» в покрытии.
- **Dead Man's Switch:** heartbeat каждые 60с в независимый watchdog. Нет сигнала 5 мин → резервный API-ключ шлёт **Cancel All Open Orders** + алерт в Telegram. Висящие ордера с плечом без присмотра недопустимы.
- **Rate Limits:** Turbo упирается в лимиты API — батчить отмены/постановки, иначе бан и потеря управления.
## Применение к нашей системе
Реализовано в `grid_live_v2.py`: ATR-калибровка шага (Turbo/Wide), Fee Firewall, ±3σ Wide-range, regime switching с гистерезисом, GER soft-stop, effective leverage cap, dead-man heartbeat. Это апгрейд v1 (который был фикс-N_LEVELS + грубый breakout-flatten) до риск-обёртки уровня спецификации.
## 1. Профиль риска: short gamma
Грид-бот = маркет-мейкер: лимитки на покупку ниже цены, на продажу выше, зарабатывает на спреде. Профиль **short gamma**: прибыль от стабильности и шума, убыток от направленного движения за пределы диапазона.
Три зоны состояния:
- **Зона прибыли** — цена пилит внутри границ, каждое колебание = реализованный профит.
- **Зона предупреждения** — растёт нереализованный убыток, пока компенсируется накопленной сеточной прибылью (impermanent loss).
- **Зона разорения** — цена пробила границы, усреднение не работает, убыток растёт линейно/экспоненциально, генерация профита остановлена. Риск из операционного → катастрофический.
## 2. Нормализация волатильности (ATR)
Нельзя гонять один шаг на BTC и на мемкоине. Калибровка через ATR:
• Класс — V_norm (дневной) — Примеры
• Низкая вола — 1.5–3.5% — BTC, стейбл-пары
• Средняя — 3.5–7.0% — ETH, SOL, крупные L1
• Высокая — 7.0–15%+ — мемы, GameFi, low-cap
Калибровать на **90-м перцентиле ATR за 180 дней**, не на медиане за 30 дней — иначе survivorship bias: узкая сетка в тихий период мгновенно вылетает за диапазон при возврате волатильности.
## 3. Два режима: Turbo и Wide
**Turbo (микро-скальпинг в зоне комфорта):**
- Шаг = `0.25 · ATR_daily`. Если ATR_d = 4%, шаг = 1% → цене нужно пройти четверть дневного диапазона до следующего уровня. Статистически — многократно в сутки.
- **Fee Firewall:** минимальный шаг = `комиссия_круга / (1 − profit_margin)`. При комиссии круга 0.06% и марже 0.5 → мин. шаг 0.12%. Ниже — OS форсит пол или уходит в ожидание. Иначе churning: комса съедает 80% профита.
**Wide (трендовая устойчивость):**
- Шаг = `1.5 · ATR_daily` — цене нужно неординарное движение (1.5σ), чтобы сработал следующий ордер. «Растягивает» капитал на глубокие просадки.
- Диапазон = `±3 · ATR_daily` (правило 3σ, 99.7% покрытие).
## 4. Переключение режимов с гистерезисом
Хаотичное «мерцание» режимов = постоянная отмена/пересоздание ордеров. Нужен гистерезис:
**Turbo → Wide (опасность, МГНОВЕННО)** при любом из:
- ATR-спайк: текущий ATR > 30d-MA на +20%.
- Пробой Боллинджера: закрытие свечи за 2.0 SD.
- ADX > 25 (сильный тренд — узкие Turbo-сетки сметёт).
**Wide → Turbo (успокоение, с задержкой):** условия стабильности держатся **48 часов** (8 свечей 4H).
## 5. Stop & Rebuild вместо жёсткого стопа
Жёсткий стоп (-10%) выбивается шпильками. Вместо него — **Grid Efficiency Ratio (GER)** = сеточный_профит / |плавающий_убыток|.
**Soft Stop:** если GER < 0.3 более 24ч (на каждый $1 плавающего убытка сетка дала <30¢) → стратегия неэффективна. Действие: **остановка новых ордеров + отмена лимиток, БЕЗ рыночной продажи** (не продаём в шпильку).
**Rebuild (рециркуляция инвентаря):** остался объём, купленный дорого. Разворачиваем новую Wide-сетку вокруг текущей цены; профит новой сетки не выводим, а **математически вычитаем из стоимости приобретения замороженного инвентаря** → снижаем breakeven. Как только цена достигает сниженного breakeven — выходим «в ноль» сильно раньше, чем цена вернётся к первоначальному входу.
## 6. Cross Firewall — сегментация рисков
- **Effective Leverage Cap:** Turbo ≤3x, Wide ≤2x, Rebuild 1x. Если расчётное эффективное плечо выше — OS блокирует новые ордера даже при доступной марже.
- **Delist-Score (0–100):** volume + spread + depth + Binance Monitoring Tag.
- 0–40 🟢 торговля разрешена; 41–70 🟡 только Wide, размер ×0.5; 71–100 🔴 hard exit.
- **Sub-account изоляция** некоррелированных стратегий (cross-margin заражает портфель при каскаде).
## 7. Funding-Drag Firewall
На фьючерсах/лоу-капах фандинг 0.05–0.1%/8ч (APR 50–100%). Если фандинг высокий, удержание позиции дороже колебательного профита — Turbo с мелкими профитами умирает первым. Отключать грид при превышении точки безубыточности по фандингу.
## 8. Hedge Basket — «дивергенция к центру»
Хеджировать «бету» всего портфеля корзиной ликвидных шортов: **ETH 40% / SOL 30% / DOGE 30%**. Прогрессивно:
- L1 Normal — хедж 0%.
- L2 Caution — 30% (BTC < EMA-20 Daily ИЛИ крипто-VIX +5%/день).
- L3 Emergency — 80–100% delta-neutral (просадка >10%/24ч ИЛИ margin load >50%).
## 9. Операционная надёжность
- **Density:** число ордеров = производная от депозита и мин-лота (×1.1 буфер). Если мало капитала для нужной плотности Turbo — расширять шаг (→Wide), а не делать «дыры» в покрытии.
- **Dead Man's Switch:** heartbeat каждые 60с в независимый watchdog. Нет сигнала 5 мин → резервный API-ключ шлёт **Cancel All Open Orders** + алерт в Telegram. Висящие ордера с плечом без присмотра недопустимы.
- **Rate Limits:** Turbo упирается в лимиты API — батчить отмены/постановки, иначе бан и потеря управления.
## Применение к нашей системе
Реализовано в `grid_live_v2.py`: ATR-калибровка шага (Turbo/Wide), Fee Firewall, ±3σ Wide-range, regime switching с гистерезисом, GER soft-stop, effective leverage cap, dead-man heartbeat. Это апгрейд v1 (который был фикс-N_LEVELS + грубый breakout-flatten) до риск-обёртки уровня спецификации.