Runtime nativo de IA para estrategias de trading en OKX
Desarrolla en Cursor, Claude Code o cualquier IDE de IA. Despliega desde GitHub en un runtime en la nube gestionado con control MCP de primer nivel, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- OKX
- Tipo de plataforma
- Exchange de criptomonedas
- Clase de activo
- Cripto
- Productos compatibles
- Spot, swaps perpetuos, futuros con vencimiento, opciones (BTC y ETH), margin, Simple Earn (flexible y fijo). Los futuros con vencimiento de BTC/ETH con margen en USDT se eliminarán gradualmente antes del 26 de junio de 2026, tras lo cual continuarán los futuros con vencimiento con margen en USD.
- Modelo de ejecución
- Runtime de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones habituales
- API nativa v5 de OKX (REST y WebSocket), CCXT (okx), Hummingbot (okx, okx_perpetual), Freqtrade (spot y futuros, con limitaciones), personalizada
- Integración con flujos de trabajo de IA
- Interfaz de control MCP para Cursor, Claude Code, GitHub Copilot y agentes de CLI
- Rol de TradingHost
- Runtime, despliegue, logs, comprobaciones de estado, selección de región, control MCP
- Rol de OKX
- Cuenta de exchange, acceso a la API, acceso al mercado, plataforma de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a OKX
Sección 02 · Qué ofrece OKX
Qué ofrece OKX
OKX ofrece spot, swaps perpetuos, futuros con vencimiento, opciones sobre BTC y ETH, y trading con margen a través de una Unified Account que admite los modos multi-currency margin y portfolio margin. La API v5 expone REST y tres URL de WebSocket (pública, privada y de negocios), además de un entorno de simulación (demo) que utiliza los nombres de host de producción con la cabecera `x-simulated-trading: 1` en lugar de un host de testnet independiente. Los detalles de los endpoints cambian con el tiempo, pero la estructura se mantiene; los límites de frecuencia exactos, los niveles de comisiones y las listas de símbolos se encuentran en la documentación de OKX.
Mercados y patrones de estrategia
- Swaps perpetuos con margen en USDT y criptomonedas (coin-margined)
- Estrategias de opciones sobre BTC y ETH (covered calls, spreads, operaciones a vencimiento)
- Modo portfolio margin (margen basado en riesgo de productos cruzados)
- Modo multi-currency margin (múltiples activos como margen compartido con valor en USD)
- Unified Account que abarca spot, margin, perpetuos, futuros y opciones
- Jerarquía de subcuentas bajo una cuenta maestra
- Trading simulado mediante claves API de demo con la cabecera x-simulated-trading: 1
- Migración de demo a producción (claves de demo independientes y posterior cambio a claves reales sin reescribir código)
Interfaz de la API
- Áreas de producto
- Spot, swaps perpetuos, futuros con vencimiento, opciones (BTC, ETH), margin, además de un entorno de simulación (demo) que replica los mismos endpoints. No existe un host testnet.okx.com independiente: el entorno de demo utiliza los nombres de host de producción con la cabecera x-simulated-trading: 1 en cada solicitud y una clave API de demo creada desde el panel de trading simulado.
- Métodos de conexión
- REST v5, WebSocket público (wss://ws.okx.com:8443/ws/v5/public), WebSocket privado (wss://ws.okx.com:8443/ws/v5/private) y WebSocket de negocios (wss://ws.okx.com:8443/ws/v5/business). Las órdenes se pueden colocar, modificar y cancelar a través de WebSocket, además de REST.
- Autenticación
- Firma HMAC-SHA256, clave API, secreto y frase de contraseña (credencial de 3 partes). Cabeceras: OK-ACCESS-KEY, OK-ACCESS-SIGN, OK-ACCESS-TIMESTAMP (ISO 8601 UTC, ms), OK-ACCESS-PASSPHRASE. Hasta 20 direcciones IP permitidas por clave API. El trading de demo utiliza claves de demo independientes junto con la cabecera x-simulated-trading: 1.
Para más detalles, consulte OKX
Los endpoints específicos, los límites de frecuencia, las listas de símbolos, los niveles de comisiones y el historial de versiones se encuentran en la documentación de OKX. Considéralos la fuente de información oficial.
- okx.com/docs-v5/enReferencia de la API v5 de OKX
- okx.com/help/how-to-use-demo-tradingGuía de trading simulado (demo)
- okx.com/help/v5-api-websocket-changesEndpoints de WebSocket (público, privado, de negocios)
- okx.com/help/subaccounts-account-mode-faqPreguntas frecuentes sobre subcuentas, modos de cuenta y conexiones API
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para OKX con IA
Elija un método de integración, haga un fork de una plantilla de TradingHost y desarrolle su 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.
API nativa v5 de OKX
Control directo sobre el comportamiento específico de OKX, el estado de la Unified Account, el enrutamiento de subcuentas y la lógica de ejecución de órdenes.
Freqtrade o Hummingbot
Despliegues basados en frameworks utilizando su estructura de estrategia y modelo de configuración.
Conector personalizado
Tu propio motor de trading interno o integración propietaria con OKX.
Compatibilidad de frameworks con productos de OKX
La cobertura varía según el framework. CCXT abarca la mayor parte de la API de OKX; Freqtrade y Hummingbot cubren spot y perpetuos (Freqtrade también cubre futuros con vencimiento); el acceso nativo a la API v5 de OKX cubre todo lo que ofrece el exchange, incluyendo opciones sobre BTC y ETH.
✓ soporte confirmado según la documentación oficial del framework. "parcial" indica cobertura limitada o solo de datos de mercado. "no" indica que no está documentado oficialmente como compatible.
TradingHost no impone ningún framework. Simplemente ejecuta su proyecto.
Desarrollo con IA
Las plantillas de inicio anteriores se integran de forma natural con los IDE de IA. La interfaz de control MCP de TradingHost completa el ciclo: las herramientas de IA pueden inspeccionar despliegues, revisar registros y gestionar el entorno de ejecución junto a usted, sin intervenir nunca en la ruta de ejecución de las operaciones.
Sección 04 · Ejecutar en TradingHost
Ejecuta tu código en TradingHost
OKX proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a OKX.
En lugar de ejecutar el código de tu estrategia en un portátil, un ordenador 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 OKX.
TradingHost
- Mantiene el entorno de ejecución en línea.
- Muestra los logs 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 empieza desde un framework
Apunta TradingHost hacia el repositorio de tu estrategia existente, o haz un fork de un entorno de ejecución de framework de TradingHost (CCXT, Freqtrade o Hummingbot) para obtener una base funcional.
- PASO 03
Desplegar en un contenedor de TradingHost
Selecciona una región (EU o US-East), introduce las variables de entorno que necesita tu estrategia (clave API, secreto y frase de contraseña de OKX, la credencial de tres partes) y despliega. TradingHost compila tu contenedor desde el repositorio y ejecuta tu estrategia en una infraestructura gestionada de Kubernetes. No requiere instalación local de Docker.
- PASO 04
Monitorear logs y estado de salud
Siga en tiempo real los logs, el estado de salud y el estado del runtime desde el panel de control de TradingHost. Se puede acceder a la misma interfaz mediante MCP desde cualquier AI IDE, de modo que Cursor, Claude Code o un agente de CLI pueden leer el estado del despliegue y gestionar el runtime junto con usted.
- PASO 05
Actualizar y redesplegar
Suba los cambios a su rama principal de GitHub y TradingHost realizará el redespliegue automáticamente.
Sección 05 · Notas operativas
Notas operativas para OKX
Detalles críticos que surgen al ejecutar una estrategia de OKX en un runtime en la nube basado en contenedores, que no aparecen en la documentación de OKX ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de OKX; las pautas de despliegue provienen de la ejecución de estas estrategias en TradingHost.
01 · Versión de la API
OKX está en la v5; la v3 se retiró en 2022, no hay v4
OKX omitió la v4 (por la connotación del número 4) y pasó directamente de la v3 a la v5. La API v3 dejó de funcionar el 5 de enero de 2022, una vez completada en su mayor parte la migración a la Unified Account. Actualmente no existe una alternativa de compatibilidad con la v3: todas las integraciones deben apuntar a los endpoints de la v5.
02 · Trading simulado (demo)
El entorno de demo es una cabecera y claves independientes, no un host separado
OKX no opera un host testnet.okx.com independiente. El trading de demostración utiliza los hostnames de producción con la cabecera x-simulated-trading: 1 en cada solicitud, además de una clave API de demostración creada desde el panel de trading de demostración. Las claves de producción no se autenticarán en el entorno de demostración, y las claves de demostración fallarán silenciosamente si falta la cabecera.
03 · Autenticación
Credencial de tres partes más marca de tiempo firmada
OKX requiere una clave API, un secreto y una frase de contraseña (la passphrase se establece al crear la clave, no es la contraseña de la cuenta). Las solicitudes firman la marca de tiempo + método + requestPath + cuerpo con HMAC-SHA256 base64 y envían el resultado en OK-ACCESS-SIGN. El código 50111 corresponde a una clave no válida y el 50113 a una firma no válida; ambos son comunes cuando falta la frase de contraseña o cuando hay un desfase en la marca de tiempo.
04 · WebSockets
Tres URLs de WebSocket en lugar de una
OKX divide el tráfico de WebSocket en Público (datos de mercado, sin autenticación), Privado (cuenta, ejecuciones, posiciones, órdenes; requiere inicio de sesión autenticado) y de Negocios (canales de algoritmos, grid y otros especializados). Una estrategia que se suscriba a un canal exclusivo de Negocios en la URL Pública no recibirá nada y parecerá "silenciosa". La asignación de canales a URLs cambia ocasionalmente; revise las notas de migración antes de añadir suscripciones.
05 · Modo de cuenta
El modo portfolio margin es opcional y modifica el cálculo del margen
La Unified Account cuenta con varios modos (efectivo, margen de moneda única, multi-currency margin y portfolio margin). El modo multi-currency utiliza activos convertidos a USD como margen compartido. El modo portfolio margin aplica un modelo basado en el riesgo a través de spot, margen, perpetuos, futuros y opciones para optimizar la eficiencia del capital. OKX ha dejado de admitir posiciones de margen aislado dentro de los modos multi-currency y portfolio margin, por lo que la lógica de dimensionamiento de posiciones escrita para el modo aislado no es transferible.
06 · Acceso desde EE. UU.
OKX global bloquea a los minoristas de EE. UU.; OKX US es una plataforma independiente
En febrero de 2025, el DOJ anunció que la entidad afiliada a OKX, Aux Cayes FinTech Co. Ltd., se declaró culpable de operar un negocio de transmisión de dinero sin licencia y aceptó sanciones por un total aproximado de 505 millones de dólares (420,3 millones en decomiso y 84,4 millones en multa). OKX global ha restringido a las personas de EE. UU. por política interna desde 2017; dicha restricción continúa en okx.com. Posteriormente, OKX relanzó una entidad estadounidense independiente en okx.com/en-us en 2025 (disponible en 41 estados; KY, NY, TX y algunos territorios quedaron excluidos en el lanzamiento). Las estrategias deben dirigirse al endpoint de OKX que corresponda a la entidad con licencia de la cuenta.
07 · Lista de IP permitidas
Las claves API sin lista de IP permitidas representan un riesgo de seguridad
OKX admite hasta 20 direcciones IP por clave en la lista de permitidas y recomienda encarecidamente vincular las claves a IPs específicas. Sin una vinculación de IP, una clave filtrada puede utilizarse desde cualquier lugar. Para entornos de ejecución en contenedores, utilice la IP de salida estática de la región de la estrategia y añádala a la lista de permitidas de la clave; rote la frase de contraseña y el secreto ante cualquier sospecha de exposición (la frase de contraseña no se puede recuperar).
FuenteOKX API FAQ
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para OKX son ideales para:
- Desarrolladores que crean estrategias en IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de criptomonedas
- Desarrolladores cuantitativos (quants)
- Usuarios de CCXT, Freqtrade y Hummingbot
- Equipos que migran de alojamiento VPS a despliegues en contenedores
Conectar GitHub y crear su primera estrategia es gratis.
Sección 08 · Preguntas frecuentes
Preguntas frecuentes
No. TradingHost es independiente y no está afiliado a OKX.
No. El código de su estrategia se conecta a OKX y envía instrucciones según su propia lógica, los permisos de su cuenta y el método de integración. TradingHost proporciona el entorno de ejecución (runtime) donde se ejecuta dicho código.
No. El acceso a la API de OKX lo proporciona OKX. Usted es responsable de su cuenta de OKX, los permisos de la API, las credenciales y el cumplimiento de los términos de OKX.
No. TradingHost es el entorno de ejecución en la nube donde se ejecuta el código de su estrategia. No proporcionamos señales, modelos de predicción de IA ni estrategias preconfiguradas. Con TradingHost, usted mismo escribe o genera la estrategia (a menudo con Cursor o Claude Code), la mantiene en GitHub como su propio código y utiliza TradingHost para ejecutarla en producción. Productos como 3Commas, Cryptohopper y similares son propietarios de la lógica de la estrategia; TradingHost simplemente ejecuta la suya.
AWS y DigitalOcean le ofrecen capacidad de cómputo pura. Usted mismo debe encargarse de las actualizaciones del sistema operativo, la orquestación de contenedores, el envío de registros (logs), 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 IDEs de IA, y paneles de registros y estado 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í. TradingHost ejecuta estrategias en Python; elija el entorno de ejecución de framework que coincida con su pila tecnológica o despliegue su propio repositorio.
Sí. TradingHost admite cualquier lenguaje que pueda ejecutarse dentro de un contenedor.
CCXT expone OKX (okx, anteriormente okex) para el trading de spot y swaps perpetuos, así como para datos de cuenta, de mercado e históricos. También admite futuros. Se puede acceder a los datos de mercado de opciones mediante la simbología de OKX, pero la ejecución de órdenes de opciones a través de los métodos unificados de CCXT es limitada; enrute las órdenes de opciones a través del cliente nativo OKX v5. El objeto de intercambio de OKX requiere apiKey, secret y password (la frase de contraseña), además de las cabeceras estándar de subcuenta. Consulte el entorno de ejecución del framework CCXT para ver los detalles completos de la configuración.
Sí, si su proyecto está diseñado de esa manera. Puede ejecutar múltiples procesos o servicios de estrategia dentro de un solo entorno de ejecución, o separarlos en diferentes entornos para mayor aislamiento y claridad operativa. Consulte la página del entorno de ejecución de TradingHost para conocer el modelo multiestrategia.
El camino más rápido es hacer un fork de un entorno de ejecución de framework de TradingHost: CCXT, Freqtrade o Hummingbot para obtener un proyecto listo para desplegar. O bien, conecte su propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de 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 clave API, secreto o frase de contraseña. Consulte los secretos de la plataforma para conocer el modelo de gestión completo.
No. Las estrategias nunca deberían necesitar permisos de retiro. Utilice permisos acotados (lectura, trading) y vincule la clave a la IP de salida de su entorno de ejecución mediante la lista de IP permitidas de OKX (hasta 20 IPs por clave).
OKX utiliza una credencial de 3 partes: clave API, secreto y frase de contraseña. La frase de contraseña (passphrase) es una cadena definida por el usuario que se introduce al crear la clave API, se envía en cada solicitud autenticada a través de OK-ACCESS-PASSPHRASE y se mezcla en la firma HMAC-SHA256 junto con el secreto. OKX no puede recuperar la frase de contraseña si se pierde; tendrá que regenerar la clave. Trátela como cualquier otro secreto.
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 registros, reiniciar estrategias y gestionar flujos de trabajo del entorno de ejecución. MCP es una interfaz de control y observabilidad, no la ruta de ejecución de operaciones. Consulte la interfaz de control MCP para obtener más información.
Ambos. La interfaz de control de MCP funciona igual de bien desde agentes basados en CLI (Claude Code CLI, clientes MCP personalizados, llamadas MCP programadas) que desde el interior de un IDE. El flujo de despliegue nativo de GitHub también funciona sin herramientas de IA: un simple git push a tu rama principal activa un nuevo despliegue.
El runtime detecta la caída y expone los logs y la información de estado pertinentes. En los entornos compatibles, la estrategia afectada se puede reiniciar sin interrumpir otras estrategias que se ejecuten en el mismo contenedor. El código de tu estrategia sigue siendo responsable de la gestión segura de errores, la protección contra órdenes duplicadas y los controles de riesgo. Consulta la sección de observabilidad para conocer los logs y la interfaz de estado.
El error 50111 significa que OKX no pudo encontrar la clave de API (clave incorrecta, entorno incorrecto o se usó una clave de demostración en el entorno real). El error 50113 significa que la firma no se validó. Las causas habituales son: passphrase incorrecta o ausente, secret incorrecto, desfase horario en OK-ACCESS-TIMESTAMP (debe ser ISO 8601 UTC con precisión de milisegundos), orden incorrecto en la cadena pre-hash (timestamp + method + requestPath + body), o la falta de x-simulated-trading: 1 al usar una clave de demostración. Ejecuta la sincronización NTP en el contenedor y registra la cadena pre-hash en compilaciones que no sean de producción.
Sí. Crea una clave de API de demostración desde el panel de trading de demostración de OKX y añade x-simulated-trading: 1 a cada cabecera REST y WebSocket. El host sigue siendo el mismo. Las claves de demostración no pueden operar en real, las claves reales no pueden operar en demostración y la cabecera es obligatoria en cada llamada; cambia ambas a la vez al pasar a producción.
El modo de cuenta se configura a nivel de Unified Account y afecta al cálculo del margen. El modo multi-currency trata los activos convertidos a USD como margen compartido. El modo portfolio margin aplica un modelo basado en el riesgo que compensa la exposición entre spot, margin, perps, futuros y opciones. Las posiciones de margen aislado ya no son compatibles dentro de los modos multi-currency o portfolio.
La plataforma global de OKX (okx.com) restringe el acceso a personas de EE. UU. bajo una política de 2017. En febrero de 2025, Aux Cayes FinTech Co. Ltd. (afiliada a OKX) se declaró culpable de operar un negocio de transmisión de dinero no autorizado en EE. UU. y pagó 505 millones de dólares. Una entidad estadounidense independiente (okx.com/en-us) se relanzó en 2025 en 41 estados de EE. UU. OKX US y la plataforma global de OKX son mercados distintos; confirma a qué entidad pertenece tu cuenta antes de realizar el despliegue.
TradingHost se ejecuta en las regiones EU y US-East. Elige la región más cercana al motor de emparejamiento del que dependa tu estrategia. Consulta la página de regiones para obtener detalles sobre enrutamiento y proximidad.
No. TradingHost se centra en el entorno de ejecución (runtime) de producción y en el despliegue. El backtesting corresponde a tu entorno de investigación, framework o AlgoBuilder.