Conexión e inicio de sesión

Error 502 de TWS: no se puede conectar a la API

Respuesta rápida

El error 502 significa que la aplicación no pudo abrir su conexión con TWS o IB Gateway. Empiece por el programa en ejecución, el host y el puerto. Suele ser un problema de configuración de la conexión, antes de que una orden llegue al bróker.

Orientación educativa sobre software. Operar conlleva riesgos. Lea los avisos financieros y de información.

Paso a paso

  1. 1 Compruebe que TWS haya terminado de iniciar sesión. Una pantalla de inicio de sesión no es una sesión de API lista.
  2. 2 Abra Global Configuration → API → Settings. Confirme que los clientes de socket estén activados y anote el Socket port.
  3. 3 Compare el host de la aplicación con el equipo que ejecuta TWS. Use 127.0.0.1 solo cuando ambas aplicaciones se ejecuten en el mismo equipo.
  4. 4 Haga coincidir el puerto exactamente. TWS paper suele usar 7497; Gateway paper suele usar 4002. Es posible usar puertos personalizados.
  5. 5 Reconecte una vez. Si sigue fallando, revise el registro de conexión de la aplicación y la regla del firewall local para esta conexión específica.

Un ejemplo práctico

Suponga que TWS muestra el puerto 7497 pero la aplicación intenta el 4002. La aplicación está llamando a la puerta equivocada. Cambie el puerto de la aplicación por el valor que leyó en TWS y luego intente conectar una vez. Si la aplicación está en un segundo equipo, revise también el host. El número 127.0.0.1 significa este equipo. No significa el otro equipo donde dejó TWS abierto.

Escenario ilustrativo, no es el registro de una operación realizada durante esta revisión.

Referencia de pantalla

Empiece en Mosaic con File → Global Configuration. Después elija el panel que se nombra en los pasos.

Menú File de TWS Mosaic con Global Configuration y Layout Settings
Abra Global Configuration desde File en Mosaic. Esta captura excluye el encabezado de la cuenta. Captura realizada en modo paper de TWS el 3 de octubre de 2026. Abra la imagen para verla a tamaño completo.
API Settings de TWS con los clientes de socket, el acceso de solo lectura, el puerto y el registro
Busque el control indicado en API → Settings. Los valores mostrados pertenecen a una sesión paper y son ejemplos, no recomendaciones universales. Captura realizada en modo paper de TWS el 3 de octubre de 2026. Abra la imagen para verla a tamaño completo.
Cómo confirmar el resultado La conexión debe avanzar hasta el descubrimiento de la cuenta. Si el mismo error 502 continúa, envíe al soporte el host, el puerto, los nombres de las aplicaciones y la hora del intento.

Error que debe evitar

Cambiar repetidamente los permisos de órdenes no arreglará un socket que no puede abrirse. Es posible que el error 502 no aparezca en los registros de TWS porque lo informa el sistema operativo.

Preguntas frecuentes

¿El error 502 es un rechazo de orden?

No. Se refiere a la conexión, antes del procesamiento normal de órdenes.

¿Debo desactivar mi firewall?

Use una regla específica para la conexión necesaria. No desactive todo el firewall.

Avisos financieros y de información

Aviso financiero

Estas guías explican software. Son educativas y no constituyen asesoramiento financiero, de inversión, fiscal ni jurídico. Ningún ejemplo es una sugerencia para comprar o vender un producto ni para usar una estrategia de trading. Operar puede hacer perder dinero, incluidos todos los fondos que se pongan en riesgo. Con margen, futuros, ventas en corto o algunas opciones, las pérdidas pueden superar los fondos iniciales. La automatización puede fallar, enviar órdenes duplicadas o actuar tarde. Los stops no garantizan una ejecución ni un precio. Revise sus órdenes y posiciones, y consulte a un profesional cualificado según sus propias necesidades. Las operaciones en simulado, los ejemplos y los resultados pasados no predicen resultados reales ni prometen un beneficio.

Aviso de información

Esta es una ayuda general basada en las fuentes y la fecha de revisión que se muestran en la página. Las pantallas, los ajustes, las comisiones, el acceso a datos y el soporte de los productos pueden cambiar o variar según la versión de la aplicación, la cuenta, el país y el bróker. El contenido puede contener errores o quedar desactualizado; no se garantiza su exactitud, integridad ni la continuidad del servicio. Consulte las instrucciones vigentes del bróker y de la aplicación antes de actuar. Las capturas de pantalla muestran dónde están los controles; no prueban que una prueba de orden haya sido correcta. Esta guía no sustituye los términos del bróker ni los avisos de riesgo. Las referencias a IBKR y TradingView identifican sus productos y no implican que respalden esta guía.

Divulgaciones de riesgo de IBKR · Límites del paper trading de IBKR · Orientación de la SEC sobre herramientas de inversión automatizadas

Ayuda de PickMyTrade · Orientación independiente para Trader Workstation y la integración de escritorio. Las imágenes de TWS muestran operativa en simulado. Otras aplicaciones se nombran en los pies de imagen. Los ajustes y la disponibilidad pueden variar según la versión y la cuenta.

Automatice las alertas de TradingView hacia Interactive Brokers

Ver la integración con IBKR