Tiempo de lectura: … min

Runtime nativo de IA para estrategias de trading en Gemini

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.

Por el equipo de ingeniería de TradingHost

Sección 01 · De un vistazo

De un vistazo

Plataforma
Gemini
Tipo de plataforma
Exchange de criptomonedas y compañía fiduciaria regulada por el NYDFS
Clase de activo
Cripto (spot), perpetuos de criptomonedas en jurisdicciones seleccionadas fuera de EE. UU.
Productos compatibles
Spot (web y móvil), ActiveTrader (interfaz avanzada de libro de órdenes), Gemini Perpetuals (fuera de EE. UU., a través de Gemini Artemis Pte. Ltd., apalancamiento de hasta 100x; pares como ETHGUSDPERP), Gemini Custody (custodio cualificado, independiente pero integrable), entorno sandbox
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 nativo de Gemini, WebSocket y FIX 4.4, CCXT (gemini), clientes personalizados HMAC-SHA384. Freqtrade y Hummingbot no ofrecen soporte oficial para Gemini.
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, secretos, control MCP
Rol de Gemini
Cuenta de exchange, acceso a la API, acceso al mercado, plataforma de ejecución, custodio cualificado para usuarios institucionales
Afiliación
TradingHost es independiente y no está afiliado a Gemini. Gemini Trust Company, LLC es una compañía fiduciaria de propósito limitado de Nueva York regulada por el NYDFS (octubre de 2015). La matriz de Gemini cotiza en Nasdaq como GEMI desde septiembre de 2025.

Sección 02 · Qué ofrece Gemini

Qué ofrece Gemini

Gemini es una compañía fiduciaria regulada por el NYDFS que ofrece trading spot a través de sus aplicaciones web y móviles, ActiveTrader para una interfaz avanzada de libro de órdenes, y Gemini Perpetuals para cuentas elegibles fuera de EE. UU. (operado por Gemini Artemis Pte. Ltd.). La conectividad se realiza mediante REST, WebSocket y FIX 4.4, con firma HMAC-SHA384. Hummingbot y Freqtrade tienen un soporte limitado o nulo para Gemini, por lo que la mayoría del código de las estrategias se basa en la API nativa o en CCXT. Los símbolos específicos, límites de frecuencia y la elegibilidad de la plataforma se detallan en la documentación de Gemini.

Mercados y patrones de estrategia

  • Ejecución unificada en el libro de órdenes de ActiveTrader
  • Arbitraje combinado en libros de órdenes de GUSD / USDC / RLUSD
  • Despliegues validados en sandbox antes del lanzamiento a producción
  • Distribución con clave maestra (master-key) entre subcuentas institucionales
  • Aislamiento de nonce por sesión para instancias de estrategia en paralelo
  • Interruptor de apagado de emergencia (kill switch) Cancel All Session Orders al detener la estrategia
  • Rebalanceo de tesorería integrado con custodia
  • Ejecución coubicada FIX 4.4 para mesas institucionales

Interfaz de la API

Áreas de producto
Exchange spot, ActiveTrader, Gemini Derivatives / Perpetuals (donde sea elegible), Sandbox (entorno de pruebas independiente).
Métodos de conexión
REST (HTTPS), WebSocket (público + privado), FIX 4.4 Order Entry, FIX 4.4 Market Data, FIX Drop Copy. FIX requiere una conexión cruzada (cross-connect) desde un centro de datos o extranet aprobado hacia la infraestructura de Gemini en la costa este de EE. UU.; no está disponible a través de la internet pública.
Autenticación
HMAC-SHA384 sobre un payload JSON codificado en base64. Firma en X-GEMINI-SIGNATURE, clave API en X-GEMINI-APIKEY, payload en X-GEMINI-PAYLOAD. Prefijos de clave: master- (para todo el grupo, requiere el parámetro account) y account- (cuenta única). Cada clave aprovisionada es una "sesión" con su propio flujo de nonce.

Para más detalles, consulte Gemini

Los endpoints específicos, pesos de límites de frecuencia, listas de símbolos, niveles de comisiones e historial de versiones se encuentran en la documentación de Gemini. Considéralos como la fuente de verdad.

Sección 03 · Desarrollar con IA

