Runtime nativo de IA para estrategias de trading en KuCoin
Desarrolla en Cursor, Claude Code o cualquier IDE de IA. Despliega desde GitHub en un runtime en la nube administrado con control MCP de primer nivel, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- KuCoin
- Tipo de plataforma
- Exchange de criptomonedas (spot, margen, futuros, opciones)
- Clase de activo
- Cripto
- Productos compatibles
- Spot, margen cruzado/aislado (hasta 10x), contratos perpetuos con margen en USDT/USDC y con margen en cripto (inversos) en futures.kucoin.com, opciones de estilo europeo BTC/ETH (liquidadas en USDT, solo para compradores, solo en la app).
- Modelo de ejecución
- Runtime de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones habituales
- REST + WebSocket nativos de KuCoin, CCXT (kucoin, kucoinfutures), Freqtrade (spot confirmado por la comunidad), Hummingbot (kucoin, kucoin_perpetual), personalizado
- Integración con flujos de trabajo de IA
- Superficie de control MCP
- Rol de TradingHost
- Runtime, despliegue, logs, comprobaciones de estado, selección de región, control MCP
- Rol de KuCoin
- Cuenta de exchange, acceso a la API, acceso al mercado, plataforma de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a KuCoin. KuCoin tiene prohibido permanentemente el acceso a personas de EE. UU. según una orden de consentimiento de la CFTC (marzo de 2026) tras la declaración de culpabilidad de Peken Global por 297 millones de dólares ante el DOJ en enero de 2025.
Sección 02 · Qué ofrece KuCoin
Qué ofrece KuCoin
KuCoin ofrece spot, margen cruzado y aislado (hasta 10x), perpetuos con margen en USDT/USDC y con margen en cripto (inversos) en futures.kucoin.com, y opciones de estilo europeo BTC/ETH a través de APIs REST y WebSocket. Las estrategias se autentican con una credencial de 3 partes (clave, secreto y frase de contraseña) firmada con HMAC-SHA256. Spot y futuros son pilas de API independientes con claves separadas. Los detalles de los endpoints cambian con el tiempo. La estructura es duradera; los límites de frecuencia precisos, los niveles de comisiones y las listas de símbolos se encuentran en la documentación de KuCoin.
Mercados y patrones de estrategia
- Market making de spot en pares de altcoins con alta liquidez
- Perpetuos con margen en USDT en futures.kucoin.com
- Perpetuos con margen en cripto (inversos) en futures.kucoin.com
- Trading con margen cruzado y aislado de hasta 10x
- Jerarquía de sub-accounts para el aislamiento de estrategias
- Copia de estrategias a través del programa lead trader de KuCoin
- Trading de demostración a través de sandbox (solo spot)
- Estrategias de niveles de descuento de comisiones por staking de KCS
Interfaz de la API
- Áreas de producto
- Spot en api.kucoin.com, futuros en api-futures.kucoin.com, sandbox en openapi-sandbox.kucoin.com (solo spot).
- Métodos de conexión
- REST más WebSocket. WebSocket requiere un patrón de dos pasos: un POST a /api/v1/bullet-public o /api/v1/bullet-private para obtener un token y el endpoint wss:// real desde instanceServers. La lógica de reconexión debe volver a solicitar el token (ya que expira). Respeta los valores devueltos de pingInterval (~18000ms) y pingTimeout (~10000ms).
- Autenticación
- Credencial de 3 partes (clave API + secreto API + frase de contraseña), firma HMAC-SHA256. Cabeceras obligatorias: KC-API-KEY, KC-API-SIGN (base64 de HMAC-SHA256 sobre timestamp + método + endpoint + cuerpo), KC-API-TIMESTAMP (ms desde la época), KC-API-PASSPHRASE (para claves v2, es el base64 de HMAC-SHA256 de la frase de contraseña sin procesar, no el valor sin procesar), KC-API-KEY-VERSION ("2" para las claves v2 actuales). Spot y futuros utilizan claves API independientes creadas en paneles de control separados.
Para más detalles, consulte KuCoin
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 KuCoin. Considéralos como la fuente de verdad.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para KuCoin 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.
REST + WebSocket nativos de KuCoin
Control directo sobre el comportamiento específico de KuCoin, datos de cuenta, enrutamiento de sub-accounts y lógica de ejecución de órdenes.
CCXT
Interfaz común entre KuCoin y otros exchanges de criptomonedas. Spot y futuros se modelan como dos clases de exchange: kucoin y kucoinfutures.
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 KuCoin.
Compatibilidad de frameworks con productos de KuCoin
La cobertura varía según el framework. La API nativa y CCXT abarcan la mayor parte de la superficie de KuCoin; Hummingbot cubre spot y futuros perpetuos; Freqtrade cubre solo spot (confirmado por la comunidad, se requiere el campo de frase de contraseña en la configuración).
✓ compatibilidad confirmada según la documentación oficial del framework. "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
KuCoin proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a KuCoin.
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 KuCoin.
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
Elija una región (EU o US-East), proporcione las variables de entorno que requiere su estrategia (las credenciales de 3 partes de KuCoin: clave, secreto y frase de contraseña, junto con el requisito KC-API-KEY-VERSION: 2 para las claves v2 actuales) y despliegue. TradingHost compila su contenedor a partir del repositorio y ejecuta su estrategia en una infraestructura gestionada de Kubernetes. No requiere instalar Docker localmente.
- 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 KuCoin
Problemas reales al ejecutar una estrategia de KuCoin en un runtime en la nube basado en contenedores, que no encontrarás en la documentación de KuCoin ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de KuCoin (o de la presentación de la CFTC para la nota sobre el acceso desde EE. UU.); la guía de despliegue proviene de la ejecución de estas estrategias en TradingHost.
01 · Credencial de 3 partes
Clave, secreto y frase de contraseña, más cabecera de versión
Tanto spot como futuros requieren clave + secreto + frase de contraseña. Para las claves v2, la cabecera de la frase de contraseña debe ser el base64 de HMAC-SHA256 de la frase de contraseña sin procesar, no el valor sin procesar. La cabecera KC-API-KEY-VERSION debe establecerse en "2" para las claves actuales; omitirla en una clave v2 produce un error de firma.
02 · Errores comunes
400003 y 400004 son fallos de frase de contraseña
Una frase de contraseña ausente o con formato incorrecto produce el error 400003 KC-API-KEY not exists o 400004 KC-API-PASSPHRASE error. CCXT tiene un historial documentado de discrepancias en KC-API-KEY-VERSION que reproducen estos errores.
03 · Pilas separadas
Spot y futuros son APIs diferentes con claves diferentes
Las claves de spot no se autentican contra api-futures.kucoin.com. Las estrategias que operan en ambas superficies necesitan dos pares de claves y dos clientes configurados. CCXT modela esto como dos clases de exchange separadas (kucoin y kucoinfutures).
04 · WebSocket
Handshake de token tipo bullet, sin URL estática
KuCoin no expone una URL wss:// estática. Debe realizar una petición POST a /api/v1/bullet-public (para feeds públicos) o a /api/v1/bullet-private (para feeds de cuentas/órdenes) para recibir un token de un solo uso y el endpoint wss:// real desde instanceServers. Los tokens caducan, por lo que la lógica de reconexión debe volver a solicitarlos. Respete los valores devueltos de pingInterval (~18 s) y pingTimeout (~10 s).
05 · Sandbox
Solo Spot, estado completamente independiente
openapi-sandbox.kucoin.com cubre los endpoints de spot y utiliza un inicio de sesión, un conjunto de claves API y un saldo ficticio completamente independientes. Los futuros, el margen y las opciones no están disponibles en el sandbox, por lo que las estrategias que interactúan con api-futures.kucoin.com deben simular sus operaciones de otra manera (mediante una capa de ejecución simulada, un tamaño real mínimo o la función de simulación nativa del framework).
06 · Límites de peticiones
Pools de recursos ponderados por nivel VIP
Los pools de recursos ponderados por nivel VIP se restablecen en una ventana deslizante de 30 segundos. Al agotarse, se devuelve un error HTTP 429 con el código 429000 en el cuerpo. Cada respuesta incluye cabeceras con la cuota del pool, la cuota restante y la cuenta atrás para el restablecimiento. Varios endpoints v1 (como DELETE /api/v1/orders y GET /api/v1/hf/orders/active) están obsoletos y se recomienda usar las versiones v2/v3, que ofrecen límites más altos.
07 · Disponibilidad en EE. UU.
Prohibición permanente según la orden de consentimiento de la CFTC de marzo de 2026
Según la orden de consentimiento del SDNY del 30 de marzo de 2026 contra Peken Global Limited (el operador de KuCoin), KuCoin tiene prohibido permanentemente aceptar clientes de EE. UU. a menos que Peken Global se registre como Foreign Board of Trade ante la CFTC. Esta restricción se aplica a la cuenta de KuCoin, no al lugar donde se ejecuta el código de la estrategia; las regiones de ejecución y la conectividad de TradingHost no modifican esta limitación.
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para KuCoin son ideales para:
- Desarrolladores de trading algorítmico que ejecutan estrategias de spot en la amplia lista de pares de altcoins de KuCoin
- Traders de perpetuos que operan con contratos con margen en USDT o perpetuos inversos en futures.kucoin.com
- Equipos cuantitativos que utilizan sub-accounts para aislar estrategias o gestionar módulos de capital
- Usuarios de CCXT, Freqtrade y Hummingbot
- Desarrolladores de IA, Cursor y Claude que gestionan despliegues mediante MCP y GitHub
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 KuCoin.
No. El código de su estrategia se conecta a KuCoin y envía instrucciones según su propia lógica, los permisos de su cuenta y el método de integración elegido. TradingHost proporciona el entorno de ejecución (runtime) donde se ejecuta dicho código.
No. El acceso a la API de KuCoin lo proporciona KuCoin. Usted es responsable de su cuenta de KuCoin, los permisos de la API, las credenciales y el cumplimiento de los términos de servicio de KuCoin.
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 predefinidas. Con TradingHost, usted escribe o genera la estrategia por su cuenta (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 o Cryptohopper 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 administrado y diseñado específicamente para estrategias de trading: despliegue nativo desde GitHub, control mediante MCP desde entornos de desarrollo de IA y paneles de logs y estado listos para usar. Si prefiere gestionar la infraestructura usted mismo, AWS es una opción. Si busca un entorno de ejecución como 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 es compatible con cualquier lenguaje que pueda ejecutarse dentro de un contenedor.
Los mercados de spot y futuros de KuCoin utilizan APIs independientes (api.kucoin.com frente a api-futures.kucoin.com) con claves API distintas. En CCXT, esto se traduce en dos clases de exchange: kucoin para spot y margen, y kucoinfutures para futures.kucoin.com. Instancie ambas con su propia clave, secreto y frase de contraseña, dirija las órdenes al cliente correcto según el símbolo y guarde ambos conjuntos de credenciales como secretos independientes en TradingHost.
Sí, siempre que su proyecto esté diseñado para ello. Puede ejecutar múltiples procesos o servicios de estrategia dentro de un mismo entorno de ejecución, o bien separarlos en diferentes entornos para mayor aislamiento y claridad operativa. Consulte la página de entornos 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. También puede conectar su propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratuito; los planes de entornos 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 secretos del repositorio de GitHub, secretos de entorno o su propio proceso aprobado de gestión de secretos. TradingHost no necesita custodiar su clave API, secreto ni frase de contraseña. 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. Utilice permisos con alcance limitado (lectura, trading) y listas blancas de IP cuando corresponda.
Sí. TradingHost admite el control basado en MCP para entornos de desarrollo 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 de ejecución. MCP es una interfaz de control y observabilidad, no la ruta de ejecución de operaciones. Consulte la sección de la interfaz de control MCP para obtener más información.
Ambos. La interfaz de control MCP funciona igual de bien desde agentes basados en CLI (Claude Code CLI, clientes MCP personalizados, llamadas MCP programadas) que desde el propio entorno de desarrollo. El ciclo de despliegue nativo de GitHub también funciona sin herramientas de IA: un simple git push a su rama principal activa un nuevo despliegue.
El entorno de ejecución detecta el fallo y expone los logs y la información de estado correspondientes. Siempre que sea posible, la estrategia afectada se puede reiniciar sin interrumpir otras estrategias que se ejecuten en el mismo contenedor. El código de su estrategia sigue siendo responsable de la gestión segura de errores, la protección contra órdenes duplicadas y los controles de riesgo. Consulte la sección de observabilidad para conocer la interfaz de logs y estado.
Casi siempre se debe a uno de estos tres motivos. (1) La cabecera de la frase de contraseña para una clave v2 debe ser el valor base64 del HMAC-SHA256 de la frase de contraseña original, no la frase de contraseña en texto plano. (2) La cabecera KC-API-KEY-VERSION debe establecerse en "2" para las claves v2. (3) El payload de la firma es timestamp + UPPERCASE_METHOD + endpoint_with_query + body, donde body es una cadena vacía en las peticiones GET/DELETE. Omitir cualquiera de estos pasos genera este tipo de error.
KuCoin no expone una URL wss:// estática. Antes de conectarte, realiza una petición POST a /api/v1/bullet-public (para feeds públicos) o a /api/v1/bullet-private (para feeds de cuentas y órdenes). La respuesta te proporcionará un token de un solo uso junto con instanceServers[0].endpoint, el pingInterval y el pingTimeout. Conéctate a ese endpoint usando ?token=...&connectId=... y luego envía pings en el intervalo devuelto. Los tokens caducan, por lo que la lógica de reconexión debe volver a solicitar uno nuevo.
No. Tras una orden de consentimiento de la CFTC dictada el 30 de marzo de 2026 contra Peken Global Limited (el operador de KuCoin), KuCoin tiene prohibido de forma permanente aceptar a personas estadounidenses a menos que se registre como Foreign Board of Trade. Esta restricción se aplica a la cuenta de KuCoin, no al lugar donde se aloja el código de la estrategia, por lo que desplegarla en TradingHost no cambia los requisitos de elegibilidad.
Solo para Spot. openapi-sandbox.kucoin.com cubre los endpoints de spot y utiliza un inicio de sesión, un conjunto de claves API y un saldo ficticio completamente independientes. Los futuros, el margen y las opciones no están disponibles en el sandbox, por lo que cualquier estrategia que interactúe con api-futures.kucoin.com debe probarse en simulación de otra manera (mediante una capa de ejecución simulada, con un tamaño de posición real muy pequeño o con la ejecución en seco nativa del framework) antes de escalar.
TradingHost se ejecuta en las regiones EU y US-East. Seleccione la región más cercana al motor de emparejamiento del que dependa su estrategia. Consulte la página de regiones para conocer los detalles de enrutamiento y proximidad.
No. TradingHost se centra en el entorno de ejecución en producción y el despliegue. El backtesting debe realizarse en tu propio entorno de investigación, framework o AlgoBuilder.