Bitsgap API : exécutez votre propre algorithme de trading sur 17 plateformes d'échange

Mettre en place votre propre automatisation de trading signifiait autrefois une semaine de travail. Lire la documentation API d’une plateforme, implémenter son système de signature, gérer ses particularités, puis recommencer pour la plateforme suivante. Ajouter un serveur, intégrer une logique de reconnexion, prévoir un moyen de tester sans risquer de perdre de l’argent.

L’API Bitsgap supprime cette semaine-là. Une seule paire de clés couvre 17 plateformes d’échange, les environnements de démonstration sont déjà disponibles, et la connexion à votre plateforme d’échange est celle que vos bots utilisent déjà. Parmi les comptes ayant effectué la configuration, le délai médian entre la création d’une clé et la première requête signée réussie est de 13 minutes. L’API est incluse Free dans chaque plan, y compris le plan Free.

Ce qu’est réellement une API de trading

Une API est une liste fixe de commandes qu’un programme peut envoyer à un autre. Une API de trading est cette liste pour un Market : lire un Prix, lire un Solde, passer un Ordre, annuler un Ordre, clôturer une Position. Votre programme envoie une commande, le serveur exécute l’action et renvoie une réponse. Tout ce que vous pouvez faire en cliquant dans Bitsgap, votre code peut le faire selon son propre calendrier.

La version de Bitsgap repose sur une idée centrale appelée un topic — une entité nommée que vous souhaitez suivre. price, balance, orders, order_place. Vous nommez le topic, transmettez ses paramètres, et vous recevez soit une capture instantanée, soit un flux en temps réel de mises à jour.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

Le reste du protocole consiste à définir quels sujets existent et quels paramètres chacun d’eux accepte. Il n’y a pas de point de terminaison distinct pour chaque action et aucun second format à apprendre lorsque vous allez plus loin.

Pourquoi ne pas aller directement sur la plateforme d’échange

C’est possible, et pour une seule plateforme, c’est un choix raisonnable. Trois éléments changent dès que le nombre dépasse un.

Chaque plateforme d’échange possède son propre schéma de signature, ce qui signifie qu’un second site implique une seconde implémentation à partir de zéro. Chaque plateforme nécessite sa propre clé, à stocker et à faire tourner séparément. Et la plupart ne proposent aucun environnement de test réaliste, si bien que le nouveau code se retrouve face à de l’argent réel dès sa première exécution.

Avec Bitsgap, il s’agit d’une seule paire de clés, d’un seul schéma de signature et d’un environnement de démonstration qui se comporte comme le réel. Votre algorithme se trouve également dans le même Compte que vos bots GRID, DCA et COMBO, ce qui signifie que vos positions apparaissent au même endroit, au lieu d’être réparties entre deux systèmes qui n’en montrent chacun qu’une partie.

Treize minutes, étape par étape

1. Créez un Compte. Free plan, aucune carte requise. L’API est incluse dans chaque plan, donc aucune mise à niveau n’est nécessaire ici.

2. Générez une clé. Menu Compte → API keys → Créer une nouvelle clé. Donnez-lui un nom et une date d’expiration, puis cliquez sur Générer. La durée de validité par défaut est de trois ans.

3. Enregistrez la clé privée. Elle s’affiche une seule fois, sous forme de fichier PEM. Téléchargez-la et conservez-la comme vous le feriez pour une clé d’exchange. Si elle est perdue, elle ne peut pas être récupérée, seulement remplacée.

4. Vérifiez que votre signature fonctionne hors ligne. Les exemples officiels incluent un test signing_offline qui ne nécessite ni clé ni connexion réseau. Exécutez-le en premier. La plupart des problèmes d’intégration sont liés à la signature, et ce test permet de les détecter avant que tout autre élément n’intervienne.

5. Exécutez le guide pas à pas sur la démo. Les exemples sont fournis pour Go, Rust, Python et TypeScript, et utilisent par défaut des exchanges de démonstration. Une seule commande vous guide à travers la connexion, les données Market, les soldes, un ordre Spot, un ordre Futures et l’historique des Ordres. Aucun argent réel n’est impliqué à aucun moment.

6. Connectez-le à une vraie plateforme d’échange. Modifiez un seul chiffre — l’identifiant d’échange em — et le même code s’exécute en conditions réelles.

Comment le configurer sans avoir à écrire le code vous-même

Vous n’avez pas besoin de créer l’intégration manuellement.

La documentation complète du protocole est publique et lisible par machine, et quatre implémentations de référence complètes l’accompagnent. Donnez cette documentation à n’importe quel assistant de codage IA et décrivez-lui ce que vous souhaitez en langage simple : surveille le taux de financement sur trois paires, et lorsqu’il devient négatif sur les trois, ferme mes positions longues. Vous obtenez en retour un script fonctionnel connecté à la plateforme de démonstration, que vous pouvez exécuter et ajuster avant qu’il n’intervienne sur un Solde réel.

Cette médiane de 13 minutes s’explique par le fait que les parties complexes existent déjà en quatre langues, y compris la signature Ed25519, les chaînes de requête canoniques et la logique de reconnexion, ce qui vous laisse uniquement à rédiger la règle de trading et rien d’autre.

Le Market continue de croître à un rythme que les processus manuels ne peuvent plus suivre, si bien que le temps consacré à la configuration technique est devenu la partie la plus coûteuse de la mise en place.

Deux canaux, une seule liste de sujets