Desarrolle su estrategia para Gemini 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 Gemini

    Control directo sobre el comportamiento específico de Gemini (REST, WebSocket, FIX 4.4), datos de cuenta y lógica de ejecución de órdenes.

  • CCXT

    Interfaz común entre Gemini y otros exchanges de criptomonedas a través del conector gemini.

  • Freqtrade o Hummingbot

    Hummingbot no tiene conector para Gemini. Freqtrade solo está disponible a través de la comunidad mediante CCXT y no cuenta con soporte oficial. La mayoría del código de producción utiliza la API nativa o CCXT.

  • Conector personalizado

    Tu propio motor de trading interno o integración propietaria con Gemini, a menudo estructurada en torno a la firma HMAC-SHA384 y la interfaz FIX 4.4.

Compatibilidad de frameworks con productos de Gemini

Gemini es una compañía fiduciaria regulada por el NYDFS con trading spot a través de la web y ActiveTrader, y una plataforma de perpetuos independiente operada por Gemini Artemis en jurisdicciones seleccionadas. Hummingbot no tiene conector para Gemini y Freqtrade solo accede a Gemini a través de CCXT mediante soporte de la comunidad, por lo que la mayoría del código de las estrategias de producción se basa en REST / WebSocket / FIX 4.4 nativos o en CCXT.

FrameworkSpotPerp
Native Gemini APICompatibleCompatible
CCXTCompatibleSoporte parcial
FreqtradeSoporte parcialSin soporte documentado
HummingbotSin soporte documentadoSin soporte documentado

✓ soporte confirmado según los documentos oficiales del framework. "parcial" indica cobertura incompleta o dependiente de la versión. "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

Gemini proporciona el exchange y el acceso a la API. TradingHost proporciona el entorno de producción donde se ejecuta tu estrategia conectada a Gemini.

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 Gemini.

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

  1. PASO 01

    Conecta GitHub

    Autoriza a TradingHost para acceder a tu cuenta de GitHub.

  2. 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 una plantilla de inicio nativa de Gemini) para obtener una base funcional.

  3. 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 (claves de API de Gemini, prefijo master- o account-, secreto HMAC-SHA384) 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.

  4. 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.

  5. 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 Gemini

