Comment utiliser l'API Coinbase pour le trading à terme?

Pour négocier les contrats à terme sur Coinbase via l'API, créez une clé avec les autorisations "commerciales", utilisez l'API commerciale avancée et incluez le type de levier et de marge dans votre commande - surveillez toujours le risque de liquidation. (154 caractères)

Jul 27, 2025 at 01:01 am

Comprendre l'API Coinbase pour le trading à terme

L'API Coinbase permet aux développeurs et aux traders d'interagir par programme avec les produits financiers de Coinbase, y compris les contrats à terme . Contrairement au trading au comptant, les contrats à terme impliquent des contrats qui obligent l'acheteur ou le vendeur à transformer un actif à une date et un prix futurs prédéterminés. Pour utiliser l'API pour les contrats à terme, vous devez d'abord comprendre que Coinbase offre cette fonctionnalité via son API Trade Advanced COINBase , qui prend en charge les protocoles REST et WebSocket. Avant de lancer des métiers, assurez-vous que vous avez créé une clé API avec les autorisations correctes, en particulier, la portée du «commerce» pour les contrats à terme. Sans cela, vos demandes renverront une erreur 403.

Configuration de votre clé API pour l'accès à terme

Pour commencer, connectez-vous à votre compte Coinbase et accédez à la section Paramètres de l'API . Cliquez sur «Créer une nouvelle clé API» et attribuez un nom tel que «FuturesBot». Dans le panneau des autorisations, sélectionnez:

• Voir
• Commerce
• Transfert
  Assurez-vous d'activer la liste blanche IP pour plus de sécurité. Une fois enregistré, Coinbase affichera votre clé API, votre secret et votre phrase secrète. Stockez-les en toute sécurité, jamais dans les référentiels publics ou le code côté client. La touche API doit être transmise dans l'en-tête CB-ACCESS-KEY , la phrase de passe dans CB-ACCESS-PASSPHRASE et le horodatage dans CB-ACCESS-TIMESTAMP . La clé secrète est utilisée pour signer chaque demande en utilisant HMAC SHA256 .
  

  Placer une commande à terme via l'API REST

  
  Pour passer une commande à terme, envoyez une demande de poste à https://api.coinbase.com/api/v3/brokerage/orders . Le corps doit inclure:
• client_order_id : un identifiant unique que vous générez
• product_id : Format comme BTC-USD-FUTURE
• side : 'BUY' ou 'SELL'
• order_type : Utilisez 'LIMIT' pour le contrôle des prix
• price : Format de chaîne, par exemple, '50000.00'
• size : quantité en tant que chaîne, par exemple, '0.01'
• leverage : réglé entre 1x et 5x en tant que chaîne, par exemple, '3'
• margin_type : doit être 'ISOLATED' pour les futurs
  Les en-têtes doivent inclure vos jetons d'authentification. La réponse renverra un order_id en cas de succès. Si la demande échoue, inspectez le champ message - par exemple, la marge insuffisante renvoie 'Insufficient margin available' .
  

  Gestion des postes et des marges avec des points de terminaison API

  
  Après avoir passé une commande, surveillez vos positions en utilisant le point de terminaison GET https://api.coinbase.com/api/v3/brokerage/positions . Cela renvoie des positions à terme actifs, notamment:
• size : Taille de position actuelle
• entry_price : entrée moyenne en USD
• unrealized_pnl : profit / perte flottante
• liquidation_price : prix auquel le poste fera automatiquement
  Pour ajuster l'effet de levier sur une position ouverte, utilisez POST /api/v3/brokerage/positions/leverage . Le corps doit inclure:
• product_id : Identique à la position ouverte
• leverage : nouvel effet de levier en tant que chaîne (par exemple, '2' )
  Ceci est critique - si votre position approche du prix de liquidation, la réduction de l'effet de levier peut empêcher la fermeture forcée.
  

  Annuler et clôturer les ordres à terme par programme

  
  Pour annuler une commande non remplie, envoyez une demande de suppression à /api/v3/brokerage/orders/{order_id} . Remplacez {order_id} par l'ID à partir de la réponse initiale de l'ordre. Pour clôturer un poste, soumettez une nouvelle commande avec le côté opposé et la taille de correspondance. Par exemple, si vous tenez une position longue de 0,01 BTC, passez une commande SELL avec size: '0.01' . L'API ne prend pas en charge la fermeture de position en un clic - cela doit être fait manuellement via des ordres opposés. Vérifiez toujours la taille de la position via le point de terminaison des positions avant de fermer pour éviter les fermetures partielles ou la sur-vente.
  

  Gestion des erreurs et des limites de taux

  
  L'API Coinbase applique les limites de taux: 10 demandes par seconde par touche API . Le dépassement renvoie une erreur 429. Implémentez le revers exponentiel dans votre code - attendez 1 seconde, puis 2, puis 4, etc., après chaque échec. Les erreurs courantes comprennent:
• 400 Bad Request : Vérifiez le formatage JSON - Assurer tous les champs requis sont des chaînes
• 401 Unauthorized : Vérifiez l'horodatage et la génération de signature
• 403 Forbidden : Confirmer la clé de l'API a une portée «échange»
• 422 Unprocessable Entity : NUMALID PRODUCT_ID OU EFFET
  Enregistrez toutes les réponses aux questions de débogage. Utilisez des outils comme Postman ou Curl pour tester les points de terminaison avant de vous intégrer dans des bots de trading en direct.
  

  Questions fréquemment posées

  Puis-je utiliser la même clé API pour le trading Spot et Futures?
  
  Oui, mais seulement si la clé a les autorisations «View» et «Trade» activées. Les points de terminaison spécifiques aux futurs nécessiteront toujours le format Product_id correct (par exemple, ETH-USD-FUTURE ), qui diffère de ETH-USD de Spot.

  Que se passe-t-il si ma position à terme est liquidée?
  
  L'API fermera automatiquement la position lorsque le prix de marque atteindra le niveau de liquidation. Vous ne recevrez aucune notification via l'API - CONITEUR liquidation_price À partir du point de terminaison des positions et configurez les alertes en externe.

  TestNet est-il disponible pour le développement de l'API à terme?
  
  Non, Coinbase n'offre pas de test à terme. Utilisez une petite quantité de capital réel dans un compte Sandbox ou simulez la logique de commande localement avant le déploiement.

  Comment calculer la marge requise pour une commande à terme?
  
  Marge requise = (prix × taille) / effet de levier. Pour une commande de 0,01 BTC à 50 000 $ avec un effet de levier 3X: (50000 × 0,01) / 3 = 166,67 $ . Assurez-vous que votre compte détient au moins ce montant en USD ou en stablecoins.