Runtime nativo de IA para estrategias de Alpaca
Desarrolla en Cursor, Claude Code o cualquier IDE de IA. Despliega desde GitHub en un runtime en la nube gestionado con control MCP nativo, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Bróker
- Alpaca Securities LLC
- Tipo de bróker
- Bróker minorista regulado en EE. UU., API-first
- Clase de activo
- Acciones de EE. UU., opciones de EE. UU., cripto
- Cobertura de activos
- Acciones de EE. UU. (cotizaciones en NYSE, NASDAQ, NYSE ARCA, BATS, IEX), opciones cotizadas en EE. UU. (simples y multi-leg, compensadas por OCC), cripto (a través de la filial Alpaca Crypto LLC), acciones fraccionadas y ETFs.
- Modelo de runtime
- Runtime de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones comunes
- alpaca-py (SDK de Python actual), alpaca-trade-api (heredado), alpaca-trade-api-js, clientes nativos REST y WebSocket, NautilusTrader, 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
- Runtime, despliegue, logs, health checks, selección de región, control MCP
- Rol de Alpaca
- Cuenta de bróker, acceso a la API, datos de mercado, centro de ejecución, custodia, liquidación e informes fiscales
- Reguladores
- Alpaca Securities LLC: broker-dealer registrado en la SEC y FINRA (CRD 288257). Miembro de SIPC. Alpaca Crypto LLC: Money Services Business registrado en FinCEN para el trading de criptomonedas.
- Minoristas de EE. UU.
- Sí. Soporta tanto paper trading como trading real.
- Afiliación
- TradingHost es independiente y no está afiliado a Alpaca Securities LLC ni a Alpaca Crypto LLC
Sección 02 · Qué ofrece Alpaca
Qué ofrece Alpaca
Alpaca ofrece una API REST y WebSocket diseñada para desarrolladores que cubre acciones de EE. UU., opciones de EE. UU. y criptomonedas bajo una sola credencial. La Trading API y la Market Data API se encuentran en hosts independientes. Los entornos paper y live comparten la misma estructura de endpoints pero usan claves separadas, por lo que una estrategia probada en paper se pasa a producción sin reescribir código. Las rutas de endpoints específicas, los límites de rate limit y los niveles de suscripción de datos se detallan en la documentación de Alpaca.
Mercados y patrones de estrategia
- Rebalanceo de cartera compatible con acciones fraccionadas
- Estrategias de opciones de EE. UU. single-leg y multi-leg
- Acciones, opciones y criptomonedas bajo una única Trading API unificada
- Estrategias validadas en paper que se pasan a producción sin cambios de código
- Streaming por WebSocket de cotizaciones, operaciones y eventos de cuenta
- Estrategias de criptomonedas spot de Alpaca Crypto LLC (BTC, ETH y más)
- Estrategias sistemáticas de acciones con datos SIP de Algo Trader Plus
Superficie de la API
- Superficies de productos
- Trading API v2 para acciones de EE. UU., opciones de EE. UU. y criptomonedas bajo una sola credencial. La Market Data API ofrece cotizaciones, operaciones y barras en un host independiente. Los entornos paper y live utilizan URLs base y claves independientes; ambos comparten la misma estructura de endpoints, por lo que el código probado en paper se pasa a producción sin reescribirlo.
- Métodos de conexión
- REST para órdenes, posiciones, estado de la cuenta, cadenas de opciones y metadatos de activos. Streams de WebSocket para datos de mercado en tiempo real (cotizaciones, operaciones, barras) y actualizaciones de operaciones a nivel de cuenta. Criptomonedas, acciones y opciones comparten las mismas convenciones de REST y WebSocket, diferenciándose únicamente por el asset_class y la ruta del endpoint.
- Autenticación
- ID de clave API y secreto en las cabeceras de solicitud APCA-API-KEY-ID and APCA-API-SECRET-KEY. Las claves de paper y live se emiten por separado; una clave de paper no puede enviar una orden real. OAuth 2.0 está disponible para aplicaciones delegadas (por ejemplo, fintechs con front-end de bróker) en lugar de para el acceso a estrategias individuales.
Para detalles específicos, consulte Alpaca
Los endpoints específicos, los límites de rate limit, los niveles de suscripción de datos de mercado y los requisitos de aprobación de opciones se encuentran en la documentación de Alpaca. Consúltalos como la fuente de verdad.
Sección 03 · Desarrollo con IA
Desarrolle su estrategia para Alpaca con IA
Elige un método de integración, haz un fork de una plantilla de inicio de TradingHost y desarrolla tu estrategia en un IDE 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.
REST y WebSocket nativos de Alpaca
Control directo sobre el estado de la cuenta de Alpaca, los endpoints de órdenes y la Market Data API. Utiliza cualquier cliente HTTP y WebSocket que tu contenedor pueda ejecutar.
alpaca-py
El SDK oficial actual de Python de alpacahq. Cubre la Trading API, la Market Data API, la API del bróker y criptomonedas. Utilízalo para nuevos proyectos.
alpaca-trade-api (heredado)
SDK de Python anterior, aún mantenido para estrategias existentes. Alpaca recomienda migrar a alpaca-py para nuevos desarrollos.
Conector personalizado o de framework
NautilusTrader, motores propios, JavaScript y TypeScript a través de alpaca-trade-api-js, y cualquier otro framework que envuelva los endpoints REST y WebSocket de Alpaca.
Soporte de librerías y frameworks para productos de Alpaca
alpaca-py cubre toda la superficie de Alpaca (acciones, opciones, criptomonedas, paper trading) y es el SDK recomendado para nuevos proyectos. alpaca-trade-api se sigue manteniendo para estrategias existentes. NautilusTrader cuenta con una integración de Alpaca mantenida por la comunidad; confirma la cobertura de opciones en la documentación actual del adaptador antes de utilizarlo.
✓ soporte confirmado según la documentación oficial del SDK o del adaptador. "partial" indica cobertura parcial a nivel de adaptador; verifícalo en la documentación actual de la integración. "check SDK" indica que la función depende de la versión del SDK. Los enlaces de flujos de trabajo apuntan a páginas de /workflows/ actualmente en desarrollo.
TradingHost no impone ninguna biblioteca. Ejecuta tu proyecto.
Desarrollo con IA
Tanto alpaca-py como alpaca-trade-api funcionan con IDEs de IA. La superficie de control MCP de TradingHost cierra el círculo: las herramientas de IA pueden inspeccionar despliegues, revisar logs y gestionar el runtime junto a ti, sin intervenir jamás en la ruta de ejecución de operaciones.
Sección 04 · Ejecución en TradingHost
Ejecuta tu código en TradingHost
Alpaca proporciona la cuenta de broker, el acceso a la API y el entorno de ejecución. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Alpaca.
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 Alpaca.
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
Vincula TradingHost a tu repositorio de estrategia de Alpaca existente, o haz un fork de una plantilla de inicio de alpaca-py para obtener una base funcional.
- PASO 03
Despliega en un contenedor de TradingHost
Seleccione una región (US-East se encuentra más cerca de los motores de emparejamiento de acciones de EE. UU.; EU funciona para criptomonedas en la sesión europea), introduzca su clave API y clave secreta de Alpaca como variables de entorno, y despliegue. TradingHost compila su contenedor desde el repositorio y ejecuta su estrategia en infraestructura gestionada de Kubernetes. No se requiere una instalación local de Docker.
- 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 se volverá a desplegar automáticamente. Un despliegue con claves de paper es el entorno de prueba natural antes de pasar a claves reales.
Sección 05 · Notas operativas
Notas operativas para Alpaca
Aspectos que pueden complicar la ejecución real de una estrategia de Alpaca en un entorno en la nube basado en contenedores, y que no siempre aparecen en la documentación de Alpaca ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de Alpaca o de una fuente regulatoria oficial; las pautas de despliegue provienen de la experiencia de ejecutar estas estrategias en TradingHost.
01 · Cabeceras de autenticación
APCA-API-KEY-ID y APCA-API-SECRET-KEY en las cabeceras de la solicitud
Alpaca autentica las solicitudes de la Trading API con el ID de la clave API y el secreto en las cabeceras APCA-API-KEY-ID y APCA-API-SECRET-KEY. No hay un paso de firma independiente. OAuth 2.0 es un flujo aparte utilizado por aplicaciones delegadas (como una fintech que desarrolla sobre Alpaca para sus clientes), no por estrategias individuales. Las claves de simulación (paper) y reales (live) se emiten por separado y no son intercambiables.
02 · Entornos paper y live
El entorno paper utiliza una URL base y una clave diferentes
El trading en simulación se ejecuta contra paper-api.alpaca.markets. El trading real se ejecuta contra api.alpaca.markets. Los endpoints de streaming de WebSocket difieren de manera similar. Las claves generadas para paper no pueden enviar órdenes al entorno real y viceversa. Por lo demás, la estructura de los endpoints es idéntica, por lo que el código validado en paper se pasa a producción simplemente cambiando la URL base y el conjunto de claves. Guarde las credenciales de paper y live en entradas de Secrets independientes en TradingHost; nunca reutilice una clave entre entornos.
03 · Planes de datos de mercado
Básico (solo IEX) frente a Algo Trader Plus (SIP completo de EE. UU.)
El plan de datos de mercado predeterminado de Alpaca devuelve cotizaciones y operaciones solo de IEX, lo cual es suficiente para muchas estrategias sistemáticas, pero constituye un libro de órdenes parcial por definición. Algo Trader Plus es el plan de pago a nivel de SIP y desbloquea los datos de la cinta consolidada. Las estrategias que dependen de la precisión del top-of-book en todos los centros de negociación deben declarar una suscripción a Algo Trader Plus como requisito previo para el despliegue; las estrategias que funcionan con el muestreo exclusivo de IEX no lo necesitan.
FuenteAlpaca docs, Market Data04 · Acciones fraccionadas
Use notional en lugar de qty para órdenes fraccionadas y verifique fractionable: true
Alpaca admite acciones fraccionadas según el símbolo. Para comprar un importe en dólares en lugar de un número de acciones, envíe una orden con notional en lugar de qty. Antes de enviarla, consulte el endpoint de metadatos del activo y confirme que fractionable: true; no todos los símbolos cotizados admiten fraccionamiento. Las órdenes fraccionadas canceladas no pueden ejecutarse parcialmente de la misma manera que una orden de acciones completas, por lo que la gestión de errores debe tener en cuenta esta diferencia.
FuenteAlpaca docs, Orders05 · Aprobación de opciones
Se requiere por separado de las acciones; el nivel de aprobación controla las estrategias aceptadas
La negociación de opciones en Alpaca requiere un paso de aprobación independiente más allá del alta para acciones. El nivel de aprobación se muestra en el endpoint de la cuenta; Alpaca rechazará las órdenes que superen el nivel aprobado, no TradingHost. Planifique el despliegue en función de una estrategia que se ajuste a su nivel aprobado, o solicite un nivel superior a Alpaca antes de realizar el despliegue. TradingHost no puede omitir ni modificar la aprobación de opciones.
06 · Pattern Day Trader
PDT se aplica a cuentas de margen de menos de $25,000 según la FINRA Rule 4210
La FINRA Rule 4210 clasifica una cuenta de margen como Pattern Day Trader tras realizar cuatro o más operaciones intradiarias en un plazo de cinco días hábiles, y restringe la operativa intradiaria posterior hasta que el patrimonio alcance los $25,000. Alpaca expone este indicador en el endpoint de la cuenta (pattern_day_trader). La regla se aplica en el bróker, no en el entorno de ejecución. Las estrategias que realizan operaciones intradiarias frecuentes en cuentas de margen por debajo del umbral deben planificarse teniendo en cuenta esta restricción o fondear la cuenta por encima de los $25,000.
07 · Entidad de criptomonedas
Las operaciones con criptomonedas se realizan a través de Alpaca Crypto LLC, una entidad independiente registrada en la FinCEN
La negociación de criptomonedas al contado la ofrece Alpaca Crypto LLC, una empresa de servicios monetarios registrada en la FinCEN, no Alpaca Securities LLC. Desde la perspectiva de la estrategia, la credencial es la misma y la interfaz de órdenes se expone a través de la misma Trading API; desde una perspectiva regulatoria, la entidad legal es distinta. La cobertura de SIPC se aplica a la cuenta del bróker-dealer, no a las tenencias de criptomonedas. Indique esto claramente en cualquier texto de divulgación de riesgos que genere junto con la estrategia.
Sección 06 · Diseñado para
Diseñado para
Los entornos de ejecución de TradingHost para Alpaca son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Traders sistemáticos de acciones y opciones
- Desarrolladores cuantitativos que pasan de notebooks a producción
- Desarrolladores de Python que utilizan alpaca-py
- Traders minoristas que dan el salto desde interfaces gráficas de brókers (Robinhood, Webull, Power E*Trade)
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 Alpaca Securities LLC ni a Alpaca Crypto LLC.
No. TradingHost es un entorno de ejecución para código de estrategias de trading. Alpaca Securities LLC es el bróker-dealer, registrado ante la SEC y la FINRA (CRD 288257) y miembro de la SIPC. Su cuenta, custodia, acceso al mercado, liquidación e informes fiscales corresponden en su totalidad a Alpaca.
No. El código de su estrategia se conecta a Alpaca y envía instrucciones de órdenes según su propia lógica, permisos de cuenta y 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 Alpaca lo proporciona Alpaca. Usted es responsable de su cuenta de Alpaca, los permisos de la API, las credenciales y el cumplimiento de los términos de Alpaca.
AWS y DigitalOcean le ofrecen capacidad de cómputo básica. Usted mismo debe encargarse de las actualizaciones del sistema operativo, la orquestación de contenedores, el envío de registros, la rotación de secretos, la conmutación por error de región y la supervisión del tiempo de actividad. TradingHost le ofrece un entorno de ejecución gestionado y diseñado específicamente para estrategias de trading: despliegue nativo desde GitHub, control mediante MCP desde IDE de IA y visualización de registros y estado de salud listos para usar. Si prefiere gestionar la infraestructura usted mismo, AWS es una opción. Si prefiere el entorno de ejecución como un servicio gestionado, TradingHost es el camino más rápido.
Sí. El SDK de Python actual de Alpaca es alpaca-py; el más antiguo, alpaca-trade-api, se sigue manteniendo. Ambos se ejecutan en TradingHost. JavaScript y TypeScript funcionan a través de alpaca-trade-api-js.
Sí. TradingHost admite cualquier lenguaje que pueda ejecutarse dentro de un contenedor. Alpaca ofrece alpaca-trade-api-js para JS y TS; otros lenguajes pueden realizar llamadas directas a los endpoints REST y WebSocket.
Sí, sujeto a la aprobación de opciones de Alpaca. Las opciones se exponen a través de la misma credencial de la Trading API que las acciones y las criptomonedas. El nivel aprobado controla qué estrategias acepta el bróker; TradingHost no elude la aprobación de opciones.
Sí. El servicio de criptomonedas lo proporciona Alpaca Crypto LLC, una empresa de servicios monetarios registrada en la FinCEN que es una entidad legal independiente de Alpaca Securities LLC. Desde la perspectiva de la estrategia, la credencial de la Trading API es la misma; desde una perspectiva regulatoria, la entidad es distinta.
Conecte su repositorio de GitHub que contiene el código de la estrategia, vincúlelo a TradingHost y realice el despliegue. Utilice un despliegue con claves de paper como entorno de prueba y pase a claves live una vez que la estrategia sea estable. Vincular GitHub y crear una estrategia es gratuito; los planes del entorno de ejecución se detallan en la página de precios.
En su flujo de trabajo de secretos controlado por GitHub. TradingHost las lee en tiempo de ejecución a través de los secretos del repositorio de GitHub, secretos de entorno o su propio proceso aprobado de gestión de secretos. TradingHost no necesita la custodia de su APCA-API-KEY-ID ni de su APCA-API-SECRET-KEY. Consulte 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 transferencia de fondos. La clave API solo necesita los permisos necesarios para la colocación de órdenes y el acceso a datos de mercado.
Sí. TradingHost admite el control basado en MCP para IDEs de IA, incluidos Cursor, Claude Code, GitHub Copilot y agentes de IA basados en CLI. Las herramientas de IA pueden inspeccionar despliegues, revisar logs, reiniciar estrategias y gestionar flujos de trabajo del runtime. MCP es una interfaz de control y observabilidad, no la ruta de ejecución de operaciones. Consulta la interfaz de control de MCP para obtener más información.
Sí, siempre que las trates como estrategias independientes en TradingHost con secrets independientes. El entorno paper de Alpaca utiliza URLs base y claves diferentes a las de live, por lo que los despliegues quedan aislados mediante la configuración. El mismo código fuente puede ejecutar ambos con diferentes variables de entorno.
No. La regla PDT (FINRA Rule 4210) la aplica Alpaca, no TradingHost. Las cuentas de margen con menos de $25,000 están sujetas a las restricciones de PDT para el day trading. Tu estrategia debería consultar el endpoint de la cuenta y respetar el flag pattern_day_trader.
No. Tus formularios 1099 provienen de Alpaca al final del año, no de TradingHost. TradingHost proporciona el runtime; Alpaca se encarga de los informes fiscales del bróker.
No. La SIPC cubre tu cuenta de corretaje de Alpaca (hasta $500,000, incluidos $250,000 en efectivo) bajo la protección para miembros de la SIPC. El runtime 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., lo que la convierte en la opción natural para la mayoría de las estrategias de Alpaca. Consulte la página de regiones para obtener detalles sobre enrutamiento y proximidad.
No. TradingHost se centra en el despliegue y el runtime de producción. El backtesting pertenece a tu entorno de investigación, framework o AlgoBuilder.