Runtime nativo de IA para estrategias de trading en BitMEX
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
- Plataforma
- BitMEX
- Tipo de plataforma
- Exchange de criptomonedas (pionero en futuros perpetuos)
- Clase de activo
- Derivados de criptomonedas (swaps perpetuos y futuros)
- Productos compatibles
- Perpetuo inverso XBTUSD (cada contrato tiene un valor nominal de 1 USD), swaps perpetuos cotizados en USDT y BTC, dated futures y contratos tipo mercado de predicción sobre subyacentes seleccionados. Testnet disponible en testnet.bitmex.com. Los usuarios de EE. UU. están bloqueados mediante IP geolocation en las claves de API.
- 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 y WebSocket nativos de BitMEX, CCXT, conectores personalizados
- 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 BitMEX
- Cuenta de exchange, acceso a la API, acceso al mercado, plataforma de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a BitMEX.
Sección 02 · Qué ofrece BitMEX
Qué ofrece BitMEX
BitMEX fue pionero en los swaps perpetuos de criptomonedas y sigue siendo una plataforma exclusiva de derivados. XBTUSD es su perpetuo inverso insignia, donde cada contrato equivale a un valor nominal de 1 USD y se liquida en Bitcoin. Los perpetuos cotizados en USDT y BTC, junto con los dated futures, completan la oferta. Todas las cantidades de Bitcoin se denominan en XBt (satoshis) y todas las de USD en USDt; se requiere conversión en el lado del cliente. Los detalles de los endpoints cambian con el tiempo. La estructura general es estable; las especificaciones exactas de los contratos, los límites de tasa (rate limits) y los niveles de comisiones se encuentran en la documentación de BitMEX.
Mercados y patrones de estrategia
- Market making en el perpetuo inverso XBTUSD
- Estrategias de swaps perpetuos cotizados en BTC
- Estrategias de swaps perpetuos cotizados en USDT
- Trading de base y spreads de calendario en dated futures
- Carry de funding rate en perpetuos inversos
- Despliegues validados en testnet antes del lanzamiento en mainnet
- Transmisión de órdenes y posiciones mediante canales privados de WebSocket
- Arbitraje entre plataformas emparejado con mercados spot o de derivados ajenos a BitMEX
Interfaz de la API
- Áreas de producto
- Swaps perpetuos (inverso XBTUSD, cotizados en USDT, cotizados en BTC), dated futures y contratos tipo mercado de predicción sobre subyacentes seleccionados. La testnet en testnet.bitmex.com replica la interfaz de la API de producción con claves y saldos independientes.
- Métodos de conexión
- REST en https://www.bitmex.com/api/v1 para colocación de órdenes y consultas de cuenta. Transmisiones de WebSocket para datos de mercado en tiempo real, profundidad de libro y operaciones. Canales privados de WebSocket para eventos de cuenta, posiciones y órdenes.
- Autenticación
- Clave de API permanente y secreto por estrategia. Las solicitudes privadas se firman con HMAC-SHA256 sobre verb + path + nonce + body. El nonce puede ser una marca de tiempo en microsegundos de la época Unix o un valor de cabecera api-expires. Los usuarios de EE. UU. están bloqueados mediante IP geolocation en las claves de API; la creación de claves se realiza correctamente, pero los endpoints de trading rechazan el acceso.
- Denominación
- Todas las cantidades de Bitcoin se denominan en XBt (satoshis, 1 XBt = 0.00000001 XBT). Todas las cantidades de USD se denominan en USDt (1 USDt = 0.000001 USDT). Los contratos perpetuos XBTUSD tienen un valor nominal de 1 USD cada uno y se liquidan en Bitcoin. Se requiere conversión en el lado del cliente para representar o calcular en unidades estándar de BTC o USD.
Para más detalles, consulte BitMEX
Los endpoints específicos, las especificaciones de los contratos, los límites de tasa, los niveles de comisiones y el historial de versiones se encuentran en la documentación de BitMEX. Considéralos la fuente de información oficial.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para BitMEX 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 BitMEX
Control directo sobre el comportamiento específico de BitMEX, las denominaciones en XBt y USDt, y la lógica de ejecución de órdenes.
Hummingbot
Despliegues basados en framework utilizando la estructura de estrategia y el modelo de configuración de Hummingbot.
Conector personalizado
Tu propio motor de trading interno o integración propietaria con BitMEX.
Compatibilidad de frameworks con productos de BitMEX
BitMEX es una plataforma exclusiva de derivados: no hay columna de spot en la matriz. CCXT expone perpetuos y dated futures a través de la clase unificada bitmex; Hummingbot cubre swaps perpetuos a través de bitmex_perpetual; Freqtrade no incluye a BitMEX como exchange compatible. El acceso a la API nativa de BitMEX llega a todos los contratos que ofrece BitMEX.
✓ 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
BitMEX proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a BitMEX.
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 BitMEX.
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 runtime de framework de TradingHost (CCXT o Hummingbot) para obtener una base funcional.
- PASO 03
Desplegar en un contenedor de TradingHost
Elige una región (EU o US-East), proporciona las variables de entorno que necesita tu estrategia (clave API y secreto de BitMEX, etc.) y despliega. TradingHost compila tu contenedor desde el repositorio y ejecuta tu estrategia en una infraestructura gestionada de Kubernetes. No se 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 BitMEX
Problemas con los que te toparás al ejecutar una estrategia de BitMEX en un runtime en la nube basado en contenedores, que no aparecen en la documentación de BitMEX ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de BitMEX; la guía de despliegue proviene de la ejecución real de estas estrategias en TradingHost.
01 · Denominación en XBt
Todas las cantidades de Bitcoin están en satoshis (1 XBt = 0.00000001 XBT); USD en USDt (1 USDt = 0.000001 USDT)
Las respuestas de la API de BitMEX utilizan denominaciones no estándar. Los saldos de Bitcoin, los campos walletBalance, el margen de la posición y los valores nominales de las órdenes se expresan en XBt (satoshis), no en XBT. Los importes cotizados en USD están en USDt, seis decimales por debajo de USDT. Las estrategias que representen o calculen posiciones en unidades visibles para el usuario deben realizar la conversión en el lado del cliente. El error más común el día del lanzamiento es una estrategia que intenta dimensionar una posición de 0.1 BTC y en su lugar la dimensiona en 0.1 XBt porque se olvidó la conversión.
FuenteBitMEX API overview02 · Contrato XBTUSD
Cada contrato perpetuo XBTUSD tiene un nocional de 1 USD y se liquida en Bitcoin (inverse)
XBTUSD es un inverse perpetual: cada contrato representa 1 USD de exposición nocional, con el PnL y el margen liquidados en Bitcoin. Los cálculos del precio de liquidación se realizan en USD. Esto difiere de un perp lineal con margen en USDT, donde el tamaño del contrato escala con la cantidad de la moneda subyecente. Las estrategias que combinan diferentes plataformas deben codificar el multiplicador del contrato y la moneda de liquidación por instrumento, en lugar de asumir una estructura única para toda la cartera.
FuenteBitMEX API overview03 · Geobloqueo de EE. UU.
Los usuarios de EE. UU. están bloqueados mediante IP geolocation en las claves de API
BitMEX prohíbe a los traders basados en EE. UU. La restricción se aplica a nivel de clave API mediante IP geolocation: cualquier clave cuyo tráfico reciente se geolocalice en EE. UU. verá rechazados sus endpoints privados, independientemente del estado de verificación de la cuenta. Un entorno de ejecución de TradingHost en la región US-East con salida en EE. UU. será bloqueado para operar en BitMEX. Elige una región de TradingHost cuya geografía de salida sea coherente tanto con el acuerdo de usuario de BitMEX como con tus propias políticas de cumplimiento.
FuenteBitMEX API overview04 · Firma de nonce
Firma HMAC-SHA256 sobre verb + path + nonce + body; se prefiere api-expires en lugar de un nonce sin procesar
Las firmas REST de BitMEX son un HMAC-SHA256 de la concatenación verb + path + nonce + body, firmado con su clave secreta. El nonce puede ser una marca de tiempo Unix en microsegundos o, preferiblemente, una cabecera api-expires que otorga a la solicitud una marca de tiempo de expiración futura. El uso de api-expires evita el requisito estricto de un nonce estrictamente creciente y es más robusto frente al desfase horario entre contenedores. La mayoría de los SDK de BitMEX utilizan api-expires por defecto; verifique el suyo y fíjelo.
FuenteBitMEX API overview05 · Claves permanentes
Las claves de API son permanentes hasta que se revoquen manualmente; las claves de testnet están aisladas
Las claves de API de BitMEX no expiran automáticamente. La rotación es una responsabilidad manual: rote las claves periódicamente en lugar de confiar en una expiración de la plataforma. La red de pruebas en testnet.bitmex.com emite claves independientes, mantiene saldos separados y atiende a endpoints distintos; un fallo de autenticación silencioso muy común es subir a producción código validado en testnet sin cambiar el conjunto de claves, o viceversa. Guarde las credenciales secretas de testnet y producción en entradas de Secrets de TradingHost separadas; nunca las reutilice entre entornos.
06 · Límites de peticiones
Límite de peticiones REST por minuto en endpoints privados; se recomienda encarecidamente WebSocket para bucles de ejecución rápida
BitMEX limita las peticiones a los endpoints REST privados en una ventana por minuto. El patrón recomendado para estrategias activas es gestionar los datos de mercado y el estado de la cuenta mediante suscripciones WebSocket, y utilizar REST únicamente para las acciones que WebSocket no puede realizar (colocación y cancelación de órdenes). Realizar consultas REST continuas (polling) en un bucle rápido para obtener actualizaciones de la cartera de órdenes o del estado de las posiciones agotará la cuota y generará errores 429.
FuenteBitMEX API overview
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para BitMEX son ideales para:
- Desarrolladores que crean estrategias en IDE de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Desarrolladores quant
- Usuarios de CCXT y Hummingbot
- Mesas de negociación centradas en derivados y creadores de mercado de perpetuos
- Equipos que migran de alojamiento en 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 BitMEX.
No. El código de su estrategia se conecta a BitMEX 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 BitMEX lo proporciona BitMEX. Usted es responsable de su cuenta de BitMEX, los permisos de la API, las credenciales y el cumplimiento de los términos de servicio de BitMEX.
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 bots preconfigurados. 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, 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 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 (failover) 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 paneles 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í. 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 BitMEX a través de la clase unificada `bitmex`, que cubre perpetuos y dated futures. No hay ningún producto spot que soportar. Consulte el entorno de ejecución del framework CCXT para conocer todos los detalles de la configuración.
No. BitMEX prohíbe a los traders basados en EE. UU. La restricción se aplica a nivel de clave API mediante IP geolocation: cualquier clave cuyo tráfico reciente se geolocalice en EE. UU. verá rechazados sus endpoints privados, independientemente del estado de verificación de la cuenta. Un entorno de ejecución de TradingHost en la región US-East con salida en EE. UU. será bloqueado para operar en BitMEX. Elige una región de TradingHost cuya geografía de salida sea coherente tanto con el acuerdo de usuario de BitMEX como con tus propias políticas de cumplimiento.
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 o Hummingbot para 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 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 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 de API ni de su clave secreta de BitMEX. 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 (órdenes, lectura de cuenta) y rote las claves manualmente, ya que las claves de BitMEX no expiran automáticamente.
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 de 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 programadas) que desde el interior de un IDE. El ciclo de despliegue nativo de GitHub también funciona sin ninguna herramienta de IA: un simple git push a su rama principal activa un nuevo despliegue.
El runtime detecta el fallo y expone los logs y la información de estado pertinentes. En los casos compatibles, la estrategia afectada se puede reiniciar sin interrumpir a las demás estrategias que se ejecutan 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 acceder a la interfaz de logs y estado.
BitMEX denomina todos los importes de Bitcoin en XBt (satoshis). 1 XBt = 0.00000001 XBT, por lo que un saldo de 100.000.000 XBt equivale a 1 BTC. Los importes en USD se expresan en USDt, seis decimales por debajo de USDT. El error más común el día del despliegue es una estrategia diseñada para operar en BTC que termina operando en XBt porque se olvidó realizar la conversión. Los contratos perpetuos XBTUSD tienen un valor nocional de 1 USD cada uno y se liquidan en Bitcoin. Consulte la sección de notas operativas anterior para obtener la guía completa.
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) en producción y el despliegue. El backtesting corresponde a su entorno de investigación, framework o AlgoBuilder.