Entorno de ejecución nativo de IA para estrategias de Interactive Brokers
Desarrolle en Cursor, Claude Code o cualquier entorno de desarrollo de IA. Despliegue desde GitHub en un entorno de ejecución en la nube gestionado con control MCP de primer nivel, registros y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Bróker
- Interactive Brokers LLC (Interactive Brokers Group, NASDAQ: IBKR)
- Tipo de bróker
- Bróker multiproducto regulado en EE. UU., minorista e institucional
- Clase de activo
- Acciones estadounidenses e internacionales, opciones, futuros, FX, bonos, ETFs, fondos mutuos, criptomonedas, CFDs (fuera de EE. UU.)
- Cobertura de activos
- Acciones de EE. UU. (NYSE, NASDAQ, NYSE ARCA, BATS, IEX) y acciones internacionales en más de 150 mercados de 33 países. Opciones de EE. UU. (acciones e índices liquidados por OCC) y opciones sobre futuros. Futuros y FOPs en CME Group, ICE, Eurex, HKEX, OSE, SGX y otros. FX spot (más de 100 pares, red IDEAL FX). Bonos: bonos del Tesoro de EE. UU., municipales de EE. UU., corporativos de EE. UU., gubernamentales y corporativos internacionales. ETFs y fondos mutuos. Negociación de criptomonedas (clientes de EE. UU.) en una plataforma asociada; clientes de fuera de EE. UU. a través de entidades independientes de IBKR. CFDs y warrants en entidades fuera de EE. UU. Productos estructurados.
- Modelo de runtime
- Entorno de ejecución de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones comunes
- TWS API (Python oficial de ibapi, ib_insync, ib_async), Client Portal API (REST + OAuth2), Web API, FIX (institucional), NautilusTrader, Backtrader, conectores personalizados
- Integración del flujo de trabajo de IA
- Superficie de control MCP para Cursor, Claude Code, GitHub Copilot y agentes de CLI
- Rol de TradingHost
- Entorno de ejecución, despliegue, registros, comprobaciones de estado, selección de región, control MCP
- Rol de Interactive Brokers
- Cuenta de bróker, acceso a la API, datos de mercado, centro de ejecución, custodia, liquidación, informes fiscales, gestión de márgenes
- Reguladores
- Interactive Brokers LLC: broker-dealer registrado en la SEC y FINRA (CRD 36418), Futures Commission Merchant y Forex Dealer Member registrado en la CFTC/NFA (NFA ID 0258600). Miembro de SIPC con exceso de seguro a través de Lloyds. Las entidades del grupo están reguladas adicionalmente por la FCA (Reino Unido), CIRO (Canadá), ASIC (Australia), SFC (Hong Kong), MAS (Singapur), CBI (Irlanda) y otros.
- Minoristas de EE. UU.
- Sí. Cuenta de paper trading incluida.
- Afiliación
- TradingHost es independiente y no está afiliado a Interactive Brokers LLC ni a Interactive Brokers Group, Inc.
Sección 02 · Qué ofrece IBKR
Qué ofrece Interactive Brokers
Interactive Brokers expone tres interfaces de API distintas (TWS API, Client Portal API, Web API) además de FIX institucional. Las mismas credenciales de cuenta permiten acceder a acciones estadounidenses e internacionales, opciones, futuros, FX, bonos, ETFs, fondos mutuos, criptomonedas y CFDs en entidades fuera de EE. UU. Las tres interfaces de API tienen capacidades sustancialmente diferentes; la elección forma parte del diseño de la estrategia.
Mercados y patrones de estrategia
- Carteras multiactivo de acciones, opciones y futuros
- Estrategias de acciones internacionales en más de 150 mercados a través de Smart Routing
- Automatización de futuros y opciones sobre futuros de CME, ICE y Eurex
- Estrategias de FX spot en más de 100 pares con IDEAL FX
- Estrategias de opciones de EE. UU. basadas en superficie de volatilidad y griegas
- Flujos de trabajo de margen de cartera y margen cruzado de activos
- Cuenta de paper trading para pruebas paralelas sin riesgo
Superficie de la API
- Superficies de productos
- Tres interfaces de API distintas de Interactive Brokers: TWS API (protocolo de socket, requiere un proceso local de Trader Workstation o IB Gateway en ejecución), Client Portal API (REST + WebSocket, autenticado mediante OAuth 2.0) y Web API (interfaz REST más reciente). Se ofrece FIX para clientes institucionales. Cada interfaz tiene capacidades sustancialmente diferentes; elija según la estrategia.
- Métodos de conexión
- TWS API utiliza sockets TCP hacia una instancia en ejecución de TWS o IB Gateway en los puertos 7496/7497 (real/paper) para TWS o 4001/4002 (real/paper) para IB Gateway. Client Portal API es HTTPS REST más WebSocket en api.ibkr.com. Web API es HTTPS REST. Wrappers: ibapi oficial (Python), ib_insync de la comunidad y la bifurcación ib_async que continúa con el mantenimiento.
- Autenticación
- TWS API: la estrategia se conecta a una pasarela local en ejecución que ha sido autenticada de forma interactiva por el titular de la cuenta. Client Portal API: OAuth 2.0 con clave de consumidor y tokens de actualización. Web API: tokens REST. El paper trading utiliza credenciales independientes y un número de cuenta diferente al de la cuenta real.
Para detalles específicos, consulte Interactive Brokers
Los endpoints específicos, límites de frecuencia, mínimos de cuenta, niveles de aprobación de opciones, suscripciones de datos de mercado y esquemas de comisiones por mercado se encuentran en la documentación de Interactive Brokers. Considérela como la fuente de información oficial.
- interactivebrokers.com/productsCobertura de productos y mercados
- ibkrcampus.com/ibkr-api-pagePortal de la API de IBKR
- interactivebrokers.github.io/tws-apiRepositorio oficial de TWS API
- brokercheck.finra.org/firm-summary/36418FINRA BrokerCheck para Interactive Brokers LLC
- nfa.futures.org BASIC (NFA ID 0258600)Registro CFTC/NFA
Sección 03 · Desarrollo con IA
Construya su estrategia de IBKR con IA
Elija un método de integración (TWS API para obtener la máxima capacidad, Client Portal API para un despliegue exclusivo en la nube sin pasarela local), haga un fork de una plantilla de inicio y desarrolle su estrategia en un entorno de desarrollo de IA. Cursor, Claude Code, GitHub Copilot y los agentes de IA basados en CLI funcionan con el mismo flujo de despliegue nativo de GitHub.
TWS API (socket)
La API principal de IBKR. Ofrece el mayor conjunto de capacidades, pero requiere un proceso local en ejecución de TWS o IB Gateway al que se conecta la estrategia. Utilice ibapi (oficial) o ib_async (bifurcación asyncio comunitaria de ib_insync) para Python.
Client Portal API (REST)
Interfaz REST más WebSocket autenticada mediante OAuth 2.0. Menor capacidad que TWS API, pero no requiere una pasarela local, lo que facilita los despliegues exclusivos en la nube.
Web API (REST)
Interfaz REST más reciente de IBKR. Actualmente ofrece un subconjunto de capacidades en comparación con TWS API y Client Portal; la cobertura se está ampliando.
Framework o conector personalizado
NautilusTrader, Backtrader, QuantConnect y los motores propios envuelven la interfaz de TWS API. Elija según el framework que ya utilice.
Soporte de bibliotecas y frameworks para productos de IBKR
ibapi e ib_async cubren toda la interfaz de TWS API, que es el conjunto de capacidades más amplio de IBKR. Client Portal API prescinde de algunos tipos de órdenes avanzadas a cambio de una arquitectura REST + OAuth2 ideal para la nube. Los adaptadores de frameworks (NautilusTrader, Backtrader) envuelven una de las interfaces subyacentes; sus capacidades se heredan de la interfaz que envuelven.
✓ soporte confirmado según la documentación de la librería o del adaptador. «parcial» indica una cobertura parcial; verifíquela con la documentación actual de la integración antes de utilizarla.
TradingHost no impone ninguna biblioteca. Ejecuta tu proyecto.
Desarrollo con IA
Los clientes REST de ibapi, ib_async y Client Portal API funcionan con IDE de IA. La superficie de control de MCP de TradingHost cierra el círculo: las herramientas de IA pueden inspeccionar despliegues, revisar registros y gestionar el entorno de ejecución junto a ti, sin intervenir nunca en la ruta de ejecución de operaciones.
Sección 04 · Ejecución en TradingHost
Ejecuta tu código en TradingHost
Interactive Brokers proporciona la cuenta de bróker, el acceso a la API y el centro de ejecución. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a IBKR.
En lugar de ejecutar el código de tu estrategia en un ordenador portátil, un equipo de escritorio, un VPS genérico o un servidor configurado manualmente, realizas el despliegue desde GitHub en un entorno de ejecución de contenedores gestionado por TradingHost.
Tú
- Tu repositorio contiene tu código.
- Tu despliegue define cómo se ejecuta.
- Tu estrategia se conecta a Interactive Brokers.
TradingHost
- Mantiene el entorno de ejecución en línea.
- Expone los registros y las comprobaciones de estado.
- Selección de región.
- Superficie de despliegue controlada.
Flujo de despliegue
- PASO 01
Conecta GitHub
Autoriza a TradingHost para acceder a tu cuenta de GitHub.
- PASO 02
Vincula un repositorio o comienza con una plantilla
Apunta TradingHost a tu repositorio de estrategia de IBKR existente, o haz un fork de una plantilla de inicio de ibapi o ib_async para tener una base funcional.
- PASO 03
Despliega en un contenedor de TradingHost
Elija una región (US-East es la más cercana a los motores de emparejamiento de acciones de EE. UU. y futuros de CME; EU es la opción natural para estrategias de la sesión europea y futuros de Eurex), proporcione sus credenciales de IBKR y la configuración de gateway como variables de entorno, y despliegue. TradingHost compila su contenedor desde el repositorio y ejecuta su estrategia en una infraestructura gestionada de Kubernetes. Las estrategias de TWS API que requieren un proceso local de IB Gateway pueden ejecutar dicho gateway como un sidecar; las estrategias de Client Portal API y Web API no necesitan un gateway.
- PASO 04
Monitorea los registros y el estado
Visualiza registros en tiempo real, el estado de salud y el estado del entorno de ejecución desde el panel de TradingHost. Se puede acceder a esta misma interfaz mediante MCP desde cualquier AI IDE, lo que permite a Cursor, Claude Code o a un agente de CLI leer el estado del despliegue y gestionar el entorno de ejecución junto a ti. La ejecución de las operaciones permanece en la ruta del código de la estrategia, no en MCP.
- PASO 05
Actualiza y vuelve a desplegar
Sube los cambios a tu rama principal de GitHub y TradingHost los desplegará automáticamente. Un despliegue vinculado a una cuenta de simulación (paper account) es el entorno de prueba ideal antes de pasar a las claves de producción (live).
Sección 05 · Notas operativas
Notas operativas para Interactive Brokers
Problemas con los que te toparás al ejecutar una estrategia de Interactive Brokers en un entorno de ejecución en la nube con contenedores, que no siempre aparecen en la documentación de IBKR ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de Interactive Brokers o de una fuente reguladora principal; la guía sobre el despliegue proviene de la ejecución de estas estrategias en TradingHost.
01 · Tres superficies de API
TWS API, Client Portal API y Web API no son intercambiables
Interactive Brokers expone tres superficies de programación distintas. TWS API es un protocolo de sockets utilizado por ibapi e ib_async; requiere un proceso activo de TWS o IB Gateway al que se conecte la estrategia. Client Portal API es REST más WebSocket con OAuth 2.0; no necesita un gateway local. Web API es una superficie REST más nueva con una cobertura más limitada actualmente. Elige la superficie durante el diseño de la estrategia; cambiar a mitad del despliegue implica reescribir el código, no solo cambiar un parámetro.
02 · Gateway local de TWS
TWS API requiere un proceso local de TWS o IB Gateway al que se conecte la estrategia
TWS API es un protocolo de sockets que se conecta a una instancia de TWS (Trader Workstation) o IB Gateway que se ejecute localmente en el puerto 7496 o 7497 para TWS, o 4001 o 4002 para IB Gateway (producción y simulación respectivamente). Para despliegues exclusivos en la nube, ejecuta IB Gateway como un contenedor sidecar junto a la estrategia, o bien utiliza Client Portal API. El gateway "local" puede residir en el mismo contenedor de TradingHost o en uno adyacente dentro del mismo pod de Kubernetes.
FuenteIB Gateway documentation03 · Cuenta de simulación
El paper trading utiliza un número de cuenta independiente con credenciales independientes
El paper trading en Interactive Brokers se proporciona mediante un número de cuenta independiente en lugar de una URL de entorno distinta. El usuario inicia sesión en TWS o IB Gateway con credenciales de simulación (paper) y el gateway se conecta al servicio de simulación. El código de la estrategia no cambia entre simulación y producción, pero la configuración del gateway y la conexión de la API (puerto e ID de cuenta) sí lo hacen. Mantén las credenciales de simulación y producción en entradas independientes de Secrets en TradingHost.
04 · Pattern Day Trader
La regla PDT se aplica a cuentas de margen con menos de $25,000 según la FINRA Rule 4210
La FINRA Rule 4210 califica una cuenta de margen como Pattern Day Trader tras realizar cuatro o más operaciones intradiarias (day trades) en un plazo de cinco días hábiles, y restringe las operaciones intradiarias adicionales hasta que el patrimonio alcance los $25,000. Interactive Brokers aplica esta regla en las cuentas de margen. Las cuentas de efectivo (cash accounts) no están sujetas a la regla PDT, pero sí a las restricciones del ciclo de liquidación (T+1 para acciones de EE. UU. desde el 2024-05-28). Planifica tu despliegue teniendo en cuenta esta restricción.
05 · Aprobación de opciones
La aprobación de opciones es por cuenta e independiente de la aprobación de acciones
La negociación de opciones en IBKR requiere un paso de aprobación independiente más allá de la apertura de la cuenta de corretaje. El nivel aprobado controla qué estrategias de opciones acepta el bróker: desde opciones de compra cubiertas (covered calls) y opciones de venta garantizadas con efectivo (cash-secured puts) en el nivel más bajo, hasta opciones cortas descubiertas (uncovered short options) en el más alto. Las órdenes que superen el nivel aprobado se rechazan en el bróker, no en TradingHost. Planifica tus estrategias según tu nivel aprobado o solicita un aumento de nivel en IBKR antes de realizar el despliegue.
06 · Datos de mercado
Las suscripciones a datos de mercado son por mercado y no se incluyen en paquetes por defecto
Interactive Brokers cobra las suscripciones a datos de mercado por mercado (profundidad de NASDAQ de EE. UU., NYSE OpenBook, opciones de OPRA de EE. UU., futuros de CME, profundidad de LSE, etc.). Una estrategia que consulte datos de mercado no suscritos recibirá cotizaciones diferidas o respuestas vacías. Configura las suscripciones de datos en el portal de usuario antes de desplegar una estrategia que dependa de datos en tiempo real de un mercado específico.
07 · SmartRouting
SmartRouting es la opción por defecto; el enrutamiento directo se define por orden
Interactive Brokers enruta las órdenes a través de SmartRouting por defecto, lo que selecciona el centro de ejecución con el mejor precio mostrado neto de comisiones. Para utilizar el enrutamiento directo, especifica un parámetro de mercado (exchange) en la orden. SmartRouting afecta a las ejecuciones (fills), la latencia y los reembolsos de tarifas de mercado; las estrategias que dependan de la interacción con un centro de ejecución específico deben optar por el enrutamiento directo.
Sección 06 · Diseñado para
Diseñado para
Los entornos de ejecución de TradingHost para Interactive Brokers son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Traders sistemáticos multiactivos
- Operadores de estrategias de opciones y futuros
- Desarrolladores cuantitativos (quants) que pasan de notebooks a producción
- Creadores de estrategias de acciones internacionales y FX
Conectar GitHub y crear tu primera estrategia es gratis.
Sección 08 · Preguntas frecuentes
Preguntas frecuentes
No. TradingHost es independiente y no está afiliado a Interactive Brokers LLC ni a Interactive Brokers Group, Inc.
No. TradingHost es un entorno de ejecución para código de estrategias de trading. Interactive Brokers LLC es el bróker-dealer, registrado ante la SEC y la FINRA (CRD 36418), la CFTC y la NFA (NFA ID 0258600), y miembro de la SIPC con un exceso de seguro a través de Lloyds. Tu cuenta, custodia, acceso al mercado, liquidación, margen e informes fiscales corresponden en su totalidad a Interactive Brokers.
No. El código de tu estrategia se conecta a Interactive Brokers y envía instrucciones de órdenes según tu propia lógica, los permisos de tu cuenta y el método de integración. TradingHost proporciona el entorno de ejecución donde se ejecuta dicho código.
No. El acceso a la API de IBKR lo proporciona Interactive Brokers. Tú eres responsable de tu cuenta de IBKR, los permisos de la API, las credenciales y el cumplimiento de los términos de IBKR.
TWS API (a través de ibapi o ib_async) tiene la superficie de capacidades más amplia, pero requiere un proceso de TWS o IB Gateway ejecutándose localmente. Client Portal API es REST más OAuth 2.0 y no necesita un gateway local, por lo que resulta más sencilla para despliegues exclusivos en la nube. Si tu estrategia necesita tipos de órdenes avanzados, griegas de opciones en tiempo real o características que solo expone el protocolo de sockets de TWS, utiliza TWS API y ejecuta IB Gateway como un sidecar. Si REST es suficiente, es preferible optar por Client Portal API debido a que su estructura de despliegue es más sencilla.
Sí, si eliges TWS API. IB Gateway es una pequeña aplicación Java que se autentica contra IBKR y expone un socket local al que se conecta la estrategia. En TradingHost, ejecutas IB Gateway como un proceso sidecar en el mismo pod de Kubernetes que la estrategia, o bien puedes usar Client Portal API, lo que elimina la dependencia del gateway.
Sí, sujeto a la aprobación de opciones de IBKR. La aprobación de opciones es por cuenta e independiente de la aprobación de acciones; el nivel controla qué estrategias acepta el bróker. TradingHost no elude la aprobación de opciones.
Sí, sujeto a la aprobación de la cuenta de futuros de IBKR. La negociación de futuros requiere un paso de aprobación independiente más allá de la apertura de la cuenta de corretaje debido a los requisitos de la CFTC y la NFA.
ibapi es el wrapper oficial de Python de Interactive Brokers y refleja directamente el protocolo de sockets. ib_insync era un wrapper de la comunidad compatible con asyncio; su autor original lo marcó como no mantenido activamente. ib_async es el fork de la comunidad de ib_insync que continúa publicando actualizaciones. Para nuevas estrategias, utiliza ibapi o ib_async; para código existente de ib_insync, planifica una migración a ib_async, ya que la API es en gran medida compatible.
Conecta tu repositorio de GitHub que contiene el código de la estrategia, vincúlalo a TradingHost y realiza el despliegue. Utiliza un despliegue vinculado a una cuenta de simulación (paper trading) como entorno de prueba y pasa a claves reales una vez que la estrategia sea estable. Vincular GitHub y crear una estrategia es gratis; los planes de tiempo de ejecución (runtime) se detallan en la página de precios.
En tu flujo de trabajo de secretos controlado por GitHub. TradingHost las lee en tiempo de ejecución a través de secretos de repositorio de GitHub, secretos de entorno o tu propio proceso aprobado de gestión de secretos. TradingHost no necesita la custodia de tu usuario, contraseña de IBKR ni de los tokens OAuth de Client Portal. Consulta la sección de secretos de la plataforma para conocer el modelo de gestión completo.
No. Las estrategias nunca deberían necesitar permisos de retiro o movimiento de fondos. Las credenciales solo requieren los permisos (scopes) necesarios para la colocación de órdenes y el acceso a datos de mercado.
Sí. TradingHost admite el control basado en MCP para IDE de IA, incluidos Cursor, Claude Code, GitHub Copilot y agentes de IA basados en CLI. Las herramientas de IA pueden inspeccionar despliegues, revisar registros (logs), reiniciar estrategias y gestionar flujos de trabajo de ejecución. MCP es una superficie de control y observabilidad, no la ruta de ejecución de operaciones. Consulta la superficie de control de MCP para obtener más detalles.
No. La regla PDT (FINRA Rule 4210) la aplica Interactive Brokers, no TradingHost. Las cuentas de margen con menos de $25,000 están sujetas a las restricciones de PDT para el trading intradiario. Tu estrategia debe respetar el indicador (flag) de PDT del bróker en la cuenta.
No. Tus formularios 1099 los emite Interactive Brokers al final del año, no TradingHost. TradingHost proporciona el entorno de ejecución; IBKR se encarga de los informes fiscales del bróker.
No. La SIPC cubre tu cuenta de corretaje de IBKR hasta $500,000 (incluidos $250,000 en efectivo) bajo la protección para miembros de la SIPC, con un seguro adicional por exceso ofrecido por IBKR a través de Lloyds. El entorno de ejecución de TradingHost no está asegurado por la SIPC porque TradingHost no es un bróker.
TradingHost se ejecuta en las regiones EU y US-East. US-East es la más cercana a los motores de emparejamiento de acciones de EE. UU. y futuros de CME, lo que la convierte en la opción natural para la mayoría de las estrategias de IBKR en EE. UU. La región EU es ideal para estrategias de la sesión europea y futuros de Eurex. Consulte la página de regiones para ver los detalles de enrutamiento y proximidad.
No. TradingHost se enfoca en el despliegue y el entorno de ejecución en producción. El backtesting corresponde a tu entorno de investigación, framework o AlgoBuilder.