crypto-sentinel

Educational crypto market analysis bot for Telegram — exchange data via ccxt, statistical scoring, Kelly-criterion risk models.

Comment

CryptoSentinel

Professional Crypto Trading Signal Bot for Telegram
Spot · Futures · Arbitrage · Elite Strategy · Sniper Engine

Python Signals Win Rate Exchanges Docker License

English · Русский

Overview

CryptoSentinel is a production-grade Telegram trading signal bot that monitors crypto markets 24/7 and delivers high-precision entry signals with full risk management.

Unlike simple signal bots, CryptoSentinel implements hedge-fund-level analytics: multi-timeframe confluence, smart money concepts (liquidity sweeps, order blocks), Bayesian probability scoring, Kelly Criterion position sizing, and cross-exchange arbitrage detection.

Features

Module Description
Spot Signals RSI, EMA, OBV, Fibonacci levels, pivot points, volume profile confluence
Futures Signals Leveraged directional trades with ATR-based SL/TP and funding rate awareness
Arbitrage Cross-exchange price gap detection (Binance / Bybit / MEXC) with transfer cost modeling
Elite Strategy Multi-timeframe analysis, order blocks, liquidity zones, 70%+ target win rate
Sniper Engine Low-frequency breakout entries — 2-3 high-conviction setups per session
News & Sentiment Real-time news aggregation with market sentiment scoring
Backtesting Historical simulation with realistic slippage, fees, funding rates, liquidation
Risk Management Kelly Criterion position sizing, max drawdown guardrails, per-trade R:R filtering
Storage SQLite signal history with full payload logging

Architecture

src/binance_signal_bot/
├── config.py               # Frozen dataclass settings (env-driven)
├── binance_client.py       # Binance REST API client (spot + futures)
├── telegram_bot.py         # Telegram bot: /start, inline menus, scheduled signals
│
├── signals/
│   ├── spot.py             # SpotSignalOptimizer — multi-factor spot analysis
│   ├── futures.py          # FuturesSignalOptimizer — leveraged directional signals
│   └── arbitrage.py        # ArbitrageOptimizer — cross-exchange gap detection
│
├── elite_strategy.py       # EliteStrategyEngine — hedge-fund level analysis
├── sniper_engine.py        # SniperEngine — breakout sniper entries
├── backtest_engine.py      # Historical backtesting with realistic simulation
├── simulator.py            # Virtual positions, P&L tracking
│
├── indicators.py           # RSI, EMA, MACD, Bollinger, Stoch, ADX, ATR, OBV, VWAP
├── levels.py               # Fibonacci, pivot points, swing extremes, volume profile
├── probability.py          # Bayesian probability model (Laplace smoothing)
├── scoring.py              # Multi-factor confidence scoring
├── risk.py                 # Kelly Criterion position sizing
├── fees.py                 # Fee + slippage round-trip cost model
├── news.py                 # News aggregator + sentiment scoring
├── sentiment_analyzer.py   # Keyword-based market sentiment
└── time_features.py        # Time-of-day / seasonality scoring

Quick Start

Prerequisites

  • Python 3.12+
  • Docker (recommended) or manual setup
  • Telegram Bot token (from @BotFather)

Docker (recommended)

git clone https://github.com/ambartsumov/crypto-sentinel.git
cd crypto-sentinel
cp .env.example .env
# Edit .env — add TELEGRAM_TOKEN and configure watchlists
docker compose up -d

Manual setup

git clone https://github.com/ambartsumov/crypto-sentinel.git
cd crypto-sentinel
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env
python run.py

Configuration

Copy .env.example to .env and fill in:

# Required
TELEGRAM_TOKEN=your_bot_token

# Watchlists (comma-separated Binance symbols)
SPOT_WATCHLIST=BTCUSDT,ETHUSDT,BNBUSDT,SOLUSDT,XRPUSDT
FUTURES_WATCHLIST=BTCUSDT,ETHUSDT,BNBUSDT,SOLUSDT

# Signal thresholds (tuned for 70%+ win rate)
SPOT_MIN_PROFIT_USD=10
FUTURES_MIN_PROFIT_USD=20
ARBITRAGE_MIN_PROFIT_PERCENT=2.5
MIN_RELIABILITY_SPOT=0.78
MIN_RELIABILITY_FUTURES=0.80
MIN_PROBABILITY=0.70
HISTORICAL_ACCURACY=0.85

# Risk limits
SPOT_RISK_PCT=0.02
FUTURES_RISK_PCT=0.01

Full list of parameters: see .env.example.

Bot Commands

Command Description
/start Welcome screen with mode selector
Select SPOT Enter deposit → get best spot signal
Select FUTURES Enter deposit → get best futures signal
Select ARBITRAGE Enter deposit → get best arbitrage opportunity
Repeat Signal Re-run same analysis
Menu Return to main menu

Scripts

Script Description
scripts/run_elite_bot.py Run Elite Strategy (backtest or live simulation)
scripts/live_paper_trader.py Paper trading with virtual positions
scripts/auto_tune_sniper.py Auto-tune Sniper Engine parameters
scripts/optimize_strategy.py Grid search over strategy parameters
scripts/portfolio_backtest.py Multi-asset portfolio backtesting
scripts/replay_live_market_tests.py Replay historical market scenarios

Tech Stack

  • Language: Python 3.12
  • Bot Framework: python-telegram-bot 21.x
  • Market Data: Binance REST API (public endpoints, no API key required for signals)
  • Multi-exchange: ccxt 4.4 (Bybit, MEXC arbitrage)
  • Math / Indicators: numpy
  • Config: pydantic 2, python-dotenv
  • HTTP: httpx
  • Storage: SQLite
  • Container: Docker + Docker Compose

License

MIT License — see LICENSE

