Runtime nativo de IA para estrategias de trading en WhiteBIT
Desarrolla en Cursor, Claude Code o cualquier IDE de IA. Despliega desde GitHub en un runtime en la nube gestionado con control MCP de primer nivel, logs y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- WhiteBIT
- Tipo de plataforma
- Exchange de criptomonedas (global)
- Clase de activo
- Cripto
- Productos compatibles
- Spot, futuros perpetuos, margen aislado. Límites de tasa escalonados por endpoint; sin testnet pública (las pruebas de integración se realizan en la API real con tamaños mínimos de orden).
- Modelo de ejecución
- Runtime de estrategias en contenedores
- Origen del despliegue
- GitHub
- Lenguajes
- Cualquier lenguaje que se ejecute en un contenedor
- Integraciones habituales
- APIs nativas REST y WebSocket de WhiteBIT, 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 WhiteBIT
- Cuenta de exchange, acceso a la API, acceso al mercado, lugar de ejecución
- Afiliación
- TradingHost es independiente y no está afiliado a WhiteBIT
Sección 02 · Qué ofrece WhiteBIT
Qué ofrece WhiteBIT
WhiteBIT ofrece spot, futuros perpetuos y margen aislado a través de APIs REST y WebSocket con límites de tasa escalonados por endpoint. Una realidad operativa importante: no existe una testnet pública, por lo que las pruebas de integración se realizan contra la API real utilizando tamaños mínimos de orden. El copy trading, el auto-invest y el staking son exclusivos de la plataforma y no tienen acceso a la API. Las especificaciones de los endpoints cambian con el tiempo. La estructura general es estable; los límites de tasa precisos, las listas de símbolos y los niveles de comisiones se encuentran en la documentación de WhiteBIT.
Mercados y patrones de estrategia
- Trading spot en pares con cotización en USDT, BTC y ETH
- Estrategias de futuros perpetuos
- Estrategias de margen aislado
- Suscripción WebSocket de hasta 200 mensajes por minuto por conexión
- Gestión de límites de tasa escalonados por endpoint
- Pruebas de integración en la API real (sin testnet pública disponible)
- Flujo de transferencia de saldo entre las cuentas Main Balance y Trade Balance
- Estrategias basadas en API que evitan funciones exclusivas de la plataforma (copy trading, auto-invest)
Interfaz de la API
- Áreas de producto
- Spot, futuros perpetuos y margen aislado. El copy trading, el auto-invest y el staking existen en WhiteBIT, pero son exclusivos de la plataforma (sin acceso a la API). Las estrategias que dependan de estas funciones requieren intervención humana.
- Métodos de conexión
- API REST para colocación de órdenes y consultas de cuenta con límites de tasa escalonados por endpoint: Main Balance 1,000 solicitudes cada 10 segundos, Trade Balance 12,000 cada 10 segundos, creación de órdenes 10,000 cada 10 segundos, mercados públicos 2,000 cada 10 segundos. WebSocket permite hasta 1,000 conexiones simultáneas por minuto con 200 mensajes por minuto por conexión individual.
- Autenticación
- Clave API y secreto por estrategia con solicitudes firmadas mediante HMAC. Los permisos se pueden limitar por clave. Las suscripciones WebSocket a canales privados requieren un flujo de renovación de token que debe gestionar el cliente.
Para más detalles, consulte WhiteBIT
Los endpoints específicos, los pesos de los límites de tasa, las listas de símbolos, los niveles de comisiones y el historial de versiones se encuentran en la documentación de WhiteBIT. Considéralos como la fuente de verdad.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para WhiteBIT 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 WhiteBIT
Control directo sobre el comportamiento específico de WhiteBIT, los flujos de transferencia de saldo y los límites de tasa escalonados.
CCXT
Interfaz común para WhiteBIT y otros exchanges de criptomonedas. CCXT expone WhiteBIT a través de la clase unificada `whitebit` para el trading spot.
Freqtrade o Hummingbot
Ninguno de los dos frameworks incluye actualmente a WhiteBIT como un exchange con soporte nativo de primer nivel. Las implementaciones personalizadas o basadas en CCXT son la vía documentada.
Conector personalizado
Tu propio motor de trading interno o integración propietaria de WhiteBIT contra las APIs REST y WebSocket.
Compatibilidad de frameworks con productos de WhiteBIT
La cobertura varía según el framework. CCXT expone el mercado spot de WhiteBIT a través de su clase unificada `whitebit`; la cobertura de futuros y margen en CCXT es parcial. Ni Freqtrade ni Hummingbot incluyen actualmente a WhiteBIT como un exchange con soporte nativo de primer nivel. El acceso a la API nativa permite llegar a todo lo que publica WhiteBIT, incluidos los futuros y el margen aislado.
✓ soporte confirmado según la documentación oficial del framework. "no" indica que no está documentado oficialmente como compatible. "parcial" indica cobertura limitada. Los enlaces de flujos de trabajo dirigen a páginas /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
WhiteBIT proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a WhiteBIT.
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 WhiteBIT.
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 a tu repositorio de estrategia existente, o haz un fork de un runtime de framework de TradingHost (CCXT) para obtener una base funcional contra las APIs REST y WebSocket de WhiteBIT.
- PASO 03
Desplegar en un contenedor de TradingHost
Selecciona una región (EU o US-East), introduce las variables de entorno que requiere tu estrategia (clave API y secreto de WhiteBIT, configuración de transferencia de saldo) 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 WhiteBIT
Detalles que pueden complicarte la vida al ejecutar una estrategia de WhiteBIT en un runtime en la nube basado en contenedores, y que no aparecen en la documentación de WhiteBIT ni en los archivos README de los frameworks. Cada afirmación a continuación es una paráfrasis de la propia documentación de WhiteBIT; la guía de despliegue proviene de la ejecución de estas estrategias en TradingHost.
01 · Sin testnet
WhiteBIT no tiene testnet pública; las pruebas de integración se realizan en la API real
WhiteBIT no ofrece una testnet pública. Todas las pruebas de integración se realizan contra la API de producción real con activos reales y tamaños mínimos de orden. Esta es una brecha operativa importante en comparación con Binance, Coinbase o Bybit, que disponen de entornos de prueba seguros para la validación previa al despliegue. El enfoque correcto consiste en configurar una cuenta secundaria o subcuenta con saldo reducido para las pruebas iniciales, utilizar el tamaño de orden mínimo permitido y desplegar el código con las protecciones habituales (claves de idempotencia, límites de posición máxima, botón de parada de emergencia) desde el primer día, en lugar de esperar al primer incidente.
FuenteWhiteBIT API reference02 · Límites de tasa escalonados
Límites de tasa por endpoint: Main Balance 1k/10s, Trade Balance 12k/10s, creación de órdenes 10k/10s, público 2k/10s
WhiteBIT aplica límites de tasa por endpoint en lugar de un único presupuesto global. Endpoints de Main Balance: 1.000 solicitudes por cada 10 segundos. Endpoints de Trade Balance: 12.000 por cada 10 segundos. Endpoint de creación de órdenes: 10.000 por cada 10 segundos. Endpoints de mercado público: 2.000 por cada 10 segundos. Una estrategia que sature una familia de endpoints no agota el presupuesto de otra, pero sí consume su propio límite rápidamente. Codifique el presupuesto por clase de endpoint en su wrapper de cliente en lugar de rastrear un único contador global.
FuenteWhiteBIT API reference03 · Límites de WebSocket
1.000 conexiones concurrentes por minuto; 200 mensajes por minuto por conexión individual
La capa de WebSocket de WhiteBIT limita el rendimiento general a 1.000 intentos de conexión concurrente por minuto y 200 mensajes por minuto por cada conexión abierta de forma individual. Una estrategia que se suscriba a muchos canales privados en una sola conexión puede alcanzar el límite por conexión antes de que el libro de órdenes se haya suscrito por completo. El patrón adecuado para despliegues multiestrategia es una conexión WebSocket por estrategia con su propio presupuesto de mensajes, en lugar de una conexión compartida enrutada a múltiples consumidores. La renovación del token en canales privados es responsabilidad del cliente; si se pierde el token, la suscripción se cae de forma silenciosa.
FuenteWhiteBIT API reference04 · Códigos de transferencia de saldo
Error 1 = disabled from-trade, 2 = disabled from-main, 3 = insufficient
WhiteBIT divide los saldos entre las cuentas Main y Trade. Las estrategias que colocan órdenes contra el saldo de Trade pero leen el saldo de Main para su financiación deben llamar al endpoint de transferencia de saldo. El endpoint de transferencia devuelve tres códigos de error específicos que vale la pena conocer de memoria: el error 1 significa que las transferencias desde Trade están deshabilitadas (normalmente por una configuración a nivel de cuenta), el error 2 significa que las transferencias desde Main están deshabilitadas y el error 3 significa saldo insuficiente. Ninguno de los tres es recuperable mediante reintentos; requieren una solución a nivel de cuenta o una decisión estratégica diferente.
05 · Funciones exclusivas de la plataforma
El copy trading, el auto-invest y el staking no tienen acceso a la API
WhiteBIT ofrece copy trading, planes de auto-invest y staking, pero las tres son funciones exclusivas de la plataforma sin acceso a la API. Las estrategias que se integran con WhiteBIT no pueden suscribirse mediante programación a un líder de copy-trade, configurar un plan de auto-invest ni realizar staking de saldos. El patrón adecuado es tratar estos procesos como flujos de trabajo manuales externos que los usuarios configuran en la interfaz de usuario de WhiteBIT, y hacer que el código de la estrategia lea el saldo resultante y el estado de las órdenes a través de la API.
FuenteWhiteBIT API reference06 · Tamaño mínimo de orden
Se aplican tamaños mínimos por par en la integración real; consulte antes de realizar pruebas
Debido a que no hay testnet, las primeras órdenes que coloca una estrategia son con dinero real contra liquidez real. Se aplican tamaños mínimos de orden por par, y desplegar una estrategia que envíe órdenes por debajo del mínimo hará que se rechacen todas las solicitudes. Consulte el endpoint de tamaño mínimo al iniciar, almacene en caché los valores por símbolo y valide cada orden saliente contra el mínimo almacenado en caché antes de enviarla. Vuelva a consultar la caché periódicamente, ya que WhiteBIT updates los mínimos según las condiciones del mercado.
FuenteWhiteBIT API reference
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para WhiteBIT 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 WhiteBIT.
No. El código de su estrategia se conecta a WhiteBIT y envía instrucciones de acuerdo con 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 WhiteBIT lo proporciona WhiteBIT. Usted es responsable de su cuenta de WhiteBIT, los permisos de la API, las credenciales y el cumplimiento de los términos de WhiteBIT.
No. TradingHost es el entorno de ejecución (runtime) 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 su estrategia.
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 el monitoreo 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 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 directo.
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 incluye una clase unificada `whitebit` que cubre el trading de spot. La cobertura de futuros y margen en CCXT es parcial. Coloque su estrategia de CCXT en un contenedor, conéctela a GitHub y TradingHost la ejecutará como cualquier otro proyecto de Python o Node. Consulte el entorno de ejecución del framework CCXT para ver todos los detalles de configuración.
Sí. Se puede acceder a los futuros perpetuos a través de la API de WhiteBIT una vez que su cuenta sea elegible. TradingHost es independiente de la plataforma de negociación a nivel de entorno de ejecución: cualquier código que pueda autenticarse contra los endpoints de futuros puede ejecutarse dentro de un contenedor. Tenga en cuenta que el copy trading, el auto-invest y el staking son funciones exclusivas de la plataforma sin acceso a la API; las estrategias no pueden suscribirse mediante programación a un líder de copy-trade ni configurar un plan de auto-invest.
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. Específicamente para WhiteBIT, se recomienda utilizar una conexión WebSocket por estrategia para que cada una tenga su propio límite de 200 mensajes por minuto por conexión, en lugar de compartirlo. 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 para un proyecto listo para desplegar. O bien, conecte su propio repositorio de estrategia de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de 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 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 de gestión completo.
No. Las estrategias nunca deberían necesitar permisos de retiro. Limite el alcance de su clave de API únicamente a operaciones de trading y lectura del estado de la cuenta, y mantenga los retiros completamente desactivados en la clave.
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 MCP funciona igual de bien desde agentes basados en CLI (CLI de Claude Code, 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 entorno de ejecución detecta el fallo y expone los registros y la información de estado pertinentes. 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 el panel de registros y estado.
WhiteBIT no ofrece una testnet pública. Todas las pruebas de integración se realizan directamente en la API de producción real con activos reales y tamaños de orden mínimos. El enfoque correcto consiste en destinar una cuenta independiente con saldo reducido o una subcuenta para las pruebas del primer despliegue, utilizar el tamaño de orden mínimo permitido e implementar el código con medidas de seguridad estándar (claves de idempotencia, controles de posición máxima, kill switch) desde el primer día, en lugar de esperar a que ocurra el primer incidente. Consulta la sección de Notas operativas más arriba para ver la guía completa.
TradingHost se ejecuta en las regiones EU y US-East. Selecciona la región más cercana al motor de emparejamiento del que depende tu estrategia. Consulta la página de regiones para obtener detalles sobre enrutamiento y proximidad.
No. TradingHost se centra exclusivamente en el entorno de ejecución (runtime) y el despliegue en producción. El backtesting debe realizarse en tu entorno de investigación, framework o AlgoBuilder.