Temps de lecture : … min

Runtime natif IA pour stratégies de trading Gemini

Développez dans Cursor, Claude Code ou tout autre IDE IA. Déployez depuis GitHub dans un runtime cloud géré avec contrôle MCP natif, logs et choix de la région.

Par l’équipe d’ingénierie de TradingHost

Section 01 · En un coup d’œil

En un coup d’œil

Plateforme
Gemini
Type de plateforme
Plateforme d'échange crypto et société de fiducie agréée par le NYDFS
Classe d’actifs
Crypto (spot), perpétuels crypto dans certaines juridictions hors États-Unis
Produits pris en charge
Spot (web et mobile), ActiveTrader (interface de carnet d'ordres avancée), Gemini Perpetuals (hors États-Unis, via Gemini Artemis Pte. Ltd., levier jusqu'à 100x ; paires comme ETHGUSDPERP), Gemini Custody (dépositaire qualifié, distinct mais intégrable), environnement sandbox
Modèle d’exécution
Runtime de stratégies conteneurisé
Source de déploiement
GitHub
Langages
Tout langage s'exécutant dans un conteneur
Intégrations courantes
REST, WebSocket et FIX 4.4 natifs Gemini, CCXT (gemini), clients HMAC-SHA384 personnalisés. Freqtrade et Hummingbot ne prennent pas officiellement en charge Gemini.
Intégration du workflow d’IA
Interface de contrôle MCP pour Cursor, Claude Code, GitHub Copilot et agents CLI
Rôle de TradingHost
Runtime, déploiement, logs, health checks, choix de la région, secrets, contrôle MCP
Rôle de Gemini
Compte d'échange, accès API, accès au marché, lieu d'exécution, dépositaire qualifié pour les utilisateurs institutionnels
Affiliation
TradingHost est indépendant et n'est pas affilié à Gemini. Gemini Trust Company, LLC est une société de fiducie à but limité de l'État de New York agréée par le NYDFS (octobre 2015). La société mère de Gemini est cotée au Nasdaq sous le symbole GEMI depuis septembre 2025.

Section 02 · Ce que propose Gemini

Ce que propose Gemini

Gemini est une société de fiducie agréée par le NYDFS proposant le trading spot via ses applications web et mobiles, ActiveTrader pour une interface de carnet d'ordres avancée, et Gemini Perpetuals pour les comptes hors États-Unis éligibles (géré par Gemini Artemis Pte. Ltd.). La connectivité s'effectue via REST, WebSocket et FIX 4.4, avec signature HMAC-SHA384. Hummingbot et Freqtrade offrant un support limité ou inexistant pour Gemini, la plupart des codes de stratégie reposent sur l'API native ou sur CCXT. Les paires spécifiques, les limites de requêtes et les critères d'éligibilité sont détaillés dans la documentation de Gemini.

Marchés et types de stratégies

  • Exécution unifiée sur le carnet d'ordres ActiveTrader
  • Arbitrage combiné sur les carnets d'ordres GUSD / USDC / RLUSD
  • Déploiements validés sur sandbox avant mise en production
  • Distribution via clé master- sur plusieurs sous-comptes institutionnels
  • Isolation des nonces par session pour instances de stratégie parallèles
  • Kill switch Cancel All Session Orders à l'arrêt de la stratégie
  • Rééquilibrage de trésorerie intégré à Gemini Custody
  • Exécution colocalisée FIX 4.4 pour desks institutionnels

Interface API