Les deux canaux traitent les mêmes sujets avec les mêmes paramètres. REST convient à un programme qui s’active, pose une question, puis se rendort. WebSocket s’adresse à un programme qui reste actif et réagit en temps réel.

Sur REST, la réponse à une commande confirme que la tâche a été acceptée, mais pas qu’elle est terminée. Le résultat de l’exécution arrive via une plan d'abonnement WebSocket sur orders, positions ou balance, ou en interrogeant à nouveau ces sujets. Le compteur de limitation de débit est partagé entre les deux canaux, donc changer de mode de transport n’augmente pas le budget disponible.

À quoi vous avez accès

Appelez d'abord conf_enums. Cette commande renvoie les tables de référence qui transforment les noms d’exchange en identifiants numériques em attendus par tous les autres topics — Binance correspond à 2, Binance demo à 101. Le topic manual renvoie le catalogue en temps réel de chaque topic avec ses limites de taux actuelles, afin que votre code puisse lire ces limites au lieu de les coder en dur.

Un champ à utiliser dès le premier jour : apiid. Il s’agit de votre propre étiquette sur un ordre, jusqu’à 250 caractères, qui vous sera renvoyée dans chaque rapport futur concernant cet ordre. Indiquez-y le nom et la version de votre stratégie. Lorsque deux de vos programmes effectuent des transactions sur la même paire, cette étiquette est le seul élément qui vous permet de savoir lequel a placé quoi.

L’API Bitsgap est-elle sûre à connecter ?

La connexion de Bitsgap à votre exchange ne change pas. Elle est limitée aux opérations de trading et n’a jamais eu de droits de retrait. L’API ajoute une connexion distincte entre votre programme et Bitsgap, signée avec une paire de clés Ed25519 que vous générez et contrôlez. Ed25519 est un système de signature, et non un mot de passe : vous détenez la clé privée, Bitsgap ne conserve que la clé publique, et le secret ne transite jamais sur le réseau. Les requêtes ne peuvent pas être rejouées, car chacune comporte un nonce unique et un horodatage qui expire au bout de dix secondes. Révoquez la clé et toutes les sessions ouvertes sont immédiatement interrompues.

Les limites, en chiffres

Deux de ces éléments influencent la façon dont vous construisez. Les compteurs de débit sont partagés entre REST et WebSocket par sujet, donc une boucle de polling consomme le budget dont une Plan d'abonnement en direct a besoin. Et dépasser le taux de messages par connexion ferme le socket au lieu de rejeter le message, donc la logique de reconnexion doit inclure un backoff, une nouvelle trame d’authentification et une nouvelle souscription.

Trois éléments font échouer les premières tentatives, dans cet ordre : une horloge non synchronisée, un nonce réutilisé et la re-sérialisation du corps de la requête après sa signature. La charge utile est signée octet par octet, donc une clé réordonnée ou un espace supplémentaire produit une signature différente. Envoyez exactement la chaîne que vous avez signée.

Testez-le sans rien dépenser

Les exchanges de démonstration fonctionnent comme les vrais. Ordres, exécutions, positions, soldes, tout cela sans aucun argent réel en jeu. demo_market_reset réinitialise le Compte à son état initial, ce qui vous permet de pousser une stratégie jusqu’au bout puis de recommencer en une seule commande.

L’API est gratuite sur chaque plan, y compris le plan Free à 0 $. Pas de carte, pas de mise à niveau, pas de période d’Essai. Créez un Compte, générez une clé et commencez à signer des requêtes dès aujourd’hui.

FAQ

Qu'est-ce que l'API Bitsgap ? Une API publique qui permet à votre propre programme de lire les données de Market et de passer des ordres sur n'importe quelle plateforme connectée à votre Compte Bitsgap. Les canaux REST et WebSocket partagent une liste de sujets unique, authentifiée à l'aide d'une paire de clés Ed25519 que vous générez et contrôlez.

L’API Bitsgap est-elle gratuite ? Oui. Elle est incluse dans chaque plan, y compris le plan Free, sans coût supplémentaire.

Ai-je besoin de savoir coder ? Vous devez être capable d’exécuter un script. L’écriture du script est en grande partie facultative : la documentation du protocole et quatre implémentations de référence complètes sont publiques, donc un assistant de codage IA peut produire une intégration fonctionnelle à partir d’une description en langage courant.

Quels langages de programmation sont pris en charge ? Tout langage capable d’effectuer une requête HTTPS et de calculer une signature Ed25519. Des exemples officiels prêts à l’emploi sont fournis en Go, Rust, Python et TypeScript.

L’API peut-elle retirer mes fonds ? Non. Bitsgap se connecte à votre plateforme d’échange avec une clé dédiée uniquement au trading, qui n’a jamais eu de droits de retrait, et l’API ne modifie pas cela. Elle ajoute un canal signé distinct entre votre programme et Bitsgap, révocable à tout moment.

REST ou WebSocket — lequel choisir ? REST pour des requêtes ponctuelles et des scripts planifiés. WebSocket pour tout ce qui doit réagir aux mouvements de prix ou suivre l’état des ordres en temps réel.

Puis-je tester sans argent réel ? Oui. Les exemples officiels utilisent par défaut des plateformes de démonstration, et le Compte de démonstration peut être réinitialisé à ses soldes de départ à tout moment.

Combien de temps faut-il pour configurer ? Le temps médian entre la création d’une Clé API et l’envoi d’une première requête signée réussie est de 13 minutes, selon les comptes Bitsgap ayant effectué cette connexion. [Add measurement window before publish]