Si buscas la API de IQ Option en Python, la primera verdad honesta es esta: IQ Option no tiene una API pública oficial para la automatización de cuentas minoristas. Todo lo que circula en GitHub — incluida la popular librería pyiqoptionapi (fork mantenido del antiguo iqoptionapi) — es ingeniería inversa del canal WebSocket que usa el sitio. Funciona, pero vive en una zona gris y puede romperse con cualquier actualización del bróker. Esta guía muestra los métodos reales, con ejemplos, y dónde están los riesgos.
¿Quieres automatizar sin pelear con una librería no oficial que se cae cada semana? Mira la alternativa lista:
▶ Ver bot e integración IQ Option en Python¿IQ Option tiene API oficial?
No para el trader común. IQ Option ofrece integraciones vía partnership/afiliados en algunos casos corporativos, pero no publica documentación de API de trading para cuentas individuales. Por eso toda automatización depende de librerías que imitan al navegador, conectándose al endpoint WebSocket wss://iqoption.com/echo/websocket y enviando los mismos comandos que enviaría el sitio.
Instalación de la librería
El fork más activo suele ser pyiqoptionapi. La instalación típica:
Conexión y login
El punto de entrada es la clase principal. El método connect() devuelve una tupla (status, motivo) — verifica siempre el status antes de continuar:
Principales métodos que vas a usar
Estos son los métodos más comunes en el día a día (los nombres pueden variar entre forks — verifica la versión instalada):
connect(), check_connect(), change_balance("PRACTICE"/"REAL"), get_balance(), reset_practice_balance().
get_candles(ativo, intervalo, quantidade, fim), start_candles_stream(), get_realtime_candles(), stop_candles_stream().
buy(valor, ativo, direcao, expiracao) devuelve (check, id); haz el seguimiento con check_win_v4(id) o check_win_digital_v2(id) para opciones digitales.
Ejemplo: leer velas y enviar una orden (en DEMO)
try/except y reconecta con check_connect(). El WebSocket se cae con frecuencia, y un loop sin reconexión simplemente se congela.
Errores comunes (y por qué ocurren)
La mayoría de los problemas no son bugs de tu código, sino cambios del lado del bróker:
La conexión se cae en loops largos → falta de reconexión y keep-alive.
get_candles vacío → activo cerrado en ese horario o nombre de símbolo incorrecto.
La librería deja de funcionar de la nada → IQ Option actualizó el protocolo; espera un fork nuevo.
¿Vale la pena automatizar IQ Option?
Para aprender y probar ideas en demo, sí — es un excelente laboratorio. Para operar dinero real, sopésalo: dependes de código no oficial que puede romperse, y ninguna automatización convierte las opciones binarias (juego de suma negativa por el payout) en ingresos garantizados. Si el objetivo es estabilidad, considera brókers con una API documentada de verdad, como Deriv, o soluciones listas ya probadas.
FAQ
¿La pyiqoptionapi es segura? El código es abierto y auditable, pero le entregas tu correo y contraseña. Usa una contraseña exclusiva y, de preferencia, cuenta demo.
¿Pueden banearme por usarla? Sí. La automatización generalmente infringe los términos de uso. El bróker puede cerrar la cuenta.
¿Funciona con opciones digitales? Sí, hay métodos específicos (buy_digital_spot, check_win_digital_v2), pero cambian más entre versiones.
¿Existe una alternativa más estable? Deriv tiene una API oficial documentada. Para IQ Option, las soluciones listas reducen el trabajo de mantenimiento.
Aviso: las opciones binarias son productos de altísimo riesgo y la mayoría de los traders minoristas pierde dinero. Este contenido es educativo, no constituye recomendación de inversión, y las librerías no oficiales pueden violar los términos del bróker. Prueba siempre en cuenta demo antes de cualquier operación real.
