Comment puis-je utiliser l'API Coinbase pour échanger des contrats?

Comprendre l'API Coinbase et ses capacités

L' API Coinbase est un outil puissant qui permet aux développeurs et aux traders d'interagir par programme avec les services financiers de Coinbase. Bien que Coinbase propose un large éventail de fonctionnalités, notamment le trading ponctuel, la gestion des portefeuilles et la récupération des données des prix, il est crucial de clarifier que Coinbase ne prend actuellement pas en charge les contrats à terme sur le trading ou les contrats perpétuels via son API standard. L'objectif principal de l'API commercial Advanced Coinbase est le trading au comptant , ce qui signifie l'achat et la vente de crypto-monnaies réelles aux prix actuels du marché.

Malgré cela, de nombreux utilisateurs confondent Coinbase avec Coinbase Derivatives ou Coinbase International Exchange , qui sont des entités distinctes offrant un trading à terme. Ces plateformes fonctionnent sous différents cadres réglementaires et API. Si votre objectif est d'échanger des contrats tels que des contrats à terme ou des options, vous devez confirmer si vous utilisez le bon service affilié à Coinbase. À l'heure actuelle, l'API commercial Advanced Coinbase ne prend en charge que les opérations du marché au comptant, y compris les commandes limites, les commandes du marché et les commandes d'arrêt de paires de crypto-monnaie.

Pour commencer à utiliser l'API, vous devez d'abord créer un compte sur Coinbase Advanced Trade et générer des clés d'API. Ces clés accorderont l'accès de votre demande à votre compte de trading, il est donc essentiel de gérer attentivement les autorisations. Lors de la génération de clés, vous pouvez attribuer des rôles spécifiques tels que «voir», «échange» ou «transfert». À des fins de négociation, assurez-vous que l'autorisation «échange» est activée.

Configuration de vos clés API Coinbase

Avant d'effectuer des métiers, vous devez authentifier vos demandes à l'aide d'identification API. Voici comment générer et configurer vos clés:

• Connectez-vous à votre compte commercial avancé Coinbase
• Accédez à Paramètres> API
• Cliquez sur + nouvelle clé API
• Sélectionnez les autorisations appropriées: «Afficher» et «commerce»
• Entrez un nom pour votre clé (par exemple, «Bot Trading»)
• Compléter l'authentification à deux facteurs (2FA)
• Copiez la clé API générée, le secret et la phrase secrète

Stockez ces références en toute sécurité. Le secret et la phrase de passe ne sont affichés qu'une seule fois et ne peuvent pas être récupérés s'ils sont perdus. Ne les exposez jamais dans le code côté client ou les référentiels publics.

Une fois que vous avez vos clés, vous pouvez commencer à les intégrer dans votre application. L'API utilise l'authentification HMAC-SHA256 . Chaque demande doit inclure les en-têtes suivants:

• CB-ACCESS-KEY : Votre clé API
• CB-ACCESS-SIGN : La signature HMAC du message
• CB-ACCESS-TIMESTAMP : L'horodatage Unix de la demande
• CB-ACCESS-PASSPHRASE : La phrase de passe que vous définissez

La signature est générée par hachage de la concaténation de l'horodatage, de la méthode HTTP, du chemin de demande et du corps (le cas échéant) en utilisant votre secret.

Faire des métiers de spots via l'API Coinbase

Bien que le trading contractuel ne soit pas pris en charge, vous pouvez exécuter des transactions ponctuelles à l'aide de l'API commerciale avancée. Ces transactions impliquent l'échange immédiat de crypto-monnaies aux prix actuels du marché. Pour passer une commande, vous utiliserez le point de terminaison «Créer l'ordre» .

Voici un exemple de placement une commande d'achat de limite pour BTC-USD:

• Méthode HTTP: POST
• Point de terminaison: https://api.coinbase.com/api/v3/brokerage/orders
• Corps de demande:

   { 'client_order_id': 'unique-id-123', 'product_id': 'BTC-USD', 'side': 'BUY', 'order_configuration': { 'limit_limit_gtc': { 'base_size': '0.001', 'limit_price': '30000.00'

  } } }

Les paramètres clés comprennent:

