Entorno de ejecución nativo para IA para estrategias de trading en Crypto.com Exchange
Desarrolla en Cursor, Claude Code o cualquier entorno de desarrollo de IA. Despliega desde GitHub en un entorno de ejecución en la nube administrado con control MCP de primer nivel, registros y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- Crypto.com Exchange (operado por Foris DAX Limited, Islas Caimán)
- Tipo de plataforma
- Exchange de criptomonedas centralizado
- Clase de activo
- Cripto (spot, derivados perpetuos, margen)
- Productos compatibles
- Spot, derivados perpetuos, margen. Los derivados son ofrecidos por filiales de Crypto.com con licencias independientes y están sujetos a restricciones geográficas (las jurisdicciones excluidas incluyen Estados Unidos, Reino Unido, Singapur y aproximadamente otras 110 según la lista del centro de ayuda de Crypto.com).
- Modelo de ejecución
- Entorno de ejecución de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones habituales
- API nativa de Crypto.com Exchange v1, CCXT (`cryptocom`), FIX 4.4 (GEN 3.0, institucional), clientes HTTP / WebSocket personalizados
- Integración con flujos 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 Crypto.com Exchange
- Cuenta del exchange, emisión de claves API, acceso al mercado, plataforma de ejecución, custodia
- Afiliación
- TradingHost es independiente y no está afiliado a Crypto.com, Foris DAX Limited ni a ninguna entidad del grupo Crypto.com.
Sección 02 · Qué ofrece Crypto.com Exchange
Qué ofrece Crypto.com Exchange
Crypto.com Exchange ofrece trading de spot, derivados perpetuos y margen a través de una API v1 unificada que expone interfaces REST, WebSocket y FIX 4.4. Las estrategias se autentican con claves API firmadas con HMAC-SHA256; las jerarquías de cuentas principales y subcuentas son nativas, y un entorno de pruebas (UAT) independiente está alojado en `uat-api.3ona.co`. Los detalles de los endpoints cambian con el tiempo. La estructura general es estable; las cuotas precisas de límites de frecuencia, los códigos de error y las listas de instrumentos `-PERP` se encuentran en la documentación de Crypto.com.
Mercados y patrones de estrategia
- Creación de mercado (market making) en spot para pares de CRO y stablecoins
- Captura de base y tasa de financiación (funding rate) en instrumentos `-PERP`
- Arbitraje cruzado entre spot y perpetuos (misma plataforma, dos tipos de productos)
- Ejecución direccional financiada con margen con riesgo aislado por subcuenta
- Orquestación de órdenes condicionales (trigger), TP y SL mediante Advanced Order Management (posterior a enero de 2026) a través de `private/advanced/create-order`
- Ejecución etiquetada con `broker_id` para estrategias de reembolso de comisiones (fee-rebate)
- Flujo sensible a la latencia a través de FIX 4.4 para mesas institucionales
- Distribución multiestrategia bajo una sola cuenta principal utilizando el aislamiento de subcuentas
Interfaz de la API
- Áreas de producto
- Spot, derivados perpetuos y margen a través de la API unificada Exchange v1. Los productos de staking, Earn y ahorro no son aptos para el trading algorítmico. El entorno de pruebas (sandbox) está disponible en uat-api.3ona.co / uat-stream.3ona.co con claves independientes.
- Métodos de conexión
- REST y WebSocket. La API anterior Derivatives v1 se ha integrado en Exchange v1; Spot v2.1 era una generación previa. WebSocket se ejecuta en dos flujos: API de usuario en `wss://stream.crypto.com/exchange/v1/user` y datos de mercado en `wss://stream.crypto.com/exchange/v1/market`. Endpoint FIX 4.4 (GEN 3.0) para cuentas institucionales.
- Autenticación
- HMAC-SHA256 sobre `method + id + api_key + parameter_string + nonce`, firmado con el secreto de la API. Jerarquía de cuenta principal/subcuenta a través de `private/get-accounts`. Lista blanca de IP opcional por clave (obligatoria para claves con permisos de trading o retiro).
Para detalles específicos, consulta Crypto.com
Los endpoints específicos, las cuotas de límites de frecuencia, las listas de instrumentos, los niveles de comisiones y el historial de versiones se encuentran en la documentación de Crypto.com. Considéralos como la fuente de verdad.
- exchange-docs.crypto.com/exchange/v1Referencia unificada de REST + WebSocket para Exchange v1
- exchange-docs.crypto.com/derivativesAPI de derivados (integrada en Exchange v1)
- help.crypto.com, API articleCreación de claves API, permisos y lista blanca de IP
- crypto.com/en/product-news/fixapiAnuncio de la API FIX para GEN 3.0
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para Crypto.com Exchange 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 de Crypto.com Exchange v1
Control directo sobre el comportamiento específico de Crypto.com Exchange, los datos de la cuenta y la lógica de ejecución de órdenes. Una única clave unificada sirve para spot, margen y derivados perpetuos; admite el etiquetado `broker_id` para flujos de reembolso de comisiones y los endpoints de Advanced Order Management para órdenes TP/SL y condicionales (trigger).
CCXT
Interfaz común entre Crypto.com Exchange y otros exchanges de criptomonedas. CCXT clasifica a `cryptocom` como certificado de nivel profesional (pro-tier) con soporte para spot, margen y swaps. Considera a CCXT como una capa de conveniencia; los endpoints de Advanced Order Management posteriores a enero de 2026 siguen el contrato nativo de Exchange v1.
FIX 4.4 (GEN 3.0)
Endpoint FIX institucional para mesas de operaciones sensibles a la latencia. Funciona en paralelo con las interfaces REST y WebSocket; el acceso está sujeto a la revisión de la cuenta institucional por parte de Crypto.com.
Cliente HTTP / WebSocket personalizado
Tu propio motor de trading interno o integración propietaria con Crypto.com Exchange a través de los endpoints públicos de REST y WebSocket.
Compatibilidad de frameworks con productos de Crypto.com Exchange
La cobertura varía según el framework. Tanto la API nativa de Crypto.com Exchange v1 como CCXT `cryptocom` abarcan spot, perpetuos y margen bajo una única clave unificada. Freqtrade no tiene soporte oficial para Crypto.com Exchange y solo accede a la plataforma a través de la compatibilidad genérica de CCXT, únicamente para spot. El conector `crypto_com` de Hummingbot se marcó como desactualizado tras la actualización de la API GEN 3 y no figura en la lista actual de exchanges de Hummingbot; para entornos de producción, se recomienda optar por la API v1 nativa o CCXT.
✓ soporte confirmado según la documentación oficial del framework. "no" indica que no está documentado oficialmente como compatible. "vía CCXT" indica que el framework solo accede a Crypto.com a través de la compatibilidad genérica de CCXT. "conector desactualizado" indica un conector existente que no se ha adaptado a las actualizaciones de la API de la plataforma. Los enlaces de flujos de trabajo apuntan a páginas en /workflows/ actualmente en desarrollo.
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
Crypto.com Exchange proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Crypto.com Exchange.
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 Crypto.com Exchange.
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
Vincula TradingHost a tu repositorio de estrategia existente, o haz un fork de un entorno de ejecución de TradingHost (CCXT o tu propia plantilla nativa para Crypto.com Exchange) para obtener una base funcional.
- PASO 03
Desplegar en un contenedor de TradingHost
Elige una región (EU o US-East), introduce las variables de entorno que necesita tu estrategia (claves API de Crypto.com Exchange, URL base para producción o UAT, etc.) y despliega. TradingHost compila tu contenedor a partir del repositorio y ejecuta tu estrategia en una infraestructura gestionada de Kubernetes. No es necesario instalar Docker de forma local.
- 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 Crypto.com Exchange
Aspectos críticos que surgen al ejecutar una estrategia de Crypto.com Exchange en un entorno en la nube con contenedores, los cuales no figuran en la documentación de Crypto.com ni en los archivos README de los frameworks. Cada punto a continuación está citado o parafraseado de la propia documentación de Crypto.com; las pautas de despliegue provienen de la experiencia de ejecutar estas estrategias en TradingHost.
01 · API migración
Lanzamiento de la API de Advanced Order Management (diciembre de 2025 a enero de 2026)
Crypto.com migró las órdenes condicionales (trigger) a `private/advanced/create-order` el 2025-12-17 08:00 UTC, y la creación y cancelación de órdenes Take Profit / Stop Loss se trasladó el 2026-01-28 08:00 UTC. El código que antes llamaba a `private/create-order` para TP/SL o trigger debe migrar al endpoint avanzado y a la suscripción `user.advanced.order`. Las estrategias que no se actualizaron antes de la transición perdieron la funcionalidad de órdenes condicionales.
02 · Diferenciación de plataformas
La API de Exchange no es la API de la App
Crypto.com opera dos plataformas distintas. Crypto.com Exchange (web, crypto.com/exchange) expone una API pública, documentada y firmada con HMAC; la Crypto.com App (monedero minorista) no dispone de una API pública de trading. Las claves de API generadas dentro de la App no se autenticarán en el Exchange y viceversa; este es el error de configuración inicial más común.
03 · Acceso a derivados
Restringido geográficamente y segmentado por entidades
Los derivados son operados por filiales de Crypto.com con licencias independientes (Foris DAX MT Limited a nivel internacional; Crypto.com Derivatives North America / CDNA en EE. UU.). Aproximadamente 110 jurisdicciones están excluidas de la plataforma internacional de derivados, incluidos EE. UU., el Reino Unido y Singapur. Las claves de API de spot no conceden automáticamente acceso al trading de derivados, incluso en cuentas de regiones elegibles.
04 · Límites de frecuencia
Cuotas por método y por canal
Las cuotas de REST por método son estrictas: `private/create-order`, `private/cancel-order` y `private/cancel-all-orders` están limitadas a 15 peticiones por cada 100 ms; `private/get-order-detail` a 30 por cada 100 ms; `private/get-trades` y `private/get-order-history` a 1 por segundo; todos los demás métodos privados a 3 por cada 100 ms. El servicio REST público es de 100 rps por IP. WebSocket: 150 rps en la User API, 100 rps en Market Data. Superar estos límites devuelve el código `42901` (HTTP 429).
05 · Ciclo de vida de WebSocket
Heartbeat de 30s, calentamiento de 1s
El servidor emite un heartbeat cada 30 segundos; el cliente debe responder con `public/respond-heartbeat` utilizando el `id` correspondiente en un plazo de 5 segundos o el socket se cerrará. Crypto.com recomienda explícitamente pausar la ejecución (sleep) durante 1 segundo entre la apertura del WebSocket y la primera petición para evitar límites de frecuencia al conectar. Códigos de finalización a gestionar: 1000 (normal), 1006 (anormal), 1013 (reinicio del servidor, requiere reconexión con backoff).
06 · Entornos
El sandbox de UAT está en un host independiente
Producción apunta a api.crypto.com y stream.crypto.com. El sandbox de UAT se encuentra en uat-api.3ona.co y uat-stream.3ona.co y utiliza claves de API independientes. Las estrategias deben leer las URL base desde variables de entorno en lugar de codificar de forma fija api.crypto.com, de lo contrario las ejecuciones en el sandbox apuntarán silenciosamente a producción.
07 · Errores de autenticación
Modos de fallo de nonce, firma e IP
Tres códigos de error predominan en los problemas de autenticación: `40101` (no autenticado, clave o firma incorrectas), `40102` (desviación del nonce de más de 60 segundos respecto a la hora del servidor) y `40103` (la IP de la petición no está en la lista blanca de la clave). Ejecutar un contenedor en una región cuya IP de salida difiere de la IP autorizada en la lista blanca es la causa más común de `40103` tras un despliegue.
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para Crypto.com Exchange son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Traders sistemáticos de criptomonedas
- Desarrolladores cuantitativos (quants)
- Usuarios de CCXT
- Equipos que migran de hosting 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 Crypto.com, Foris DAX Limited ni a ninguna entidad del grupo Crypto.com.
No. El código de su estrategia se conecta a Crypto.com Exchange y envía instrucciones según su propia lógica, permisos de cuenta y 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 Crypto.com Exchange lo proporciona Crypto.com. Usted es responsable de su cuenta de Crypto.com Exchange, los permisos de la API, las credenciales y el cumplimiento de los términos de Crypto.com.
No. TradingHost es el entorno de ejecución en la nube (runtime) 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 escribe o genera la estrategia por sí mismo (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 ejecuta su estrategia.
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 (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 basado en MCP desde IDE 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 es compatible con cualquier lenguaje que pueda ejecutarse dentro de un contenedor.
Sí. CCXT expone Crypto.com como el ID de exchange `cryptocom` y lo clasifica como certificado de nivel profesional (pro-tier) con funciones para spot, margen y swaps. Considere CCXT como una capa de conveniencia; la semántica de los límites de frecuencia y los endpoints de Advanced Order Management posteriores a enero de 2026 siguen el contrato nativo de Exchange v1. Consulte la página del 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. La jerarquía de cuenta principal y subcuentas de Crypto.com Exchange se adapta de forma natural a esto: cada estrategia puede dirigirse a su propia subcuenta bajo una única clave principal. 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, como CCXT, para obtener un proyecto listo para desplegar, o conectar su propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; 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 custodiar su clave de API ni su secreto. Consulte la sección de secretos de la plataforma para conocer el modelo completo de gestión.
No. Las estrategias nunca deberían necesitar permisos de retiro. Crypto.com exige la inclusión de direcciones IP en la lista blanca para las claves con permisos de trading o retiro; mantenga el alcance de retiro desactivado en las claves de su estrategia y gestione los retiros por separado.
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, 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 una visión completa.
Ambos. La interfaz de control de MCP funciona igual de bien desde agentes basados en CLI (Claude Code CLI, clientes MCP personalizados, llamadas MCP mediante scripts) 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 casos 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 acceder a la interfaz de logs y estado.
El error 40101 significa que la firma HMAC-SHA256, la clave o el orden de los parámetros firmados son incorrectos; vuelve a comprobar la cadena firmada `method + id + api_key + parameter_string + nonce` y la ordenación ascendente de las claves de los parámetros. El 40102 significa que tu nonce tiene un desfase de más de 60 segundos con respecto al reloj del servidor de Crypto.com; sincroniza NTP. El 40103 significa que la IP de tu solicitud no está en la lista blanca de la clave API; las claves de trading y retiro requieren una lista blanca de IPs. Consulta la sección de notas operativas anterior para ver la guía completa.
Crypto.com Exchange es la plataforma de trading con la API pública y documentada v1 que se utiliza para el trading algorítmico; con esto es con lo que se integra TradingHost. Crypto.com App es el monedero minorista y producto de consumo; no publica una API de trading. Las claves API se generan en la interfaz web de Exchange en User Center > API, no en la aplicación móvil.
La creación y cancelación de órdenes Take Profit y Stop Loss se trasladó de `private/create-order` a `private/advanced/create-order` el 2026-01-28 a las 08:00 UTC, después de que las órdenes de activación (trigger orders) se migraran el 2025-12-17 a las 08:00 UTC. Ahora las estrategias deben llamar al endpoint avanzado para órdenes condicionales y suscribirse a `user.advanced.order` para recibir actualizaciones de estado. Las órdenes límite y de mercado simples continúan en `private/create-order`.
En la plataforma internacional, la clave API unificada de Exchange v1 puede operar con spot, margen y perpetuos con una sola credencial, pero la habilitación de derivados subyacente está vinculada a la cuenta, no a la clave. Los derivados deben estar habilitados en la cuenta y esta debe encontrarse en una jurisdicción no excluida. En EE. UU., los derivados operan en una filial con licencia independiente (CDNA) que cuenta con su propio proceso de registro.
Freqtrade puede conectarse a Crypto.com a través de CCXT, pero no cuenta con soporte oficial por parte del equipo de Freqtrade. El conector `crypto_com` de Hummingbot está marcado como obsoleto desde la actualización de la API GEN 3 y no figura en la lista actual de exchanges de Hummingbot; considéralo no compatible y utiliza CCXT o la v1 nativa directamente.
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 más detalles sobre el enrutamiento y la proximidad.
No. TradingHost se centra en el entorno de ejecución (runtime) en producción y el despliegue. El backtesting corresponde a tu entorno de investigación, framework o AlgoBuilder.