Binance Trade Bot es una herramienta de código abierto para la automatización de operaciones en el mercado de criptomonedas. Permite la monitorización continua del mercado y la ejecución automática de órdenes basadas en estrategias predefinidas, operando sin necesidad de intervención humana las 24 horas del día.

Valor fundamental y arquitectura del sistema

Este sistema destaca por su capacidad para ejecutar operaciones de forma autónoma, procesar datos del mercado en tiempo real y ofrecer flexibilidad en la definición de estrategias de trading. La arquitectura del software se compone de módulos especializados que interactúan de manera coordinada:

• Motor de Ejecución (ExecutorCore): Componente central que orquesta el ciclo de trading: sondea el mercado, aplica la lógica de la estrategia y realiza compras/ventas.
• Gestor de Conexión (ConnectorHandler): Administra toda la comunicación con la API de Binance, incluyendo obtención de precios, gestión de balances y envío de órdenes.
• Lógica de Estrategia (StrategyLogic): Define las reglas de decisión. Implementa algoritmos como el de arbitraje simple o el de seguimiento de múltiples activos.
• Sistema de Persistencia y Registro (DataLogger): Almacena el historial de operaciones y genera logs detallados del funcionamiento del bot.

Puesta en marcha: Proceso de instalación

Para desplegar la herramienta, sigue estos pasos:

1. Preparación del entorno

Clona el repositorio y accede al directorio del proyecto:

git clone https://gitcode.com/gh_mirrors/bi/binance-trade-bot
cd binance-trade-bot

2. Instalación de dependencias

pip install -r requirements.txt

3. Configuración de credenciales

Crea y edita el archivo de configuración:

cp config/apprise_example.yml config/apprise.yml

Introduce tus credenciales en config/apprise.yml:

binance:
  api_key: TU_CLAVE_API
  api_secret: TU_SECRETO_API

Recomendación de seguridad: Conifgura los permisos de la API para permitir únicamente operaciones de trading, deshabilitando extracciones de fondos.

4. Ejecución del bot

python -m binance_trade_bot

Verifica el arranque exitoso mediante los mensajes en la consola, que confirmarán la conexión a la API y el inicio del sondeo del mercado.

Mecanismos internos y personalización

Configuración esencial

El comportamiento del bot se controla mediante parámetros clave en el archivo de configuración:

• bridge: Moneda base para convertir entre pares de criptomonedas (ej. USDT).
• interval: Frecuencia del sondeo del mercado en minutos.
• quote_currency: Criptomoneda de referencia para la estrategia.
• trade_threshold: Umbral porcentual que desencadena una operación.

Estrategias disponibles y extensilbes

El bot incluye estrategias predeterminadas como la de arbitraje básico. Para implementar lógica personalizada, se puede crear una nueva clase en el directorio de estrategias y redefinir el método de sondeo (scout).

Solución de problemas comunes

• Fallo de conexión API: Verifica la corrección de las claves, el estado de la red y que los permisos de la API sean los adecuados.
• Órdenes no ejecutadas: Asegúrate de que el balance disponible sea suficiente, el par de trading sea soportado y se cumplan los montos mínimos de operación.
• Inactividad de la estrategia: Revisa los valores del umbral de trading y las condiciones de mercado. Analiza los logs para errores específicos.

Funcionalidades avanzadas

Para un control y análisis más profundo, el pryoecto ofrece herramientas adicionales:

• Backtesting: Evalúa el rendimiento de una estrategia usando datos históricos con el script backtest.py.
• Servidor API: Expone endpoints HTTP para monitorizar y gestionar el bot de forma remota.
• Integración con visualización: Los datos y logs pueden exportarse a plataformas como Grafana para crear dashboards de rendimiento.