Comment utiliser l'API Gemini pour le trading automatisé?

L'API Gemini permet les échanges automatisés en permettant aux développeurs d'accéder en toute sécurité aux données du marché, de passer des commandes et de gérer les comptes via des demandes HTTP authentifiées.

Aug 04, 2025 at 02:08 am

Comprendre l'API Gemini et son rôle dans le trading automatisé

L' API Gemini est un outil puissant qui permet aux développeurs et aux traders d'interagir par programme avec l'échange de crypto-monnaie Gemini. En utilisant l'API, les utilisateurs peuvent récupérer les données du marché, placer les transactions, gérer les commandes et surveiller les soldes du compte sans naviguer manuellement dans l'interface Web. La base du commerce automatisé sur les Gémeaux réside dans l'accès à cette API avec des stratégies d'authentification et d'exécution appropriées basées sur des données en temps réel. Pour commencer, les développeurs doivent générer des clés API à partir de leur compte Gemini, qui se composent d'une clé API et d'un secret correspondant. Ces informations d'identification sont utilisées pour signer des demandes et assurer une communication sécurisée. Il est essentiel d'activer l'authentification à deux facteurs (2FA) et de restreindre les autorisations de clés de l'API basées sur l'utilisation prévue - telle que permettre uniquement d'accès ou de lecture seule - pour minimiser les risques de sécurité.

Configuration de votre environnement de développement

Avant d'écrire un code, assurez-vous que votre environnement de développement prend en charge les outils nécessaires. La plupart des développeurs utilisent Python en raison de sa simplicité et de son riche écosystème de bibliothèque. Installez la bibliothèque requests pour gérer les demandes HTTP et pycryptodome ou cryptography pour la signature des demandes. Vous pouvez les installer via PIP:

• pip install requests pycryptodome

Créez un dossier de projet dédié et initialisez un environnement virtuel pour isoler les dépendances. Stockez votre clé API et secrète dans un fichier de configuration sécurisé ou des variables d'environnement - jamais les cocoter dans vos scripts. Exemple de variables d'environnement:

• GEMINI_API_KEY='your_api_key_here'
• GEMINI_API_SECRET='your_secret_here'

L'utilisation de variables d'environnement empêche l'exposition accidentelle, en particulier lors du partage de code ou de l'utilisation de systèmes de contrôle de version comme GIT.

Authentification des demandes à l'API Gemini

Chaque demande d'API privée à Gemini doit être authentifiée à l'aide du cryptage HMAC-SHA384 . Le processus consiste à construire une charge utile JSON qui comprend les détails de la demande et l'horodatage, puis la signature avec votre secret d'API. Voici comment structurer la charge utile:

• Incluez le chemin du point de terminaison
• Ajouter un nonce (un nombre ou un horodatage unique et incrément)
• Spécifiez le corps de demande le cas échéant

Exemple de charge utile:

 {'request': '/v1/balances', 'nonce': 1234567890}

Encoder cette charge utile dans Base64, puis générer la signature HMAC en utilisant votre secret. Définissez les en-têtes suivants dans votre demande HTTP:

• X-GEMINI-APIKEY : Votre clé API
• X-GEMINI-PAYLOAD : la charge utile codée sur la base64
• X-GEMINI-SIGNATURE : la représentation hexadécimale de la signature HMAC

Le défaut de signer correctement se traduit par une erreur 401 non autorisée. Testez l'authentification en récupérant le solde de votre compte à l'aide du point de terminaison /v1/balances .

Récupération des données du marché pour les décisions commerciales

Les systèmes de trading automatisés s'appuient sur des données de marché précises et en temps réel. L'API Gemini fournit plusieurs points de terminaison publics à cet effet. Utilisez le point de terminaison /v1/pubticker/symbol pour obtenir le dernier prix, offrir, demander et volume pour une paire de trading donnée. Par exemple, pour récupérer des données pour BTC / USD:

• Envoyez une demande GET à https://api.gemini.com/v1/pubticker/btcusd

La réponse comprend:

