Runtime nativo de IA para estrategias de trading en Bybit
Desarrolle en Cursor, Claude Code o cualquier AI IDE. Despliegue 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
- Bybit
- Tipo de plataforma
- Exchange de criptomonedas (enfocado en derivados)
- Clase de activo
- Cripto (spot, perpetuos lineales e inversos, futuros de USDC, opciones, spread)
- Productos compatibles
- Spot, perpetuos de USDT, perpetuos de USDC, futuros de USDT, futuros de USDC, perpetuos inversos, futuros inversos, opciones de USDC de estilo europeo, spread trading, estrategias de copia, demo trading. Disponible a través de UTA 2.0 (predeterminado para cuentas registradas desde 2025); UTA 1.0 sigue activo para usuarios heredados. Ya no se ofrecen cuentas Classic.
- 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 Bybit v5, CCXT, Freqtrade, Hummingbot, personalizado
- 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
- Runtime, despliegue, logs, comprobaciones de estado, selección de región, control MCP
- Rol de Bybit
- Cuenta de exchange, acceso a la API, acceso al mercado, plataforma de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a Bybit
Sección 02 · Qué ofrece Bybit
Qué ofrece Bybit
La API v5 de Bybit unifica spot, perpetuos lineales e inversos, futuros de USDT y USDC, y opciones de USDC de estilo europeo bajo un único parámetro `category`, con Spread Trading y Demo Trading como superficies adicionales. Bajo UTA 2.0, cada categoría comparte un único pool de margen cruzado de productos. Las estrategias se autentican con claves HMAC-SHA256 (emitidas por el sistema) o RSA-SHA256 (autoemitidas) y se conectan a la plataforma a través de REST o WebSocket. Mainnet, testnet y la demo de mainnet son tres entornos distintos con espacios de nombres de claves disjuntos. Los detalles de los endpoints cambian con el tiempo. La estructura es duradera; los límites de velocidad precisos, los niveles de comisiones y las listas de símbolos se encuentran en la documentación de Bybit.
Mercados y patrones de estrategia
- Market making de perpetuos de USDT
- Arbitraje de base y carry de perpetuos de USDC
- Cobertura con margen de criptomoneda (coin-margined) de perpetuos inversos
- Gamma scalping de opciones (liquidadas en USDC, Portfolio Margin)
- Arbitraje de tasas de financiación a través del libro de órdenes de Spread Trading
- Estrategias de copia mediante automatización de Master Trader
- Estrategias de margen de cartera de productos cruzados en UTA 2.0
- Pruebas de simulación (dry-runs) en demo-trading antes del despliegue en mainnet
Interfaz de la API
- Áreas de producto
- Categorías unificadas de v5 (`spot`, `linear`, `inverse`, `option`), además de los endpoints de Spread Trading y Demo Trading. UTA 2.0 unifica todas las categorías bajo un único pool de margen. Mainnet, testnet (api-testnet.bybit.com) y la demo de mainnet (api-demo.bybit.com) son tres entornos distintos con espacios de nombres de claves disjuntos.
- Métodos de conexión
- REST v5 (HTTPS), WebSocket público (datos de mercado), WebSocket privado (órdenes, ejecuciones, posiciones, billetera), WebSocket trade (entrada de órdenes a través de WS, solo en mainnet).
- Autenticación
- HMAC-SHA256 (claves emitidas por el sistema) o RSA-SHA256 (claves autoemitidas). Cabeceras requeridas: `X-BAPI-API-KEY`, `X-BAPI-TIMESTAMP`, `X-BAPI-SIGN`, `X-BAPI-RECV-WINDOW` (por defecto 5000 ms). Soporta jerarquía de subcuentas y listas blancas de IP por clave. El acceso a la API desde IPs de EE. UU. o China continental devuelve HTTP 403.
Para más detalles, consulte Bybit
Los endpoints específicos, los límites de velocidad, las listas de símbolos, los niveles de comisiones y el historial de versiones se encuentran en la documentación de Bybit. Considere esta información como la fuente de verdad.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para Bybit con IA
Elija un método de integración, haga un fork de una plantilla de framework 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. La superficie de productos basada en categorías de la v5 de Bybit y el margen cruzado de productos de UTA 2.0 permiten que una sola estrategia acceda a spot, perpetuos, futuros y opciones a través de una única cuenta unificada.
API nativa de Bybit
Control directo sobre el comportamiento específico de Bybit, los datos de la cuenta y la lógica de ejecución de órdenes a través de la API unificada v5.
Freqtrade o Hummingbot
Despliegues basados en frameworks utilizando su estructura de estrategia y modelo de configuración.
Conector personalizado
Su propio motor de trading interno o integración propietaria con Bybit.
Compatibilidad de frameworks con productos de Bybit
La cobertura varía según el framework. CCXT y la API v5 nativa abarcan toda la superficie de Bybit; Freqtrade cubre spot y perpetuos lineales (se recomienda una subcuenta por bot); Hummingbot cubre spot y perpetuos con soporte parcial para inversos (un modo a la vez).
✓ soporte confirmado según la documentación oficial del framework. "partial" indica que está documentado pero con limitaciones (por ejemplo, un modo a la vez). "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
Bybit proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Bybit.
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 Bybit.
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 (claves de API de Bybit, etc.) y despliega. TradingHost construye tu contenedor desde el repositorio y ejecuta tu estrategia en una infraestructura gestionada de Kubernetes. No requiere una 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 Bybit
Problemas reales que surgen al ejecutar una estrategia de Bybit en un runtime en la nube en contenedores, que no figuran en la documentación de Bybit ni en los archivos README de los frameworks. Cada afirmación a continuación es una cita o paráfrasis de la propia documentación de Bybit; la guía de despliegue proviene de la experiencia de ejecutar estas estrategias en TradingHost.
01 · Unificación de v5
La API v5 unifica categorías; v3 se retiró en agosto de 2024
La API v5 de Bybit unifica spot, perpetuos lineales, perpetuos inversos y opciones bajo un único parámetro `category`. La transición oficial de v3 a v5 retiró los endpoints de v3 el 31 de agosto de 2024. Ejecute todo el código nuevo contra v5; v3 devuelve errores.
02 · Entornos
Mainnet, testnet y la demo de mainnet son tres hosts diferentes
Mainnet utiliza api.bybit.com y stream.bybit.com. Testnet utiliza api-testnet.bybit.com y stream-testnet.bybit.com. La demo de mainnet utiliza api-demo.bybit.com y wss://stream-demo.bybit.com para flujos privados (los datos de mercado públicos siguen proviniendo de mainnet). Las claves no se comparten entre entornos; una clave de demo contra el host de testnet devuelve el error 10003. WS Trade (entrada de órdenes a través de WebSocket) no está disponible en la demo.
03 · Modo de cuenta
UTA 2.0 vs. UTA 1.0 vs. Classic heredado
Han existido tres modos de cuenta: Classic (ya no se ofrece), UTA 1.0 (spot unificado con derivados y opciones de USDT/USDC; inverse sigue separado) y UTA 2.0 (cada category comparte un único pool de margen con margen cruzado o de cartera). Las cuentas registradas en 2025 o más tarde son UTA 2.0 por defecto. La actualización a UTA es irreversible; en UTA 2.0 los futuros inverse ya no admiten el modo de cobertura.
FuenteBybit v5 account modes04 · Límites de peticiones
Ventana flotante por UID y por category
Los límites de v5 se aplican mediante una ventana flotante por UID y se dividen por category. La creación de órdenes es de 20/s para spot y linear, y de 10/s para inverse y option; la modificación es de 10/s en las cuatro; la cancelación replica los límites de creación. El límite a nivel de IP es de 600 peticiones HTTP por ventana de 5 segundos. Los endpoints por lotes (batch) consumen por orden, no por petición, con límites de 10 (spot) y 20 (linear / inverse / option) por lote. Las cabeceras de respuesta muestran el cupo restante.
FuenteBybit v5 rate limits05 · Historial de seguridad
Incidente de Lazarus de febrero de 2025: qué cambió
El 21 de febrero de 2025, atacantes vinculados al Lazarus Group de Corea del Norte (TraderTraitor) robaron aproximadamente 1500 millones de dólares en ETH de un monedero frío de Bybit al comprometer la estación de trabajo de un desarrollador en el proveedor externo de multifirma Safe{Wallet} y manipular la interfaz de usuario del firmante. El FBI confirmó la atribución en el IC3 PSA-250226. Bybit siguió operativo: los retiros continuaron, la auditoría de Proof of Reserves de Hacken confirmó reservas superiores al 100% en BTC, ETH, SOL, USDT y USDC, y Bybit declaró públicamente que los fondos de los usuarios no se vieron afectados. Posteriormente, Bybit aisló la infraestructura de firma, rediseñó los flujos multifirma, auditó las herramientas de terceros, añadió detección de anomalías en las transferencias y continúa realizando mensualmente el Merkle-tree PoR con Hacken. Para los usuarios de la API, esto es contexto histórico: la postura cambió, pero la superficie de exposición no.
06 · Restricciones regionales
EE. UU. y China continental bloqueados en el extremo de la API
La guía de v5 establece explícitamente que las direcciones IP ubicadas en EE. UU. o China continental devuelven un error 403 Forbidden. Existen nombres de host regionales para los Países Bajos, Turquía, Kazajistán, Georgia, Emiratos Árabes Unidos, el EEE e Indonesia. El KYC es obligatorio y las identidades de residentes en EE. UU. se bloquean en la verificación incluso si la IP es válida. Al configurar el entorno de ejecución de TradingHost para operar en Bybit, se deben evitar las regiones de EE. UU.
07 · Errores comunes
Códigos de autenticación y límite de peticiones a instrumentar
El error 10003 invalid api_key suele significar un entorno incorrecto (una clave de mainnet apuntando al host de testnet o una clave de demo apuntando a mainnet). El error 10004 invalid sign indica un desfase de reloj superior a `recv_window`, o que el payload de la firma se estructuró en el orden incorrecto. El error 10018 exceed IP rate limit señala que se ha superado el límite de 600 peticiones por cada 5 segundos; reduzca el ritmo de peticiones utilizando `X-Bapi-Limit-Reset-Timestamp`. Trate los errores 10003 y 10004 como alertas de parada inmediata, no de reintento.
FuenteBybit v5 error codes08 · Spread Trading
Spread Trading utiliza un libro de órdenes independiente
Spread Trading admite combinaciones Spot/Perp, Spot/Expiry, Perp/Expiry y Expiry/Expiry en BTC, ETH y SOL con su propio libro de órdenes y comisiones un 50% más bajas en comparación con la ejecución manual de cada pata. En la documentación de v5 figura como una funcionalidad destacada en lugar de como una `category` documentada; dirija las peticiones a través de las referencias de endpoints del centro de ayuda al realizar la integración.
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para Bybit son ideales para:
- Desarrolladores que crean estrategias en entornos de desarrollo de IA (Cursor, Claude Code)
- Traders sistemáticos de criptomonedas
- Desarrolladores cuantitativos (quants)
- Usuarios de CCXT, Freqtrade y Hummingbot
- 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 Bybit.
No. El código de su estrategia se conecta a Bybit 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 Bybit lo proporciona Bybit. Usted es responsable de su cuenta de Bybit, los permisos de la API, las credenciales y el cumplimiento de los términos de Bybit.
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 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 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 regional y la monitorizació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 de GitHub, control basado en MCP desde entornos de desarrollo de IA, y paneles de registro 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.
Sí. El exchange bybit de CCXT cubre spot, perpetuos linear e inverse, futuros de USDT y USDC, y opciones de USDC contra v5. Despliegue su estrategia de CCXT desde GitHub en un entorno de ejecución de TradingHost; nosotros la ejecutamos y usted conserva sus claves. Consulte el entorno de ejecución del framework CCXT para ver todos los detalles de configuración.
Sí, siempre que su proyecto esté diseñado de esa manera. Puede ejecutar múltiples procesos o servicios de estrategia dentro de un único 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 gratuito; 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 la custodia de su clave de API ni de 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. Utilice permisos con alcance limitado y listas blancas de IP por clave cuando corresponda, y mantenga el alcance de los retiros en una clave independiente gestionada manualmente.
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 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 superficie 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 ninguna herramienta de IA: un simple git push a tu rama main activa un nuevo despliegue.
El runtime detecta el fallo y expone los logs y la información de estado correspondientes. En los casos compatibles, la estrategia afectada se puede reiniciar sin interrumpir otras estrategias que se estén ejecutando 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 ver los logs y la interfaz de estado.
Casi todos los errores 10004 se deben a tres causas: la marca de tiempo de la solicitud está fuera de la ventana de recv_window (por defecto, 5000 ms) debido al desfase del reloj, el payload de la firma se ha estructurado con los parámetros en un orden incorrecto, o se ha utilizado accidentalmente el formato de payload HMAC con una clave RSA (o viceversa). Sincroniza el reloj de tu runtime o consulta la hora del servidor de Bybit antes de firmar. Consulta la sección de Notas operativas anterior para obtener la guía completa.
Bybit opera tres entornos con espacios de nombres de claves independientes: mainnet, testnet (api-testnet.bybit.com) y demo de mainnet (api-demo.bybit.com). Una clave generada en cualquiera de ellos devolverá el error 10003 en los otros dos. Genera una nueva clave desde el panel de control correspondiente.
Las cuentas abiertas en 2025 o posteriormente utilizan UTA 2.0 por defecto. Si estás en Classic o UTA 1.0 y quieres margen cruzado entre productos, actualiza. La actualización es irreversible y los futuros inversos pierden el modo de cobertura. Haz pruebas primero en el entorno demo.
No. Bybit bloquea las IPs de EE. UU. y China continental en el borde de la API con una respuesta 403, y el proceso de KYC rechaza a los residentes en EE. UU. TradingHost no puede eludir esta restricción; es una limitación impuesta por Bybit.
El incidente fue real, de gran alcance y está bien documentado (FBI IC3 PSA-250226). Las operaciones en caliente, los retiros y los saldos de los clientes de Bybit no se vieron afectados; la auditoría de Proof of Reserves de Hacken con fecha del 26 de febrero confirmó reservas superiores al 100 % en los principales activos. Desde entonces, Bybit ha aislado la infraestructura de firma, ha rediseñado los flujos multifirma y continúa realizando pruebas de Merkle-tree PoR mensuales. Para un usuario de estrategias algorítmicas, esto es contexto operativo, no un impedimento actual para la API, pero trata el riesgo de custodia del exchange como algo real y gestiona el tamaño de tus posiciones en consecuencia.
TradingHost se ejecuta en las regiones EU y US-East. Elija la región más cercana al motor de emparejamiento del que dependa su estrategia. Tenga en cuenta que Bybit bloquea las direcciones IP de EE. UU. en el extremo de su API, por lo que las estrategias de Bybit no deben enrutarse desde la región US-East. Consulte 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.