Error 321 de TWS: falló la validación de la solicitud

Respuesta rápida

El error 321 significa que una solicitud no superó la validación. Lea el texto que lo acompaña para encontrar el campo implicado. Revise la solicitud realmente enviada en lugar de adivinar solo por el número.

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

Paso a paso

1 Guarde primero el mensaje completo de la aplicación. Para revisar un registro de la API de TWS ya guardado, abra Help → Troubleshooting → Diagnostics → API Logs. Seleccione su fecha y elija View Logs. Si la lista está vacía, active el registro de la API antes del próximo evento.
2 Copie el mensaje completo y el ID de la solicitud o de la orden desde el registro de la aplicación.
3 Identifique si la solicitud se refiere a una orden, a un contrato o a una consulta de datos.
4 Compare el campo indicado con el producto de TWS o el ticket de orden correspondiente.
5 Corrija solo el campo o la combinación que describe el mensaje. Si la aplicación la generó internamente, entregue al soporte la solicitud con los datos sensibles eliminados.
6 Pruebe la solicitud corregida en un flujo paper controlado y revise la siguiente respuesta.

Un ejemplo práctico

Suponga que una solicitud de datos omite un campo de fecha y el error nombra ese campo. Es una pista sobre la solicitud, no una prueba de que la red esté mal. Conserve el texto completo y el ID de la solicitud juntos. Una orden enviada al mismo tiempo puede tener su propio ID y un resultado distinto. Relacione el mensaje con la acción antes de intentar corregirlo.

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

Referencia de pantalla

Cuadro de diálogo View Logs de TWS con los botones View Logs, Export Logs y Export Today Logs — Esta sesión no tiene registros de la API en la lista, por lo que los botones de exportación están desactivados. Active el registro de la API antes del evento que necesita capturar. No se exportó ni se subió ningún registro para esta captura de pantalla. Captura realizada en modo paper de TWS el 3 de octubre de 2026. Abra la imagen para verla a tamaño completo.

Market Data Connections de TWS con el propósito y el estado de cada farm, y las columnas de clientes de la API — Los servicios observados están conectados y la lista de clientes de la API está vacía. Use este panel para leer el estado actual; no reproduce una desconexión ni demuestra que se completó el handshake de una aplicación. Captura realizada en modo paper de TWS el 3 de octubre de 2026. Abra la imagen para verla a tamaño completo.

Description de una acción en TWS con la ruta SMART, el mercado principal NASDAQ, la divisa, el ID de contrato, el tick mínimo y el estado de datos congelados — Esta acción es un ejemplo de los campos que debe comparar. SMART routing y Primary Exchange son campos distintos. El feed observado está Frozen y el mercado está cerrado; no es un precio en vivo ni una recomendación de operación. 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 El fallo de validación indicado debe desaparecer sin introducir un producto o una instrucción de orden distintos.

Error que debe evitar

Un error 321 en una solicitud de datos no demuestra que se haya rechazado una orden. Relacione el ID de la solicitud con la acción.

Preguntas frecuentes

¿Puedo corregir el error 321 cambiando el puerto?

Solo un problema de conexión corresponde a la solución de problemas de puerto; una validación significa que la solicitud llegó a la etapa de validación.

¿Qué debo enviar al soporte?

El mensaje completo, el tipo de solicitud, el ID, el contrato y la hora, sin tokens ni contraseñas.

Error 200 de TWS: contrato no encontrado o ambiguo Error 201 de TWS: lea el motivo del rechazo de la orden Error 202 de TWS: ¿por qué se canceló la orden? Ajustes de Messages de TWS y avisos de órdenes Cómo activar los registros de la API de TWS Exporte los registros de TWS para un caso de soporte de IBKR

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.