Bot de Trading Automatizado para IQ Option

Este bot permite ejecutar operaciones automáticas en IQ Option basadas en señales predefinidas. Utiliza la API no oficial de IQ Option mantenida por victalejo.

⚠️ Descargo de Responsabilidad

Este bot es solo para fines educativos y de prueba. El trading conlleva riesgos significativos y puede resultar en la pérdida de capital. Use este software bajo su propio riesgo.

🚀 Características

• Ejecución automática de operaciones basada en señales
• Soporte para múltiples pares de trading
• Control de tiempo preciso para las entradas
• Modo práctica incluido
• Sistema de reconexión automática
• Seguimiento de resultados de operaciones

📋 Requisitos Previos

• Python 3.7 o superior
• Cuenta en IQ Option (real o práctica)
• Pip (gestor de paquetes de Python)

🔧 Instalación

1. Clonar el repositorio:

git clone https://github.com/tu-usuario/tu-repositorio.git
cd tu-repositorio

2. Instalar dependencias:

pip install -r requirements.txt

⚙️ Configuración

1. Copiar la plantilla de credenciales:

cp .env.example .env

2. Editar .env con tus credenciales reales:

IQ_EMAIL=tu_email@ejemplo.com
IQ_PASSWORD=tu_password

⚠️ .env está en .gitignore — nunca lo subas al repositorio.

3. Crear/editar sinais.txt con el formato:

DD/MM/YYYY,HH:MM:SS,PAR,TIMEFRAME,DIRECCION,STAKE

Ejemplo:

01/01/2026,22:15:00,EURUSD-OTC,5,CALL,5.00
01/01/2026,22:20:00,EURUSD-OTC,5,PUT,5.00

Formato de Señales:

• DD/MM/YYYY: Fecha de la operación
• HH:MM:SS: Hora exacta de entrada
• PAR: Par de trading (ej: EURUSD-OTC)
• TIMEFRAME: Duración en minutos (entero positivo)
• DIRECCION: CALL o PUT
• STAKE: Cantidad a invertir (float positivo)

El bot valida TODAS las señales al inicio y aborta si encuentra errores de formato o señales con fecha pasada — fix everything at once.

🧪 Tests

pytest tests/ -v

🚀 Uso

1. Ejecutar el bot:

python bot.py

2. El bot:
   • Conectará con IQ Option
   • Cargará las señales del archivo
   • Esperará el momento exacto para cada operación
   • Mostrará resultados en tiempo real

📊 Estructura del Proyecto

├── bot.py              # Script principal
├── .env                # Configuración de credenciales (crear desde .env.example)
├── sinais.txt          # Archivo de señales
└── README.md           # Este archivo

🔍 Características de la API victalejo/iqoptionapi

Esta versión de la API ofrece varias mejoras sobre otras versiones:

• Mayor estabilidad en las conexiones
• Mejor manejo de errores
• Compatibilidad mejorada con versiones recientes de Python
• Funciones adicionales para el trading
• Mantenimiento activo

📝 Notas Importantes

1. Modo Práctica: Por defecto, el bot opera en cuenta práctica. Para cambiar a cuenta real, modificar:

API.change_balance('PRACTICE')  # Cambiar a 'REAL' para cuenta real

2. Timeframes: Los timeframes disponibles dependen del tipo de cuenta y activo.

3. Reconnexión: El bot intentará reconectarse automáticamente si pierde la conexión.

🐛 Solución de Problemas

1. Error de conexión:

   • Verificar credenciales en .env
   • Comprobar conexión a internet
   • Verificar que la API de IQ Option esté operativa

2. Error en señales:

   • Verificar formato de fecha/hora
   • Comprobar que el par de trading existe
   • Verificar formato del archivo sinais.txt

🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor, abrir un issue primero para discutir los cambios propuestos.

📜 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.