DEV Community

Alexey Polyakov
Alexey Polyakov

Posted on • Originally published at github.com

Bybit-WS: AI-Native Trading Engine — как я построил автономного трейдингового агента за 8 месяцев

Bybit-WS: AI-Native Trading Engine — как я построил автономного трейдингового агента за 8 месяцев

О чём речь

bybit-ws — это не очередной торговый бот. Это движок, спроектированный для AI-агентов. Он даёт твоему Claude Code, Codex или Cursor REST API, MCP-сервер и Python SDK — и агент сам сканирует рынок, входит в позиции, управляет рисками. Без человека в цикле.

Код: github.com/poliakarmai/bybit-ws

Торгует на Bybit с марта 2025. С июня 2026 — в Open Source. MIT.

Почему не freqtrade / hummingbot?

Есть два класса трейдинговых инструментов:

Фреймворки bybit-ws
Пишешь стратегию сам
8 готовых стратегий из коробки
MCP-сервер для AI-агентов
Один YAML-конфиг
Нет базы данных ❌ (SQLite)

freqtrade и hummingbot — фреймворки. Ты кодишь стратегию. bybit-ws — готовый движок. Ты настраиваешь YAML, запускаешь, подключаешь AI-агента.

Фреймворки хороши для исследователей. bybit-ws — для тех, кому нужно работать здесь и сейчас.

Архитектура

Два слоя:

Интерфейсы (как AI-агенты общаются):

AI Agent (Claude Code / Codex / Cursor / Hermes)
    ├── REST API (port 8766) — scan, enter, close, positions
    ├── MCP Server — scan_market, get_positions, get_metrics
    └── Python SDK — from bybit_ws_sdk import Monitor
Enter fullscreen mode Exit fullscreen mode

Движок (30-секундный цикл, systemd или Docker):

  • 7 стратегий + DCA overlay
  • Динамический сайзинг позиций (% от депозита × conviction score)
  • Автоматический SL/TP через trading-stop
  • X10 safety pack: ATR-валидация, дневные лимиты убытков, кулдауны
  • Корреляционная матрица, фандинг-трекер, классификатор режима рынка
  • SVG-дашборд и Telegram-бот @GridSignalBot

7 стратегий

# Стратегия Плечо TF Триггер входа SL
1 BB Grid LONG 3x D BB < 25%, score ≥ 5.5 −7%
2 BB Grid SHORT 3x D BB > 85%, Tier A/B +5-7%
3 Junk SHORT 3x D Pump ≥ 80% −15%
4 SL Re-entry 3x D Лесенка после SL −7%
5 BB Scalp M5 ⚡ 10x M5 Касание полосы + RSI 3%
6 Mean Revert ⚡ 10x D BB% < 5% или > 95% 5%
7 Funding Momentum ⚡ 10x D Funding ±0.1% + тренд 4%

⚡ — x10 плечо, ликвидация при ~10% движении. High risk.

DCA overlay — работает поверх всех стратегий: докупает на −5/−10/−15% от входа (до 2 добавок).

Как AI-агент торгует через bybit-ws

Никакого ручного кликанья. Агент сам принимает решение:

from bybit_ws_sdk import Monitor

m = Monitor("http://localhost:8766", token="your-rpc-token")

# Шаг 1: сканируем рынок
signals = m.scan(mode="long", limit=5)

for s in signals["signals"]:
    if s["score"] >= 7.0:
        # Шаг 2: превью без исполнения (dry-run)
        preview = m.enter(s["symbol"], "Buy", s["qty"], confirm=False)
        print(f"Маржа: ${preview['margin']}, Ликв: ${preview['liq_price']}")

        # Шаг 3: вход с SL и TP
        m.enter(s["symbol"], "Buy", s["qty"],
                sl=preview["sl_suggested"],
                tp=preview["tp_suggested"],
                confirm=True)
Enter fullscreen mode Exit fullscreen mode

И всё. Дальше bybit-ws сам следит за позицией: SL, TP, авто-закрытие при деградации BB, DCA на откатах.

Risk Management

Потому что без защиты на фьючерсах делать нечего:

  • Динамический сайзинг: депозит × risk% / max_positions × conviction score. Больше уверенность → больше позиция
  • Drawdown guard: алерт + опциональный emergency close при −15% от пика депозита
  • Дневной лимит убытков: стоп торговли при −$N за день
  • Корреляционный блок: запрет входа если ≥2 позиции коррелируют >0.8
  • X10 limits: макс 3 убыточных x10 сделки → кулдаун 24 часа
  • Каскадная защита: market-close если цена в 2× ближе к ликвидации чем SL

Безопасность

  • API-ключи через переменные окружения (${BYBIT_API_KEY}), никогда в коде
  • RPC auth: Bearer token на все write-эндпоинты (/enter, /close)
  • Bind 127.0.0.1 по умолчанию — не светим наружу
  • chmod 600 на конфиг
  • Рекомендация: IP whitelist на стороне Bybit

Запуск за 5 минут

git clone https://github.com/poliakarmai/bybit-ws.git
cd bybit-ws
pip install -e .                    # ставит bybit-ws + зависимости
cp config.example.yaml ~/.config/bybit-ws/config.yaml
# Вставь API-ключи и НАЧНИ С ТЕСТНЕТА:
#   api.base_url: "https://api-testnet.bybit.com"
bybit-ws daemon
Enter fullscreen mode Exit fullscreen mode

Всё. Демон запущен, REST API на порту 8766. Здоровье: curl localhost:8766/health.

Что под капотом

  • Python 3.11+, 8500+ строк, 37 модулей
  • Скоринг: 9 метрик (Tier, BB Daily, Volume, Days Falling, Weekly/Monthly BB, Funding, Volatility, Bounce Quality, RSI)
  • Режимы рынка: классификатор определяет тренд/рэндж/волатильность и адаптирует параметры
  • Фандинг-трекер: исторические ставки, прогноз, фильтр входа при минусовом фандинге
  • SVG-дашборд: винрейт, маржа, фандинг, корреляции — обновляется раз в 5 минут
  • Telegram-бот @GridSignalBot: живые сигналы, алерты, утренняя сводка

Production Track Record

Самоотчёт с продакшена. Не аудировано. Прошлые результаты ≠ будущие.

  • Аптайм: 99.7% (30 дней)
  • Сделок: 847 за 30 дней
  • Винрейт (LONG): ~68%
  • Среднее удержание: 14 часов

Roadmap

Следующие шаги:

  • WebSocket миграция — замена REST-поллинга на реальный поток
  • Бэктестинг — прогон стратегий на исторических данных
  • Multi-exchange — Binance, OKX
  • Веб-дашборд — реальный UI вместо SVG

PR'ы приветствуются. См. CONTRIBUTING.

Итог

Я построил этот движок чтобы мой AI-агент (Hermes) мог торговать автономно. Получилось так, что он подходит любому агенту — Claude Code, Codex, Cursor. 8 месяцев разработки, из них 6 в проде на реальных деньгах.

Если ты:

  • AI-разработчик и хочешь чтобы твой агент торговал
  • Квант-трейдер которому нужен API для Bollinger Grid
  • Крипто-энтузиаст который хочет 24/7 мониторинг без кодинга

— клонируй, ставь тестнет, пробуй. Бесплатно. MIT.


⚠️ Дисклеймер: Торговля фьючерсами с плечом — высокий риск. Можно потерять весь депозит. Это не финансовая рекомендация. Начинайте с тестнета.

Top comments (0)