Problemas con los que te toparás al ejecutar una estrategia de Gemini en un runtime en la nube basado en contenedores, que no aparecen en la documentación de Gemini 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 Gemini; la guía sobre el despliegue proviene de la ejecución de estas estrategias en TradingHost.

  1. 01 · Autenticación

    Gemini firma con HMAC-SHA384, no con SHA256

    Cada solicitud privada requiere X-GEMINI-APIKEY, un payload JSON codificado en base64 en X-GEMINI-PAYLOAD y el HMAC-SHA384 hexadecimal de ese payload (usando el secreto de la API como clave) en X-GEMINI-SIGNATURE. Las librerías copiadas y pegadas de ejemplos de Coinbase o Kraken casi siempre usan SHA256 por defecto y fallan silenciosamente con InvalidSignature. El payload firmado debe incluir la ruta de la solicitud y un nonce, además del parámetro account cuando se utiliza una clave master-.

  2. 02 · Modelo de claves

    Las claves master- actúan sobre un grupo; las claves account- actúan sobre una sola cuenta

    Gemini agrupa varias cuentas bajo una misma estructura institucional. Una clave con el prefijo master- puede dirigirse a cualquier cuenta del grupo enviando el alias de la cuenta en el campo account del payload de la solicitud; una clave con el prefijo account- rechaza ese parámetro. Elegir el tipo de clave incorrecto es la causa más común de errores MissingRole / 403. Mantenga las claves específicas de cada despliegue a nivel de cuenta y reserve las claves maestras para la automatización de tesorería.

  3. 03 · Nonces

    Cada clave de API tiene su propio flujo de nonces dentro de un margen de ±30 segundos del tiempo Unix

    Gemini documenta los nonces como monotónicos por sesión (por clave de API), por lo que dos claves pueden ejecutarse en contenedores distintos sin necesidad de coordinar sus relojes. El nonce debe ser estrictamente mayor que el anterior para esa clave y estar dentro de un margen de ±30 segundos de la época Unix actual; infringir cualquiera de estas reglas devuelve InvalidNonce. Ejecutar una misma clave desde dos contenedores es el fallo más habitual. Genere una clave independiente para cada entorno de ejecución de estrategia y trate la clave como la unidad de escalabilidad horizontal.

  4. 04 · Sandbox

    Valide el funcionamiento en api.sandbox.gemini.com antes de pasar a producción

    El entorno de pruebas (sandbox) está disponible en https://exchange.sandbox.gemini.com (interfaz de usuario) y en https://api.sandbox.gemini.com junto con wss://api.sandbox.gemini.com (API). Las cuentas se crean con fondos de prueba en USD, BTC, ETH, BCH, LTC, OXT, LINK, BAT y DAI; los precios varían respecto a los de producción. Las claves de producción no funcionan en el sandbox y viceversa. Para tareas de automatización, se puede omitir la autenticación de doble factor utilizando el código 9999999.

  5. 05 · Límites de frecuencia

    Pública: 120/min; privada: 600/min, con una cola de ráfagas de 5 solicitudes

    Gemini documenta 120 solicitudes por minuto en endpoints públicos y 600 en endpoints privados, con un ritmo constante de 1 y 5 solicitudes por segundo, respectivamente. El exchange encola hasta cinco solicitudes en exceso y luego devuelve un error HTTP 429 con el motivo RateLimit. Las ráfagas de gestión de órdenes en la apertura o durante periodos de alta volatilidad son la causa clásica de los errores 429 autoinfligidos; agrupe y escalone las cancelaciones.

  6. 06 · Riesgo

    Cancel All Session Orders es su interruptor de apagado de emergencia

    Cada orden queda registrada con la clave de API que la creó. El endpoint Cancel All Session Orders se dirige únicamente a las órdenes abiertas de esa clave, por lo que se puede detener una estrategia fuera de control sin afectar a otras estrategias secundarias que utilicen claves distintas en la misma cuenta. Integre esto en el controlador SIGTERM de su contenedor para que los despliegues no dejen órdenes huérfanas activas. Combínelo con Cancel All Active Orders para paradas de emergencia en toda la cuenta.

  7. 07 · Fortalecimiento de seguridad

    Restrinja las claves a las IP de salida de TradingHost antes de habilitar los permisos de retiro

    Gemini admite la lista de permitidos Trusted IP en las claves de API; las solicitudes que no provengan de una IP permitida fallarán con el error RemoteAddressForbidden. Las claves también tienen permisos independientes para trading, gestión de fondos y retiros; otorgar permisos de retiro a una clave de estrategia no es una buena práctica por defecto. Gestione los retiros con una clave de operaciones independiente, vinculada por IP a un host de control, y deje que los entornos de ejecución de las estrategias utilicen claves exclusivas para trading.

Sección 06 · Diseñado para

Diseñado para

Los runtimes de TradingHost para Gemini son ideales para:

  • Desarrolladores que crean estrategias en entornos de desarrollo de IA (Cursor, Claude Code)
  • Traders sistemáticos de criptomonedas
  • Mesas institucionales reguladas en EE. UU.
  • Usuarios de CCXT
  • Equipos que migran de alojamiento 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 Gemini. Gemini Trust Company, LLC es una sociedad fiduciaria de propósito limitado de Nueva York, autorizada por el NYDFS en octubre de 2015; su empresa matriz cotiza en el Nasdaq como GEMI desde septiembre de 2025. El estatus de fideicomiso regulado es independiente de TradingHost.

No. El código de su estrategia se conecta a Gemini 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 donde se ejecuta dicho código.

No. El acceso a la API de Gemini lo proporciona Gemini. Usted es el responsable de su cuenta de Gemini, de los permisos de la API, de las credenciales y del cumplimiento de las condiciones de Gemini.

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 guarda 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, 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 de 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 viable. 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 incluye un conector de gemini con cobertura para spot e incorpora la gestión de swaps perpetuos en su código fuente. Verifique la cobertura de los endpoints de símbolos y margen en su versión actual de CCXT antes de depender de las funciones de derivados; las API nativas REST y WebSocket de Gemini siguen siendo la opción de menor riesgo para derivados. Consulte el entorno de ejecución del framework CCXT para ver 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 mismo entorno de ejecución, o separarlos en diferentes entornos para lograr un mayor aislamiento y claridad operativa. El modelo de nonces por sesión de Gemini se adapta de forma natural al uso de una clave de API por estrategia. 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, o conectar su propio repositorio de estrategias de GitHub diseñado en torno a la interfaz nativa REST, WebSocket o FIX 4.4 de Gemini. 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 el momento de la 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. Gemini admite permisos específicos para trading, gestión de fondos y retiros, además de la lista de permitidos Trusted IP. Mantenga las claves de estrategia con permisos exclusivos de trading y vincúlelas a las IP de salida de TradingHost de la región que haya seleccionado; reserve los permisos de retiro para una clave de operaciones independiente en un host de control con IP fija.