Produits couverts
Échange spot, ActiveTrader, Gemini Derivatives / Perpetuals (si éligible), Sandbox (environnement de test indépendant).
Méthodes de connexion
REST (HTTPS), WebSocket (public + privé), FIX 4.4 Order Entry, FIX 4.4 Market Data, FIX Drop Copy. FIX nécessite une interconnexion (cross-connect) depuis un centre de données ou un extranet agréé vers l'infrastructure de Gemini sur la côte Est des États-Unis ; non disponible via l'Internet public.
Authentification
HMAC-SHA384 sur un payload JSON encodé en base64. Signature dans X-GEMINI-SIGNATURE, clé API dans X-GEMINI-APIKEY, payload dans X-GEMINI-PAYLOAD. Préfixes de clé : master- (à l'échelle du groupe, nécessite le paramètre account) et account- (compte unique). Chaque clé provisionnée constitue une « session » avec son propre flux de nonces.

Pour plus de détails, reportez-vous à Gemini

Les endpoints spécifiques, les limites de requêtes, les listes de paires, les paliers de frais et l'historique des versions se trouvent dans la documentation de Gemini. Considérez-la comme la seule source de vérité.

Section 03 · Développer avec l’IA

Développez votre stratégie Gemini avec l’IA

Choisissez une méthode d’intégration, dupliquez (fork) un starter de framework TradingHost et concevez votre stratégie dans un AI IDE. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif sur GitHub.

  • API native Gemini

    Contrôle direct du comportement spécifique à Gemini (REST, WebSocket, FIX 4.4), des données de compte et de la logique d'exécution des ordres.

  • CCXT

    Interface commune entre Gemini et d'autres plateformes d'échange crypto via le connecteur gemini.

  • Freqtrade ou Hummingbot

    Hummingbot ne propose pas de connecteur Gemini. Freqtrade est uniquement supporté par la communauté via CCXT et n'est pas officiellement pris en charge. La plupart des codes en production utilisent l'API native ou CCXT.

  • Connecteur personnalisé

    Votre propre moteur de trading interne ou intégration propriétaire Gemini, souvent articulé autour de la signature HMAC-SHA384 et de l'interface FIX 4.4.

Compatibilité des frameworks avec les produits Gemini

Gemini est une société de fiducie agréée par le NYDFS proposant le trading spot via le web et ActiveTrader, ainsi qu'une plateforme distincte pour les contrats perpétuels gérée par Gemini Artemis dans certaines juridictions. Hummingbot ne propose pas de connecteur Gemini et Freqtrade n'accède à Gemini que via CCXT grâce au support de la communauté. La plupart des codes de stratégie en production reposent donc soit sur l'API native REST / WebSocket / FIX 4.4, soit sur CCXT.

FrameworkSpotPerp
Native Gemini APIPris en chargePris en charge
CCXTPris en chargePartiellement pris en charge
FreqtradePartiellement pris en chargeSupport non documenté
HummingbotSupport non documentéSupport non documenté

✓ support confirmé selon la documentation officielle du framework. « partial » indique une couverture incomplète ou dépendante de la version. « no » indique qu'aucun support n'est officiellement documenté.

TradingHost n’impose aucun framework. Il exécute votre projet.

Développer avec l’IA

Les starters de framework ci-dessus s’associent naturellement avec les AI IDE. L’interface de contrôle MCP de TradingHost ferme la boucle : les outils d’IA peuvent inspecter les déploiements, consulter les journaux et gérer l’environnement d’exécution à vos côtés, sans jamais interférer avec le flux d’exécution des ordres.

Section 04 · Exécuter sur TradingHost

Exécutez votre code sur TradingHost

Gemini fournit la plateforme d’échange et l’accès API. TradingHost fournit l’environnement de production où s’exécute votre stratégie connectée à Gemini.

Au lieu d’exécuter le code de votre stratégie sur un ordinateur portable, un ordinateur de bureau, un VPS générique ou un serveur configuré manuellement, vous le déployez depuis GitHub dans un environnement d’exécution de conteneurs géré par TradingHost.

Vous

  • Votre dépôt contient votre code.
  • Votre déploiement définit son mode d’exécution.
  • Votre stratégie se connecte à Gemini.

TradingHost

  • Maintient l’environnement d’exécution en ligne.
  • Affiche les logs et les contrôles d’état.
  • Sélection de la région.
  • Surface de déploiement contrôlée.

Flux de déploiement

  1. ÉTAPE 01

    Connecter GitHub

    Autorisez TradingHost à accéder à votre compte GitHub.

  2. ÉTAPE 02

    Associez un dépôt ou démarrez depuis un framework

    Pointez TradingHost vers votre dépôt de stratégie existant, ou forkez un runtime TradingHost (CCXT ou un starter natif Gemini) pour obtenir une base de travail fonctionnelle.

  3. ÉTAPE 03

    Déployer dans un conteneur TradingHost

    Choisissez une région (EU ou US-East), renseignez les variables d'environnement requises par votre stratégie (clés API Gemini, préfixe master- ou account-, secret HMAC-SHA384), puis déployez. TradingHost construit votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. Aucune installation locale de Docker n'est requise.

  4. ÉTAPE 04

    Suivre les logs et l’état de santé

    Suivez en direct les logs, l’état de santé et l’état d’exécution depuis le tableau de bord TradingHost. Cette même interface est accessible via MCP depuis n’importe quel AI IDE, permettant à Cursor, Claude Code ou un agent en ligne de commande de lire l’état du déploiement et de gérer le runtime à vos côtés.

  5. ÉTAPE 05

    Mettre à jour et redéployer

    Poussez vos modifications sur votre branche principale GitHub et TradingHost relance automatiquement le déploiement.

Section 05 · Notes opérationnelles

Notes opérationnelles pour Gemini

Les pièges concrets qui vous guettent lorsque vous exécutez une stratégie Gemini dans un runtime cloud conteneurisé, loin de la théorie de la documentation officielle ou des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé de la documentation de Gemini ; les conseils de déploiement sont issus de l'exploitation réelle de ces stratégies sur TradingHost.

  1. 01 · Authentification

    Gemini utilise des signatures HMAC-SHA384, pas SHA256

    Chaque requête privée nécessite X-GEMINI-APIKEY, un payload JSON encodé en base64 dans X-GEMINI-PAYLOAD, et le HMAC-SHA384 hexadécimal de ce payload (en utilisant le secret API comme clé) dans X-GEMINI-SIGNATURE. Les bibliothèques copiées-collées depuis des exemples Coinbase ou Kraken utilisent presque toujours SHA256 par défaut et échouent silencieusement avec l'erreur InvalidSignature. Le payload signé doit inclure le chemin de la requête (request path) et un nonce, ainsi que le paramètre account lors de l'utilisation d'une clé master-.

  2. 02 · Modèle de clé

    Les clés master- agissent sur un groupe, les clés account- sur un compte unique

    Gemini regroupe plusieurs comptes sous une même structure institutionnelle. Une clé avec le préfixe master- peut cibler n'importe quel compte du groupe en transmettant le pseudonyme du compte dans le champ account du payload de la requête ; une clé avec le préfixe account- rejette ce paramètre. Choisir le mauvais type de clé est la cause la plus fréquente d'erreurs MissingRole / 403. Conservez les clés spécifiques au déploiement au niveau du compte ; réservez les clés master pour l'automatisation de la trésorerie.

  3. 03 · Nonces

    Chaque clé API dispose de son propre flux de nonces à ±30 secondes du temps Unix

    Gemini documente les nonces comme étant monotones par session (par clé API), de sorte que deux clés peuvent s'exécuter sur des conteneurs différents sans coordination d'horloge. Le nonce doit être strictement supérieur au précédent pour cette clé et se situer dans une marge de ±30 secondes par rapport à l'époque Unix actuelle ; le non-respect de l'une ou l'autre de ces règles renvoie InvalidNonce. L'exécution d'une même clé depuis deux conteneurs est le mode de défaillance habituel. Provisionnez une clé distincte par runtime de stratégie et traitez la clé comme l'unité d'échelle horizontale.

  4. 04 · Sandbox

    Validez sur api.sandbox.gemini.com avant de passer en production

    Le sandbox est accessible à l'adresse https://exchange.sandbox.gemini.com (interface utilisateur) et https://api.sandbox.gemini.com plus wss://api.sandbox.gemini.com (API). Les comptes sont alimentés avec des versions de test de USD, BTC, ETH, BCH, LTC, OXT, LINK, BAT et DAI ; les prix divergent de ceux de la production. Les clés de production ne fonctionnent pas dans le sandbox et inversement. La double authentification peut être contournée pour l'automatisation avec le code 9999999.

  5. 05 · Limites de requêtes

    Public 120/min, privé 600/min, avec une file d'attente de burst de 5 requêtes

    Gemini documente 120 requêtes par minute sur les endpoints publics et 600 sur les endpoints privés, avec un régime permanent de respectivement 1 et 5 requêtes par seconde. L'exchange met en attente jusqu'à cynq requêtes excédentaires, puis renvoie une erreur HTTP 429 avec le motif RateLimit. Les pics de requêtes de gestion d'ordres à l'ouverture ou en période de volatilité sont la cause classique de 429 auto-infligées ; regroupez et échelonnez les annulations.

  6. 06 · Risque

    Cancel All Session Orders est votre kill switch

    Chaque ordre est enregistré sous la clé API qui l'a créé. L'endpoint Cancel All Session Orders cible uniquement les ordres ouverts de cette clé, ce qui permet d'arrêter une stratégie hors de contrôle sans affecter les autres stratégies exécutées avec des clés différentes sur le même compte. Intégrez cela dans le gestionnaire SIGTERM de votre conteneur afin que les déploiements ne laissent pas d'ordres obsolètes actifs. Associez-le à Cancel All Active Orders pour les arrêts d'urgence à l'échelle du compte.

  7. 07 · Sécurisation

    Verrouillez les clés sur vos IP de sortie TradingHost avant d'activer les autorisations de retrait

    Gemini prend en charge la liste blanche Trusted IP sur les clés API ; les requêtes hors liste blanche échouent avec RemoteAddressForbidden. Les clés disposent également d'autorisations distinctes pour le trading, la gestion des fonds et les retraits ; accorder l'autorisation de retrait sur une clé de stratégie est une mauvaise pratique par défaut. Traitez les retraits avec une clé d'opérations distincte, restreinte par IP à un hôte de contrôle, et laissez les runtimes de stratégie utiliser des clés limitées au trading.

Section 06 · Conçu pour

Conçu pour

Les runtimes TradingHost pour Gemini sont particulièrement adaptés aux :

  • Développeurs créant des stratégies dans des IDE IA (Cursor, Claude Code)
  • Traders crypto systématiques
  • Desks institutionnels réglementés aux États-Unis
  • Utilisateurs de CCXT
  • Équipes migrant d'un hébergement VPS vers un déploiement conteneurisé

La connexion à GitHub et la création de votre première stratégie sont gratuites.

Section 08 · FAQ

FAQ

Non. TradingHost est indépendant et n'est pas affilié à Gemini. Gemini Trust Company, LLC est une société fiduciaire à but limité de l'État de New York, agréée par le NYDFS en octobre 2015 ; sa société mère a été introduite sur le Nasdaq sous le symbole GEMI en septembre 2025. Le statut de fiducie réglementée est indépendant de TradingHost.

Non. Le code de votre stratégie se connecte à Gemini et envoie des instructions selon votre propre logique, les autorisations de votre compte et votre méthode d'intégration. TradingHost fournit l'environnement d'exécution (runtime) où ce code s'exécute.

Non. L'accès à l'API Gemini est fourni par Gemini. Vous êtes responsable de votre compte Gemini, des autorisations de l'API, de vos identifiants et du respect des conditions d'utilisation de Gemini.

Non. TradingHost est le runtime cloud où s'exécute le code de votre stratégie. Nous ne fournissons pas de signaux, de modèles de prédiction IA ou de stratégies préconçues. Avec TradingHost, vous écrivez ou générez vous-même la stratégie (souvent avec Cursor ou Claude Code), vous la conservez sur GitHub en tant que code personnel, et vous utilisez TradingHost pour l'exécuter en production. Des produits comme 3Commas ou Cryptohopper détiennent la logique de la stratégie ; TradingHost exécute la vôtre.

AWS et DigitalOcean vous fournissent de la puissance de calcul brute. Vous devez gérer vous-même les mises à jour de l'OS, l'orchestration des conteneurs, la transmission des logs, la rotation des secrets, le basculement de région et la surveillance de la disponibilité. TradingHost vous offre un runtime managé conçu spécifiquement pour les stratégies de trading : déploiement natif via GitHub, contrôle piloté par MCP depuis des IDE IA, ainsi que des interfaces de logs et de santé prêtes à l'emploi. Si vous souhaitez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un runtime sous forme de service managé, TradingHost est la voie la plus rapide.

Oui. TradingHost exécute des stratégies Python ; choisissez le runtime de framework qui correspond à votre stack ou déployez votre propre dépôt.

Oui. TradingHost prend en charge n'importe quel langage capable de s'exécuter dans un conteneur.

Oui. CCXT intègre un connecteur gemini avec une couverture spot et inclut la gestion des swaps perpétuels dans son code source. Vérifiez la couverture des endpoints de symboles et de marge par rapport à votre version actuelle de CCXT avant de vous appuyer sur les fonctionnalités de produits dérivés ; les API natives REST et WebSocket de Gemini restent la voie la plus sûre pour les dérivés. Consultez le runtime du framework CCXT pour connaître la procédure de configuration.

Oui, si votre projet est conçu ainsi. Vous pouvez exécuter plusieurs processus ou services de stratégie au sein d'un même runtime, ou les séparer dans différents runtimes pour plus d'isolation et de clarté opérationnelle. Le modèle de nonce par session de Gemini s'associe naturellement avec une clé API par stratégie. Consultez la page du runtime TradingHost pour découvrir le modèle multi-stratégie.

La voie la plus rapide consiste à forker un runtime de framework TradingHost tel que CCXT, ou à connecter votre propre dépôt de stratégie GitHub conçu autour de l'interface native REST, WebSocket ou FIX 4.4 de Gemini. Lier un dépôt GitHub et créer une stratégie est gratuit ; les abonnements de runtime sont détaillés sur la page des tarifs.

Dans votre workflow de secrets contrôlé par GitHub. TradingHost les lit au moment de l'exécution via les secrets de dépôt GitHub, les secrets d'environnement ou votre propre processus approuvé de gestion des secrets. TradingHost n'a pas besoin de conserver la garde de votre clé API et de votre secret. Consultez la section sur les secrets de la plateforme pour connaître le modèle complet de gestion.

Non. Les stratégies ne devraient jamais avoir besoin d'autorisations de retrait. Gemini prend en charge des autorisations restreintes pour le trading, la gestion des fonds et les retraits, ainsi que la liste blanche Trusted IP. Conservez les clés de stratégie avec une autorisation limitée au trading et associez-les aux IP de sortie de TradingHost pour la région sélectionnée ; réservez l'autorisation de retrait à une clé d'opérations distincte sur un hôte de contrôle à IP fixe.

Gemini renvoie MissingRole (HTTP 403) lorsqu'une clé API ne dispose pas de l'autorisation requise pour l'endpoint, et RemoteAddressForbidden lorsque la requête provient d'une IP qui ne figure pas sur la liste blanche Trusted IP de la clé. InvalidSignature et InvalidNonce sont les deux autres échecs liés à l'authentification à intégrer dans vos alertes.

Deux conteneurs utilisant la même clé API entrent en concurrence sur la séquence de nonces. Gemini limite la portée du flux de nonces par clé (session) et la valeur doit être strictement croissante et se situer dans une marge de ±30 secondes par rapport au temps Unix. Provisionnez une clé API distincte par instance de runtime ; n'utilisez un nonce basé sur le temps qu'avec une sémantique d'écriture unique (single-writer).

Oui. TradingHost prend en charge le contrôle basé sur MCP pour les IDE IA, notamment Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande (CLI). Les outils d'IA peuvent inspecter les déploiements, consulter les logs, redémarrer les stratégies et gérer les flux de travail du runtime. MCP est une interface de contrôle et d'observabilité, et non le chemin d'exécution des transactions. Consultez l'interface de contrôle MCP pour en savoir plus.

Les deux. L'interface de contrôle MCP fonctionne tout aussi bien depuis des agents en ligne de commande (Claude Code CLI, clients MCP personnalisés, appels MCP scriptés) que depuis un IDE. La boucle de déploiement native GitHub fonctionne également sans aucun outil d'IA : un simple git push vers votre branche principale déclenche un redéploiement.

Le runtime détecte le plantage et expose les logs et les informations d'état (health) pertinentes. Lorsque cela est possible, la stratégie concernée peut être redémarrée sans perturber les autres stratégies exécutées dans le même conteneur. Intégrez Cancel All Session Orders dans votre gestionnaire SIGTERM afin que les déploiements ne laissent pas d'ordres obsolètes actifs ; le code de votre stratégie reste responsable de la gestion sécurisée des erreurs, de la protection contre les ordres doublons et des contrôles de risque. Consultez la section observabilité pour en savoir plus sur les logs et l'interface d'état.

TradingHost est disponible dans les régions EU et US-East. La connectivité FIX 4.4 de Gemini nécessitant une interconnexion (cross-connect) depuis un centre de données ou un extranet agréé vers son infrastructure sur la côte Est des États-Unis, la région US-East s'impose naturellement pour les stratégies Gemini sensibles à la latence. Consultez la page des régions pour obtenir des détails sur le routage et la proximité.

Oui. Gemini Trust Company, LLC est une société fiduciaire à but limité de l'État de New York, agréée par le NYDFS en octobre 2015, ce qui en fait un fiduciaire et un dépositaire qualifié en vertu de la loi bancaire de New York (New York Banking Law). La maison mère de Gemini Trust est entrée en bourse sur le Nasdaq sous le symbole GEMI en septembre 2025. Ce statut de fiducie réglementée est indépendant de TradingHost.

Non. Gemini Earn était un produit de rendement (et non la plateforme d'échange au comptant ou l'API) qui a été liquidé dans le cadre de la faillite de Genesis. Les clients ont récupéré 100 % de leurs avoirs en nature lors des distributions de mai à juin 2024 ; la SEC a volontairement rejeté sa plainte contre Gemini Trust avec abandon des poursuites (with prejudice) le 23 janvier 2026. Cela n'affecte en rien l'accès à la plateforme, le comportement de l'API ou les opérations de garde.

Oui, sous réserve d'éligibilité. Gemini Perpetuals est géré par Gemini Artemis Pte. Ltd. dans certaines juridictions hors États-Unis, offrant un effet de levier allant jusqu'à 100x et des contrats libellés en GUSD (par exemple ETHGUSDPERP) ou USDC. L'accès pour les clients particuliers américains est en cours de déploiement via le marché de contrats désigné Gemini Titan, approuvé par la CFTC. Vérifiez la juridiction de votre compte et la plateforme de cotation du symbole avant tout déploiement.

Non. TradingHost se concentre exclusivement sur le runtime de production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.