Entorno de ejecución nativo de IA para estrategias de trading en Gate.io
Desarrolla en Cursor, Claude Code o cualquier entorno de desarrollo de IA. Despliega desde GitHub en un entorno de ejecución gestionado en la nube con control MCP nativo, registros y selección de región.
Sección 01 · De un vistazo
De un vistazo
- Plataforma
- Gate.io (también comercializado como Gate.com desde su cambio de marca en 2024, aunque Gate.io se sigue usando activamente en referencias de API y SDK)
- Tipo de plataforma
- Exchange de criptomonedas (spot, margen, perpetuos con margen en USDT/BTC, futuros de entrega física, opciones, copy trading, préstamos)
- Clase de activo
- Criptomonedas
- Productos compatibles
- Spot (más de 4600 activos), margen cruzado e aislado (~470 activos, hasta 10x), perpetuos con margen en USDT, perpetuos con margen en BTC, futuros de entrega física, opciones sobre BTC/ETH/principales activos seleccionados (vencimientos cortos de 1h/4h/24h y vencimientos estándar), copy trading, préstamos. Apalancamiento máximo en derivados de hasta 125x.
- 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
- Gate API v4 nativa (REST + WebSocket), CCXT (ID de exchange `gate`), Freqtrade (spot + futuros perpetuos), Hummingbot (conectores `gate_io` y `gate_io_perpetual`), personalizada
- 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, inyección de secretos, control MCP
- Rol de Gate.io
- Cuenta de exchange, emisión de claves de API, datos de mercado, enrutamiento de órdenes, custodia, liquidación
- Afiliación
- TradingHost es independiente y no está afiliado a Gate.io. Gate.io está bloqueado en China continental desde septiembre de 2021 y no está disponible para personas de EE. UU.
Sección 02 · Qué ofrece Gate.io
Qué ofrece Gate.io
Gate.io ofrece spot en más de 4600 activos, margen cruzado e aislado, perpetuos con margen en USDT y BTC, futuros de entrega física, opciones sobre BTC, ETH y principales activos seleccionados, copy trading y préstamos a través de una única interfaz Gate API v4 (REST + WebSocket). Las estrategias se autentican con claves firmadas mediante HMAC-SHA512; la Futures TestNet se ejecuta en un host independiente con sus propias claves, y el mercado spot no dispone de un sandbox público. Los detalles de los endpoints cambian con el tiempo. La estructura general es estable; los límites de frecuencia exactos, los niveles de comisiones y las listas de símbolos se encuentran en la documentación de Gate.io.
Mercados y patrones de estrategia
- Rotación de spot en altcoins de cola larga
- Arbitraje de perpetuos entre exchanges (con margen en USDT)
- Captura de base y tasas de financiación en perpetuos con margen en BTC
- Opciones sobre BTC y ETH (vencimientos cortos de 1h/4h/24h o estándar)
- Trading con margen cruzado e aislado
- Réplica de señales de copy trading
- Ejecuciones de prueba en el sandbox (Futures TestNet)
- Jerarquía de subcuentas para el aislamiento de estrategias
Interfaz de la API
- Áreas de producto
- REST para spot en `https://api.gateio.ws/api/v4` (endpoints de spot bajo `/spot/*`, margen bajo `/margin/*`); REST para futuros en vivo en `https://api.gateio.ws/api/v4/futures/{usdt,btc}` (host alternativo `https://fx-api.gateio.ws/api/v4`); REST para opciones en `/api/v4/options`. Futures TestNet en `https://fx-api-testnet.gateio.ws/api/v4` con claves de API independientes. El mercado spot no dispone de un sandbox público.
- Métodos de conexión
- REST v4 (JSON sobre HTTPS), WebSocket v4 con sockets independientes por mercado: spot en `wss://api.gateio.ws/ws/v4/`, futuros USDT en `wss://fx-ws.gateio.ws/v4/ws/usdt`, futuros BTC en `wss://fx-ws.gateio.ws/v4/ws/btc`, TestNet en `wss://fx-ws-testnet.gateio.ws/v4/ws/{usdt,btc}`. La API v2 se retiró el 1 de septiembre de 2023.
- Autenticación
- Firma HMAC-SHA512 con tres cabeceras obligatorias en endpoints privados: `KEY` (clave de API), `Timestamp` (segundos Unix) y `SIGN` (HMAC-SHA512 hexadecimal de la cadena de firma). Cadena de firma: `Method + "\n" + URL_Path + "\n" + QueryString + "\n" + HexEncode(SHA512(Body)) + "\n" + Timestamp`. Jerarquía de subcuentas con transferencia de activos únicamente de cuenta principal a subcuenta (no entre subcuentas).
Para más detalles, consulte Gate.io
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 Gate.io. Considéralos la fuente de información oficial.
Sección 03 · Desarrollar con IA
Desarrolle su estrategia para Gate.io 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.
Gate API v4 nativa
Control directo sobre el comportamiento específico de Gate.io, el enrutamiento de subcuentas y la lógica de ejecución de órdenes en spot, margen, perpetuos, futuros de entrega física y opciones.
CCXT
Interfaz común para Gate.io y otros exchanges de criptomonedas. Utiliza el ID de exchange `gate` (la clase activa; `gateio` todavía se resuelve y hereda de `gate`).
Freqtrade o Hummingbot
Despliegues basados en frameworks utilizando su estructura de estrategia y modelo de configuración. Freqtrade cubre spot y perpetuos con margen en USDT de Gate.io; Hummingbot incluye los conectores `gate_io` y `gate_io_perpetual`.
Conector personalizado
Tu propio motor de trading interno o integración propietaria con Gate.io.
Compatibilidad de frameworks con productos de Gate.io
La cobertura varía según el framework. CCXT abarca la superficie más amplia de Gate.io (spot, margen, perpetuos, opciones parciales); Freqtrade cubre spot y perpetuos con margen en USDT; Hummingbot incluye conectores para spot y perpetuos; el acceso nativo a Gate API v4 cubre todo lo que ofrece Gate.io, incluyendo opciones sobre BTC, ETH y principales activos seleccionados.
✓ soporte confirmado según la documentación oficial del framework. "parcial" indica cobertura limitada o solo de datos de mercado. "no" indica que no está documentado oficialmente como compatible. "n/a" indica que el framework no modela esa superficie de producto. Los enlaces de flujos de trabajo dirigen a páginas de /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
Gate.io proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Gate.io.
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 Gate.io.
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
Seleccione una región (EU o US-East), proporcione las variables de entorno que requiere su estrategia (las claves de la API v4 de Gate.io y el patrón de firma HMAC-SHA512) y despliegue. TradingHost compila su contenedor a partir del repositorio y ejecuta su 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 Gate.io
Aspectos problemáticos al ejecutar una estrategia de Gate.io en un entorno en la nube basado en contenedores, que no encontrarás en la documentación de Gate.io ni en los archivos README de los frameworks. Cada afirmación a continuación está citada o parafraseada de la propia documentación de Gate.io; las pautas de despliegue provienen de la ejecución de estas estrategias en TradingHost.
01 · API v4
v2 retirada en septiembre de 2023, v4 es la única opción
La API v2 dejó de funcionar el 1 de septiembre de 2023; las claves heredadas de v2 ya no se autentican y cualquier orden o cancelación contra v2 falla de forma silenciosa o devuelve un error 401. Toda integración actual con Gate.io debe apuntar a los endpoints de v4 bajo api.gateio.ws/api/v4.
02 · Firma
HMAC-SHA512, codificado en hexadecimal, con hash del cuerpo integrado
La mayoría de los exchanges de la competencia firman con SHA256. La cadena de firma de Gate intercala \n entre el método, la ruta, la consulta, el hash hex-SHA512 del cuerpo y la marca de tiempo, y el resultado es hexadecimal (no base64). Los componentes desordenados o un ancho de hash incorrecto son la causa más común de errores 401. Cabeceras: KEY, Timestamp (segundos Unix), SIGN (hex).
FuenteGate API v4 reference03 · Subcuentas
Solo de cuenta principal a subcuenta, se recomiendan claves API independientes
Las transferencias de activos solo pueden realizarse de la cuenta principal a la subcuenta (no entre subcuentas). El nivel VIP y los créditos por volumen de negociación se acumulan en la cuenta principal. Genere claves API independientes para cada subcuenta para aislar las estrategias y el riesgo, de modo que una clave comprometida o una estrategia fuera de control se limiten a esa subcuenta en lugar de afectar a toda la cartera.
FuenteGate sub-account guide04 · WebSocket
Los canales privados requieren cargas útiles de suscripción firmadas
Los canales privados requieren cargas útiles de suscripción firmadas (channel, event: "subscribe", auth). Spot, los futuros de USDT, los futuros de BTC, las opciones y los contratos de entrega tienen cada uno su propio socket; no los multiplexe. Una estrategia que abra un solo socket y espere recibir los cuatro tipos de mercado experimentará vacíos de datos sin previo aviso.
05 · Futures TestNet
Demo en fx-api-testnet, claves independientes
Las operaciones de demostración se ejecutan en fx-api-testnet.gateio.ws con claves API independientes (las claves de producción darán un error 401 allí). Spot no tiene un entorno de pruebas público, por lo que las simulaciones contra spot deben usar dry_run de Freqtrade o la grabación de CCXT en lugar de un sandbox del exchange. Mantenga las credenciales de TestNet y de producción en entradas de Secrets de TradingHost independientes; nunca reutilice una misma credencial en distintos entornos.
06 · Restricciones geográficas
Bloqueo para EE. UU. y China continental
Las personas estadounidenses y los residentes de China continental no pueden operar en Gate.io. Otras regiones restringidas incluyen Canadá, Singapur, Reino Unido, Malta y varias jurisdicciones sancionadas. Las estrategias no deben ejecutarse en beneficio de residentes de estas regiones. Confirme la entidad con licencia correspondiente a su cuenta antes de realizar el despliegue.
07 · Errores comunes
INVALID_SIGNATURE, INVALID_PARAM_VALUE, solo stop-loss limit
INVALID_SIGNATURE (orden de la cadena de firma o hash del cuerpo); INVALID_PARAM_VALUE en los endpoints de retiro (se requiere el campo chain); no se admiten órdenes stop-loss a mercado (use limit); las comisiones pagadas con POINT impiden la inferencia automática de comisiones; las claves API sin lista blanca de IP caducan a los 90 días. Registre la cadena original antes de aplicar el hash en compilaciones que no sean de producción para diagnosticar rápidamente los fallos de firma.
FuenteGate API v4 reference
Sección 06 · Diseñado para
Diseñado para
Los runtimes de TradingHost para Gate.io son ideales para:
- Operadores de altcoins de cola larga que ejecutan estrategias de momentum transversal o reversión a la media en un amplio universo de activos
- Operadores de arbitraje de perpetuos y de base que ejecutan posiciones en perpetuos con margen en USDT o BTC
- Vendedores de opciones y estrategias de dispersión que operan con vencimientos estándar y a corto plazo en BTC/ETH
- Operadores de copy-trading que gestionan el flujo de seguidores contra una subcuenta maestra
- Desarrolladores que usan entornos de desarrollo de IA para crear estrategias en Cursor o Claude Code basadas en `gate` de CCXT, Freqtrade o la API v4 nativa
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 Gate.io.
No. El código de su estrategia se conecta a Gate.io 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 Gate.io lo proporciona Gate.io. Usted es responsable de su cuenta de Gate.io, los permisos de la API, las credenciales y el cumplimiento de las condiciones de Gate.io.
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, 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 mismo debe encargarse de las actualizaciones del sistema operativo, la orquestación de contenedores, el envío de registros, la rotación de credenciales, 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 registros y estado integrados de fábrica. Si prefiere gestionar la infraestructura usted mismo, AWS es una opción. Si prefiere el entorno de ejecución como un servicio administrado, TradingHost es el camino más rápido.
Sí. TradingHost ejecuta estrategias en Python; elija el entorno de ejecución del 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.
Use `gate`. Esa es la clase activa. `gateio` todavía se resuelve y hereda de `gate`, pero el código nuevo debería usar `gate`. Inicialice con ccxt.gate({"apiKey": ..., "secret": ..., "options": {"defaultType": "swap"}}) para perpetuos con margen en USDT, "spot" para spot, "future" para contratos de entrega o "option" para opciones. Consulte el entorno de ejecución del framework CCXT para ver todos los detalles de la configuración.
Sí, si su proyecto está diseñado de esa manera. Puede ejecutar varios procesos o servicios de estrategia dentro de un mismo entorno de ejecución, o 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. O bien, conecte su propio repositorio de estrategias de GitHub. Vincular un repositorio de GitHub y crear una estrategia es gratis; los planes de los 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 API ni de su clave secreta. 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 v4 acotados (Spot Trade, Perpetual Futures, etc.) y vincule la clave a la IP de salida de su entorno de ejecución mediante la lista blanca de IP de Gate.io. Las claves sin lista blanca de IP caducan a los 90 días.
Sí, ese es el patrón recomendado en Gate. Cree subcuentas bajo la cuenta principal, genere una clave API v4 dedicada para cada subcuenta (con los permisos mínimos que requiera la estrategia) y deje que TradingHost inyecte la clave como un secreto. El volumen de las subcuentas y el nivel VIP se siguen acumulando en la cuenta principal, pero el radio de impacto de una clave comprometida o una estrategia fuera de control se limita a esa subcuenta. Los activos solo pueden moverse de la cuenta principal a la subcuenta, nunca entre subcuentas.
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 de MCP para ver todos los detalles.
Ambos. La superficie de control 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 main activa un nuevo despliegue.
El runtime detecta el fallo y expone los logs y la información de estado (health) pertinentes. 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 acceder a los logs y a la interfaz de estado.
Gate v4 firma con HMAC-SHA512 (no SHA256) y la cadena de firma se concatena con el carácter literal \n: Method + "\n" + URL_Path + "\n" + QueryString + "\n" + HexEncode(SHA512(Body)) + "\n" + Timestamp. El resultado es hexadecimal, no base64. Las tres cabeceras obligatorias son KEY, Timestamp y SIGN; no requiere frase de contraseña (eso es en OKX). El hash del cuerpo debe ser el SHA512 hexadecimal del cuerpo de la solicitud sin procesar; si el cuerpo está vacío, se calcula el hash SHA512 de una cadena vacía. Consulta la sección de notas operativas anterior para ver la guía completa.
Sí, pero solo para futuros. Futures TestNet funciona en https://fx-api-testnet.gateio.ws/api/v4 (REST) y wss://fx-ws-testnet.gateio.ws/v4/ws/{usdt,btc} (WebSocket). Debes generar claves de API específicas para TestNet; las claves de producción no sirven para autenticarse en TestNet. Spot no dispone de un sandbox público; prueba tus estrategias de spot con el modo dry_run de Freqtrade o con CCXT en modo de grabación y reproducción antes de pasar a producción.
No. Gate.io bloquea a personas y residentes de EE. UU. TradingHost no puede enrutar órdenes a Gate.io desde una cuenta estadounidense; la restricción se aplica en el propio exchange. Tampoco puedes usar Gate desde China continental; Gate abandonó ese mercado tras la prohibición del Banco Popular de China del 24 de septiembre de 2021. Otras jurisdicciones restringidas incluyen Canadá, Singapur y el Reino Unido.
TradingHost se ejecuta en las regiones EU y US-East. Seleccione la región más cercana al motor de emparejamiento del que depende su estrategia. Consulte la página de regiones para obtener más detalles sobre el enrutamiento y la proximidad.
No. TradingHost se centra en el despliegue y el runtime en producción. El backtesting debe realizarse en tu propio entorno de investigación, framework o AlgoBuilder.