Gemini devuelve MissingRole (HTTP 403) cuando una clave de API carece de los permisos necesarios para el endpoint, y RemoteAddressForbidden cuando la solicitud proviene de una IP que no está en la lista de permitidos Trusted IP de la clave. InvalidSignature e InvalidNonce son los otros dos fallos de autenticación que conviene integrar en su sistema de alertas.

Dos contenedores que utilizan la misma clave de API compiten entre sí por la secuencia de nonces. Gemini limita el flujo de nonces por clave (sesión), y el valor debe ser estrictamente creciente y estar dentro de un margen de ±30 segundos del tiempo Unix. Genere una clave de API independiente para cada instancia del entorno de ejecución; utilice un nonce basado en tiempo únicamente con semántica de un único escritor.

Sí. TradingHost admite el control basado en MCP para IDEs 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 runtime. MCP es una interfaz de control y observabilidad, no la ruta de ejecución de operaciones. Consulta la interfaz de control MCP para ver todos los detalles.

Ambos. La interfaz de control MCP funciona igual de bien desde agentes basados en CLI (Claude Code CLI, clientes MCP personalizados, llamadas MCP programadas) que desde el propio 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 la caída y expone los registros pertinentes y la información de estado. En los casos compatibles, la estrategia afectada se puede reiniciar sin interrumpir otras estrategias que se ejecuten en el mismo contenedor. Vincula Cancel All Session Orders a tu manejador de SIGTERM para que los despliegues no dejen órdenes obsoletas activas; el código de tu estrategia sigue siendo el 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 conocer la interfaz de registros y estado.

TradingHost se ejecuta en las regiones EU y US-East. La conectividad FIX 4.4 de Gemini requiere una conexión cruzada (cross-connect) desde un centro de datos o extranet aprobado hacia su infraestructura en la costa este de EE. UU., por lo que US-East es la elección lógica para estrategias de Gemini sensibles a la latencia. Consulta la página de regiones para obtener más detalles sobre enrutamiento y proximidad.

Sí. Gemini Trust Company LLC es una compañía fiduciaria de propósito limitado de Nueva York constituida por el NYDFS en octubre de 2015, lo que la convierte en fiduciaria y custodio cualificado según la Ley de Bancos de Nueva York. La empresa matriz de Gemini Trust cotiza en Nasdaq bajo el ticker GEMI desde septiembre de 2025. El estatus de fideicomiso regulado es independiente de TradingHost.

No. Gemini Earn era un producto de rendimiento (no el exchange spot ni la API) que se liquidó mediante la quiebra de Genesis. Los clientes recibieron una recuperación del 100 % en especie durante las distribuciones de mayo a junio de 2024; la SEC desestimó voluntariamente y con perjuicio su caso contra Gemini Trust el 23 de enero de 2026. Esto no afecta al acceso al exchange, al comportamiento de la API ni a las operaciones de custodia.

Sí, siempre que cumplas con los requisitos de elegibilidad. Gemini Perpetuals está operado por Gemini Artemis Pte. Ltd. en determinadas jurisdicciones fuera de EE. UU., con un apalancamiento de hasta 100x y contratos denominados en GUSD (por ejemplo, ETHGUSDPERP) o USDC. El acceso minorista en EE. UU. se está desarrollando a través del mercado de contratos designado Gemini Titan, aprobado por la CFTC. Verifica la jurisdicción de tu cuenta y la plataforma de cotización del símbolo antes del despliegue.

No. TradingHost se centra en el entorno de ejecución (runtime) y el despliegue en producción. El backtesting corresponde a tu entorno de investigación, framework o AlgoBuilder.