• «Demandez» : prix de vente actuel le plus bas
• 'Bid' : prix d'achat le plus élevé actuel
• `` Dernier '' : prix de transaction le plus récent
• «Volume» : Volume de trading sur 24 heures

Pour les données historiques, utilisez le point de terminaison /v2/candles/symbol/timeframe , qui renvoie les données OHLC (ouvertes, élevées, basses, clôturées). Les délais pris en charge comprennent 1m , 5m , 15m , 30m , 1h , 6h et 1d . Ces données sont essentielles pour les stratégies de backtesting et l'identification des tendances.

Passer et gérer les commandes

Une fois que votre système a des informations sur le marché, il peut exécuter des métiers. Le critère d'évaluation principal pour le placement de commande est /v1/order/new . Cela nécessite une demande de poste avec une charge utile signée contenant:

• 'symbole' : paire de trading (par exemple, 'btcusd')
• «Montant» : quantité à acheter / vendre
• 'Prix' : limiter le prix en USD
• «côté» : «acheter» ou «vendre»
• «Type» : Typiquement «Limite d'échange»

Exemple de charge utile:

 {
 'request': '/v1/order/new',
 'nonce': 1234567891,
 'symbol': 'btcusd',
 'amount': '0.01',
 'price': '50000.00',
 'side': 'buy',
 'type': 'exchange limit'
 }

Après la soumission, l'API renvoie un ID de commande , un statut et des détails d'exécution. Pour surveiller les commandes actives, utilisez /v1/orders pour récupérer toutes les commandes ouvertes. Annuler une commande avec /v1/order/cancel en incluant l'ID de commande dans la charge utile. Utiliser /v1/order/status pour vérifier l'état d'exécution d'une commande spécifique, y compris le montant rempli et le prix moyen.

Implémentation d'un bot de trading de base

Un simple bot de trading peut être construit à l'aide d'une boucle qui vérifie les prix et passe les commandes en fonction des règles prédéfinies. Commencez par définir un seuil: si le prix BTC baisse en dessous de 50 000 $, achetez 0,01 BTC. Le bot devrait:

• Retrouvez le prix BTC / USD actuel en utilisant /v1/pubticker/btcusd
• Analyser le «dernier» prix de la réponse JSON
• Comparez-le au seuil
• Si la condition est remplie et qu'aucune commande ouverte n'existe, construisez et envoyez une commande d'achat

Utilisez time.sleep() pour éviter les limites de taux - Gemini permet 120 demandes par minute pour la plupart des points de terminaison. Implémentez la gestion des erreurs pour les problèmes de réseau et la limitation du taux d'API (HTTP 429). Enregistrez toutes les actions à un fichier de débogage et d'audit. Pour des fonctionnalités améliorées, intégrez des indicateurs techniques tels que les moyennes mobiles à l'aide de bibliothèques telles que pandas .

Questions fréquemment posées

Puis-je utiliser l'API Gemini sans compte vérifié?

Non. Vous devez avoir un compte Gemini entièrement vérifié pour générer des clés API avec des autorisations de trading. Les comptes non vérifiés ne peuvent pas accéder aux points de terminaison privés ou exécuter des transactions.

Quelles sont les limites de taux sur l'API Gemini?

Gemini applique une limite de 120 demandes par minute pour la plupart des points de terminaison. Dépassant ceci se traduit par une réponse de 429 trop de demandes. Implémentez les retards ou le revers exponentiel dans votre code pour rester dans les limites.

La prise en charge de WebSocket est-elle disponible pour les données en temps réel?

Oui. Gemini propose un flux WebSocket sur wss://api.gemini.com/v1/marketdata/symbol . Cela fournit des mises à jour en temps réel sur les offres, les demandes et les métiers. Abonnez-vous en envoyant un message JSON avec le symbole et les champs facultatifs comme 'top_of_book' ou 'enchérir_events'.

Comment gérer le compromis de la clé API?

Connectez-vous immédiatement à votre compte Gemini, accédez aux paramètres de l'API et révoquez la clé compromise . Générer un nouveau et mettre à jour la configuration de votre application. Activer la liste blanche IP si possible pour restreindre l'accès aux serveurs de confiance.