Tiempo de lectura: … min

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.

Por el equipo de ingeniería de TradingHost

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).

FrameworkSpotMargenFuturos
Native KuCoin REST + WebSocketCompatibleCompatibleCompatible
CCXTCompatibleCompatibleCompatible
FreqtradeCompatibleSin soporte documentadoSin soporte documentado
HummingbotCompatibleSin soporte documentadoCompatible

✓ 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

  1. PASO 01

    Conecta GitHub

    Autoriza a TradingHost para acceder a tu cuenta de GitHub.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  1. 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.

  2. 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.

  3. 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).

  4. 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).

  5. 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).

  6. 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.

  7. 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.