Hedged Trading Bot

Автономный бот для хеджированного парного трейдинга между Bybit и KuCoin. Кратко и по делу: как запустить и использовать в проде.

Основные возможности

• Парный хедж между двумя биржами (BTC/USDT, ETH/USDT, расширяемо)
• Режимы: live, dryrun, backtest, optimize
• Индикаторы: EMA, RSI, MACD, ATR, Bollinger Bands, Volume
• Риск-менеджмент: лимиты просадки, дневные лимиты, размер позиции, контроль спреда
• Telegram-уведомления и логирование
• Веб-дэшборд (Flask + Chart.js, 5 вкладок)
• Стратегии: saved / active / archived

Стек

• Python 3.11
• CCXT, Pandas, NumPy, Optuna, aiohttp
• Flask + Chart.js для UI

Требования

• Linux, Python 3.11+
• Git, Docker (для контейнеров)
• Минимум: 2 CPU, 4 GB RAM, 20 GB SSD

Быстрый старт (локально)

git clone https://github.com/faafaafuu/hedged-b.git
cd hedged-b
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp config.example.yaml config.yaml
mkdir -p data logs

# dry-run
python3 main.py --mode dryrun --config config.yaml

Запуск через Docker

Одиночный контейнер

docker build -t hedged-bot .
docker run --rm \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  -v $(pwd)/strategies:/app/strategies \
  hedged-bot python3 main.py --mode live --config /app/config.yaml

docker-compose (бот + UI)

docker compose up -d --build
# UI: http://localhost:5000

Конфигурация

• config.yaml — основные параметры и API-ключи
• .env — опциональные переменные окружения
• Каталоги: data/, logs/, strategies/

Пример config.yaml (сокращенно):

exchanges:
  bybit:
    api_key: "..."
    api_secret: "..."
    testnet: false
  kucoin:
    api_key: "..."
    api_secret: "..."
    passphrase: "..."
    sandbox: false

trading:
  symbol: "BTC/USDT"
  timeframe: "15m"
  position_size: 0.1
  max_open_cycles: 3

risk:
  max_drawdown_percent: 10.0
  max_daily_loss_percent: 5.0
  max_position_size_percent: 10.0
  max_spread_percent: 0.5

Режимы работы

• live: python3 main.py --mode live --config config.yaml
• dryrun: python3 main.py --mode dryrun --config config.yaml
• backtest: python3 main.py --mode backtest --start-date 2025-01-01 --end-date 2025-06-01 --initial-balance 10000
• optimize: python3 main.py --mode optimize --optimizer bayesian --config config.yaml

UI Dashboard

cd ui
pip install -r requirements.txt
python3 app.py --host 0.0.0.0 --port 5000
# или через docker compose (service ui)

Функции: метрики, активные циклы, стратегии (CRUD), индикаторы, производительность. Обновление каждые 5 секунд.

Структура

bot/            # торговая логика
ui/             # веб-интерфейс
strategies/     # saved / active / archived
config.yaml     # конфигурация
Dockerfile      # контейнер бота
docker-compose.yml

Практика эксплуатации

• Перед live: backtest -> dryrun -> live
• Мониторинг: logs/bot.log или UI
• Деплой на сервер: docker-compose или systemd

Лицензия и отказ от ответственности

• Лицензия: MIT
• Дисклеймер: торговля криптовалютами связана с рисками. Используйте на свой страх и риск. Начинайте с минимальных сумм и включайте лимиты.

Версия: 1.0.0 Последнее обновление: 2025-12-08