• client_order_id : un identifiant unique pour votre commande
• product_id : la paire de trading (par exemple, BTC-USD)
• side : «acheter» ou «vendre»
• base_size : la quantité de crypto-monnaie à échanger
• limit_price : le prix maximum que vous êtes prêt à payer

Assurez-vous que votre compte a un solde USD suffisant pour les achats ou le solde BTC pour les ventes. Les commandes sont exécutées en fonction de la disponibilité du marché et peuvent être partiellement remplies.

Pour vérifier l'état de la commande, utilisez le point de terminaison «Get Order» avec l' order_id renvoyé dans la réponse. Vous pouvez également répertorier toutes les commandes à l'aide du point de terminaison «List Orders» avec des filtres pour l'état (ouvert, rempli, annulé).

Récupération des données du marché et surveillance des prix

Le trading réussi nécessite des informations à jour sur le marché. L'API Coinbase fournit plusieurs points de terminaison pour récupérer des données en temps réel et historiques.

Pour obtenir la dernière meilleure offre et demander des prix pour un produit:

• Point de terminaison: GET /api/v3/brokerage/product/book?product_id=BTC-USD&limit=1
• La réponse comprend:
  • price et size pour la première offre
  • price et size pour le haut demande

Pour les données de chandelier (utilisées dans l'analyse technique), utilisation:

• Point de terminaison: GET /api/v3/brokerage/market/products/BTC-USD/candles
• Paramètres de requête: type=1_MINUTE , start=1700000000 , end=1700003600

Cela renvoie les valeurs OHLC (ouvertes, élevées, faibles, clôturées) pour la plage de temps et l'intervalle spécifiés.

Vous pouvez également récupérer le carnet de commandes avec plusieurs niveaux:

• limit=50 donne les 50 premières offres et demande
• Utilisez ces données pour analyser la profondeur du marché et anticiper les mouvements des prix

L'intervention de ces points de terminaison à intervalles réguliers vous permet de créer un tableau de bord de trading en direct ou d'automatiser la logique de prise de décision.

Gestion des erreurs et des limites de taux

L'API Coinbase applique des limites de taux pour prévenir les abus. Pour le trading des points de terminaison, la limite est généralement de 10 demandes par seconde par touche API. Dépassant ceci se traduit par une réponse 429 Too Many Requests . Pour éviter ceci:

• Implémentez le backoff exponentiel dans votre logique de nouvelle tentative
• Réponses de cache lorsque cela est possible
• Utilisez des lignes Web pour des données en temps réel au lieu d'un sondage fréquent

Les codes d'erreur courants comprennent:

• 401 Unauthorized : des références API non valides ou manquantes
• 403 Forbidden : autorisation insuffisante
• 404 Not Found : ID de produit ou identifiant de commande non valide
• 400 Bad Request : JSON mal formé ou paramètres non valides

Valider toujours les erreurs d'entrée et de gérer gracieusement. Par exemple, vérifiez si un ID de produit comme Eth-USD est pris en charge avant de passer une commande.

Questions fréquemment posées

Puis-je échanger à terme sur Coinbase en utilisant l'API? Non, l' API commercial Advanced Coinbase ne soutient pas les contrats à terme ou les contrats perpétuels. Il est limité à l'échange de points uniquement. Le trading à terme est disponible sur les dérivés Coinbase , qui peuvent avoir une interface API distincte.

Quelle est la différence entre Coinbase et Coinbase Advanced Trade API? Coinbase.com est la plate-forme orientée vers le consommateur pour acheter de la crypto avec Fiat. L' API commerciale avancée est une interface de qualité professionnelle pour le trading automatisé, offrant un accès programmatique aux marchés au comptant, aux livres de commandes et aux données de tarification.

Comment annuler une commande ouverte via l'API? Utilisez le point de terminaison DELETE /api/v3/brokerage/orders/{order_id} . Remplacez {order_id} par l'identifiant d'ordre réel. La réponse confirme l'annulation ou renvoie une erreur si la commande est déjà remplie ou non valide.

Est-il sûr d'utiliser des clés API pour le trading automatisé? Oui, si les meilleures pratiques sont suivies. Utilisez des phrases de passe solides et uniques , restreignez les autorisations à ce qui est nécessaire, stockez des clés dans des environnements cryptés et évitez les coder en dur dans les scripts. Envisagez d'utiliser la liste blanche IP si disponible.