Skip to content

Repository files navigation

GridBot Pro

Bot automatizado de trading en grid para Binance con panel web en tiempo real.

Descripción

GridBot Pro es un sistema de automatización de trading que ejecuta estrategias de grid trading en Binance. Coloca órdenes de compra y venta en varios niveles de precio para capturar volatilidad del mercado de criptomonedas.

Tecnología

Backend

  • Python 3.13+
  • FastAPI (servidor web asincrónico)
  • SQLite3 (base de datos)
  • CCXT (integración con Binance)

Frontend

  • HTML5 / CSS3 / JavaScript
  • Bootstrap 5.3
  • Gráficas con Lightweight Charts
  • Tema claro

Captura del dashboard

Dashboard

Instalación

Requisitos

  • Python 3.13+
  • Cuenta en Binance

Pasos

  1. Clonar proyecto
git clone https://github.com/catlinux/gridbot-pro.git
cd gridbot-pro
  1. Crear entorno virtual
python -m venv .venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # Linux/Mac
  1. Instalar dependencias
pip install -r requirements.txt
  1. Configurar credenciales
cp config/env.example .env
# Editar .env con claves API de Binance
  1. Ejecutar
# Desarrollo (con auto-recarga)
python scripts/watcher_restart.py

# Producción
python main.py

Acceder a: http://localhost:8000

Estructura

gridbot-pro/
├── core/              # Lógica de trading
├── web/               # Dashboard web
├── config/            # Configuración
├── scripts/           # Utilidades
├── utils/             # Funciones auxiliares
└── data/              # Base de datos

Características

  • Automatización 24/7
  • Grid trading inteligente
  • Panel web en tiempo real
  • Historial de operaciones
  • Copia de seguridad de datos
  • Backtesting para calcular operaciones

Seguridad

⚠️ Importante:

  • Nunca commit .env con claves reales
  • Usar testnet primero
  • Rescindir permisos API después de usar
  • Hacer 2FA en Binance

TODO - Funciones por Activar

Las siguientes funcionalidades se están preparando. Se irán activando progresivamente:

  • Creación Dashboard - Página inicial del proyecto
  • Connexión exchange - Conexión a Binance mediante API's
  • Gestión usuario - Apartado de usuario
  • Multi conexión - Soporte para varios exchanges
  • Gestión API's - Reforzar seguridad API's y passwords
  • Testnet - Conexión a Testnet para pruebas
  • ⏹️ Backtesting - Cálculo de estrategias por histórico de gráficos
  • ⏹️ Creación de los grids - Formulario para colocar las estrategias
  • ⏹️ Importación estrategias - Pon a trabajar directamente las mejores estrategias creadas en backtesting
  • ⏹️ Trailing up - Si el precio sube y sobrepasa tu grid, desplaza automáticamente las órdenes para no quedar fuera de mercado
  • ⏹️ Trailing Stop Loss - Activación y optimización
  • ⏹️ Take Profit dinámico - Cálculo inteligente de objetivos
  • ⏹️ Análisis técnico avanzado - Indicadores adicionales
  • ⏹️ Multi-grid simultáneo - Operar varios pares al mismo tiempo
  • ⏹️ Estrategias predefinidas - Plantillas listas para usar
  • Alertas por Telegram - Notificaciones en tiempo real
  • ⏹️ Exportación de reportes - Generación de PDF con estadísticas
  • ⏹️ Exportación a xls - Crea archivos xls para leer en excel o similar.

Estado de Calidad (Tests & Lint) ✅

Fecha (última ejecución): 2026-01-07

  • Ruff (lint): ✅ All checks passed (sin errores)
    • Comando: .venv\Scripts\ruff.exe check --show-fixes .
  • Pytest (warnings → errores): ✅ Todos los tests pasan — 7 passed
    • Comando: .venv\Scripts\python.exe -W error -m pytest -q

Nota: Se revisaron y añadieron logs en los bloques except que antes silencian errores para facilitar el diagnóstico en producción.

Ayudar al Proyecto

Este proyecto es Open Source y requiere muchas horas de desarrollo y mantenimiento. Si la herramienta te ha sido útil, te ha ayudado a aprender o te ha generado beneficios, considera hacer una pequeña donación. ¡Ayuda a mantener el código actualizado y a añadir nuevas funcionalidades!

Puedes enviar tu apoyo a las siguientes direcciones (Redes baratas y rápidas):

  • Polygon (MATIC): 0x5dD9a7b2D831A319a68214C11015f64Dbc6bb79c

  • Solana (SOL): GbAFM55PyBb2otqUb1oTTtqzE39fwE6XS7HVsCCwX5Tw

NOTA: No se requiere TAG ni MEMO para estas direcciones. Si tu exchange te obliga a poner uno para realizar el envío, simplemente escribe 0. (Asegúrate de seleccionar la red correcta).

¡Muchas gracias por tu colaboración!

Aviso Legal

Este software es experimental. El trading de criptomonedas conlleva riesgo de pérdida total. Use bajo su responsabilidad. Pruebe en testnet antes de operar con capital real.

About

GridBot Pro es un bot automatizado de trading que ejecuta estrategias de grid trading, colocando órdenes en múltiples niveles de precio para capturar volatilidad del mercado. Incluye un panel web en tiempo real para monitorear posiciones y operaciones. Desarrollado en Python con FastAPI, SQLite y JavaScript vanilla para máxima eficiencia.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages