Sniper Bot Pro (V8 Async Engine) 🚀

Sniper Bot Pro es una plataforma de trading algorítmico de alta frecuencia diseñada para BTC/USDT en Binance Futures. Utiliza una arquitectura asíncrona (V8 Engine) para análisis de milisegundos, impulsada por Machine Learning (XGBoost) y Análisis Técnico Avanzado (Price Action, FVG, BOS).

---

🔥 Características Principales

🧠 Cerebro Híbrido (ML + Price Action)

• Machine Learning: Modelo XGBoost entrenado para predecir movimientos a 1h (Accuracy > 70%).
• Price Action: Detección en tiempo real de Fair Value Gaps (FVG) y Break of Structure (BOS).
• Order Book Imbalance (OBI): Análisis de liquidez para entradas de precisión.

⚡ Arquitectura V8 Asíncrona

• Zero-Lag UI: Interfaz gráfica (Tkinter) desacoplada del motor de datos.
• Parallel Fetching: Descarga de Klines, Funding y Depth simultáneamente (aiohttp).
• Watchdog: Sistema de auto-curación que reinicia hilos muertos automáticamente.

🛡️ Gestión de Riesgo Profesional

• Dynamic Kelly Lite: Ajuste de posición (5% vs 10%) basado en la confianza de la señal ("Diamond Signal").
• Volatility-Adjusted Trailing Stop: Stops dinámicos que se relajan en pumps y se aprietan en rangos.
• Smart Exit: Cierre preventivo ante reversiones fuertes detectadas por el ML.
• Arkham Intelligence: Fusión de datos On-Chain (Alertas de Ballenas) en la decisión de trade.

📊 Visualización Avanzada

• Whale Radar: HUD flotante que visualiza liquidaciones en tiempo real (Burbujas).
• Signal Panel: Log dedicado para trazabilidad de señales vs ejecuciones.

---

🛠️ Instalación

Requisitos

• Python 3.10+
• Cuenta de Binance Futures (Pruebas en Testnet recomendadas)

Configuración del Entorno

1. Clonar el repositorio:

   git clone https://github.com/TU_USUARIO/sniper-bot-pro.git
   cd sniper-bot-pro

2. Crear Entorno Virtual (Recomendado):

   python -m venv venv_ml
   .\venv_ml\Scripts\activate

3. Instalar Dependencias:

   pip install -r requirements_ml.txt

   (Nota: requirements_ml.txt incluye libs pesadas como pandas, xgboost, aiohttp)

4. Configuración:

   • Editar config.py con tus API Keys de Binance y Arkham.

---

🚀 Ejecución

Para iniciar el bot en modo asíncrono (Interfaz + Motor):

.\venv_ml\Scripts\python sniper_bot_async.py

Comandos de Utilidad

• Entrenar Nuevo Modelo ML:

  .\venv_ml\Scripts\python ml_trainer.py

• Ejecutar Suite de Pruebas (QA):

  .\venv_ml\Scripts\python test_suite_v2.py

• Descargar Datos Históricos:

  .\venv_ml\Scripts\python historical_downloader.py

---

📂 Estructura del Proyecto

.
├── sniper_bot_async.py    # ENTRY POINT: Controlador principal y UI
├── trading_core.py        # LÓGICA PURA: Indicadores, FVG, Señales
├── async_data_fetcher.py  # MOTOR DE DATOS: Peticiones HTTP/WS asíncronas
├── crypto_widget.py       # LEGACY: Base de la interfaz gráfica e integración API Binance
├── ml_trainer.py          # ENTRENAMIENTO: Generación de modelos .pkl
├── bubble_radar.py        # VISUALIZACIÓN: Canvas de burbujas de liquidación
└── test_suite_v2.py       # QA: Pruebas unitarias de integridad

---

⚠️ Disclaimer

Este software es para fines educativos y de investigación. El trading de criptomonedas conlleva alto riesgo. El autor no se hace responsable de pérdidas financieras.

---

v2.0.0 (Stable) - QA Passed