Author

Ambartsumov Vyacheslav — GitHub

Disclaimer: This bot generates trading signals for educational and research purposes. It does not constitute financial advice. Crypto trading involves significant risk. Always do your own research.

Описание

CryptoSentinel — production-ready Telegram-бот для торговых сигналов, который мониторит крипторынок 24/7 и отправляет высокоточные сигналы входа с полным риск-менеджментом.

В отличие от простых сигнальных ботов, CryptoSentinel использует аналитику уровня хедж-фонда: мультитаймфреймовую конфлюэнтность, концепции умных денег (ликвидность, ордерные блоки), байесовское оценивание вероятности, критерий Келли для позиционирования и обнаружение кросс-биржевого арбитража.

Возможности

Модуль Описание
Spot-сигналы RSI, EMA, OBV, уровни Фибоначчи, пивоты, профиль объёма
Futures-сигналы Направленные сделки с ATR-стоп-лоссом, учёт ставки финансирования
Арбитраж Обнаружение разрывов цены между биржами (Binance / Bybit / MEXC)
Elite Strategy Мультитаймфреймовый анализ, ордерные блоки, зоны ликвидности, цель 70%+
Sniper Engine Снайперские входы на пробой — 2-3 высококонвикционных сетапа за сессию
Новости и настроение Агрегация новостей в реальном времени, скоринг рыночных настроений
Бэктестинг Историческая симуляция: реалистичный проскальзывание, комиссии, ставки финансирования
Риск-менеджмент Критерий Келли, ограничения просадки, фильтрация по R:R на сделку
Хранение данных История сигналов в SQLite с полным логированием

Архитектура

src/binance_signal_bot/
├── config.py               # Настройки через frozen dataclass (из .env)
├── binance_client.py       # REST-клиент Binance (спот + фьючерсы)
├── telegram_bot.py         # Telegram: /start, инлайн-меню, запланированные сигналы
│
├── signals/
│   ├── spot.py             # SpotSignalOptimizer — мультифакторный спот-анализ
│   ├── futures.py          # FuturesSignalOptimizer — направленные фьючерсные сигналы
│   └── arbitrage.py        # ArbitrageOptimizer — кросс-биржевые возможности
│
├── elite_strategy.py       # EliteStrategyEngine — анализ уровня хедж-фонда
├── sniper_engine.py        # SniperEngine — снайперские входы на пробой
├── backtest_engine.py      # Исторический бэктест с реалистичной симуляцией
├── simulator.py            # Виртуальные позиции, отслеживание P&L
│
├── indicators.py           # RSI, EMA, MACD, Bollinger, Stoch, ADX, ATR, OBV, VWAP
├── levels.py               # Фибоначчи, пивоты, экстремумы свингов, профиль объёма
├── probability.py          # Байесовская модель вероятности (сглаживание Лапласа)
├── scoring.py              # Мультифакторный скоринг уверенности
├── risk.py                 # Позиционирование по критерию Келли
├── fees.py                 # Модель комиссий + проскальзывание (round-trip)
├── news.py                 # Агрегатор новостей + скоринг настроений
├── sentiment_analyzer.py   # Анализ рыночных настроений по ключевым словам
└── time_features.py        # Скоринг времени суток и сезонности

Быстрый старт

Docker (рекомендуется)

git clone https://github.com/ambartsumov/crypto-sentinel.git
cd crypto-sentinel
cp .env.example .env
# Заполнить .env: добавить TELEGRAM_TOKEN, настроить вотчлисты
docker compose up -d

Ручная установка

git clone https://github.com/ambartsumov/crypto-sentinel.git
cd crypto-sentinel
python -m venv venv
venv\Scripts\activate  # Linux/Mac: source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python run.py

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

Скопировать .env.example в .env и заполнить:

# Обязательно
TELEGRAM_TOKEN=токен_бота

# Вотчлисты (символы Binance через запятую)
SPOT_WATCHLIST=BTCUSDT,ETHUSDT,BNBUSDT,SOLUSDT,XRPUSDT
FUTURES_WATCHLIST=BTCUSDT,ETHUSDT,BNBUSDT,SOLUSDT

# Фильтры сигналов (настроено для 70%+ выигрышей)
SPOT_MIN_PROFIT_USD=10
FUTURES_MIN_PROFIT_USD=20
MIN_RELIABILITY_SPOT=0.78
MIN_PROBABILITY=0.70
HISTORICAL_ACCURACY=0.85

# Риск-лимиты
SPOT_RISK_PCT=0.02
FUTURES_RISK_PCT=0.01

Команды бота

Кнопка Описание
/start Экран приветствия с выбором режима
SPOT Ввести депозит → получить лучший спот-сигнал
FUTURES Ввести депозит → получить лучший фьючерсный сигнал
ARBITRAGE Ввести депозит → получить лучшую арбитражную возможность
Повторить сигнал Перезапустить тот же анализ
Меню Вернуться в главное меню

Стек

  • Язык: Python 3.12
  • Фреймворк бота: python-telegram-bot 21.x
  • Рыночные данные: Binance REST API (публичные эндпоинты, API-ключ не нужен)
  • Мультибиржевость: ccxt 4.4 (арбитраж Bybit, MEXC)
  • Математика / Индикаторы: numpy
  • Конфигурация: pydantic 2, python-dotenv
  • HTTP: httpx
  • Хранение: SQLite
  • Контейнер: Docker + Docker Compose

Лицензия

MIT License — см. LICENSE

Автор

Амбарцумов Вячеслав — GitHub

Дисклеймер: Бот генерирует торговые сигналы в образовательных и исследовательских целях. Не является финансовым советом. Торговля криптовалютой несёт значительный риск. Проводите собственный анализ.

Built With

Share this project:

Updates