Bitsgap API: Führen Sie Ihren eigenen Handelsalgorithmus auf 17 Börsen aus

Die Einrichtung einer eigenen Trading-Automatisierung bedeutete früher eine Woche Arbeit. Die API-Dokumentation einer Börse lesen, das Signaturverfahren implementieren, sich mit den Eigenheiten der jeweiligen Plattform auseinandersetzen – und das Ganze dann für die nächste Börse wiederholen. Einen Server einrichten, eine Wiederverbindungslogik hinzufügen und eine Möglichkeit schaffen, ohne Geldverlust zu testen.

Die Bitsgap API eliminiert diese Woche. Ein Schlüsselpaar deckt 17 Börsen ab, die Demoplattformen sind bereits integriert, und die Verbindung zu Ihrer Börse ist dieselbe, die Ihre Bots bereits nutzen. Bei den Konten, die dies eingerichtet haben, beträgt die mittlere Zeit vom Erstellen eines Schlüssels bis zur ersten erfolgreich signierten Anfrage 13 Minuten. Die API ist in jedem Tarif kostenlos enthalten, auch im Free Tarif.

Was eine Trading-API eigentlich ist

Eine API ist eine festgelegte Liste von Befehlen, die ein Programm an ein anderes senden kann. Eine Trading-API ist diese Liste für einen Market: einen Preis abfragen, einen Saldo abfragen, eine Order platzieren, eine Order stornieren, eine Position schließen. Ihr Programm sendet einen Befehl, der Server erledigt die Arbeit und schickt eine Antwort zurück. Alles, was Sie per Klick in Bitsgap tun können, kann Ihr Code nach seinem eigenen Zeitplan ausführen.

Die Version von Bitsgap basiert auf einer einzigen Idee, die als Topic bezeichnet wird – ein benanntes Objekt, das Sie benötigen. price, balance, orders, order_place. Sie benennen das Topic, übergeben die entsprechenden Parameter und erhalten entweder einen einzelnen Snapshot oder einen Live-Stream mit Updates zurück.

json

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

Der Rest des Protokolls besteht darin, welche Themen existieren und welche Parameter jedes einzelne benötigt. Es gibt keinen separaten Endpunkt für jede Aktion und kein zweites Format, das man lernen muss, wenn man tiefer einsteigt.

Warum nicht direkt zur Börse gehen

Das können Sie tun, und für eine einzelne Börse ist das eine sinnvolle Entscheidung. Drei Dinge ändern sich jedoch, sobald die Anzahl über eins hinausgeht.

Jede Börse hat ihr eigenes Signaturverfahren, daher bedeutet eine zweite Plattform auch eine zweite Implementierung von Grund auf. Für jede Börse wird ein eigener Schlüssel benötigt, der separat gespeichert und regelmäßig ausgetauscht werden muss. Und die meisten bieten keine realistische Testumgebung, sodass neuer Code beim ersten Einsatz direkt auf echtes Geld trifft.

Über Bitsgap gibt es ein einziges Schlüsselpaar, ein Signaturschema und eine Demoumgebung, die sich wie die Live-Umgebung verhält. Ihr Algorithmus befindet sich außerdem im selben Konto wie Ihre GRID-, DCA- und COMBO-Bots, sodass Ihre Positionen an einem Ort angezeigt werden, anstatt dass zwei Systeme jeweils nur die halbe Übersicht bieten.

Dreizehn Minuten, Schritt für Schritt

1. Erstellen Sie ein Konto. Free-Tarif, keine Karte erforderlich. Die API ist in jedem Tarif enthalten, daher ist hier kein Upgrade nötig.

2. Einen Schlüssel generieren. Konto-Menü → API keys → Neuen Schlüssel erstellen. Geben Sie ihm einen Namen und ein Ablaufdatum, dann auf Generieren klicken. Die Standardlaufzeit beträgt drei Jahre.

3. Speichern Sie den privaten Schlüssel. Er wird einmalig als PEM-Datei angezeigt. Laden Sie ihn herunter und bewahren Sie ihn so auf, wie Sie auch einen Exchange-Schlüssel speichern würden. Geht er verloren, kann er nicht wiederhergestellt, sondern nur ersetzt werden.

4. Überprüfen Sie, ob Ihre Signierung offline funktioniert. Die offiziellen Beispiele enthalten einen signing_offline-Test, der weder einen Schlüssel noch eine Netzwerkverbindung benötigt. Führen Sie diesen Test zuerst aus. Die meisten Integrationsprobleme sind Signaturprobleme, und so werden diese erkannt, bevor andere Faktoren ins Spiel kommen.

5. Führen Sie das Walkthrough mit der Demo aus. Die Beispiele sind für Go, Rust, Python und TypeScript verfügbar und verwenden standardmäßig Demo-Börsen. Ein einziger Befehl führt Sie durch die Verbindung, Market-Daten, Kontostände, eine Spot-Order, eine Futures-Order und die Order-Historie. Zu keinem Zeitpunkt ist echtes Geld im Spiel.

6. Verbinden Sie es mit einer echten Börse. Ändern Sie nur eine Zahl — die em exchange ID — und derselbe Code läuft live.

Wie Sie es einrichten, ohne den Code selbst schreiben zu müssen

Sie müssen die Integration nicht manuell erstellen.

Die vollständige Protokollreferenz ist öffentlich und maschinenlesbar, und vier vollständige Referenzimplementierungen stehen direkt daneben. Geben Sie diese Dokumentation einem beliebigen KI-Coding-Assistenten und beschreiben Sie in einfacher Sprache, was Sie möchten: Beobachte die Funding Rate bei drei Paaren und sobald sie bei allen drei negativ wird, schließe meine Long-Positionen. Sie erhalten ein funktionierendes Skript, das auf das Demokonto ausgerichtet ist und das Sie ausführen und anpassen können, bevor es einen echten Saldo berührt.

Dieser Medianwert von 13 Minuten bleibt bestehen, weil die anspruchsvollen Komponenten bereits in vier Sprachen vorhanden sind, darunter Ed25519-Signierung, kanonische Request-Strings und Reconnect-Logik. So bleibt Ihnen nur noch das Schreiben der Trading-Regel – und sonst nichts.

Der Market wächst schneller, als jeder manuelle Prozess mithalten kann, sodass die auf technische Grundlagen verwendete Zeit mittlerweile zum teuersten Teil der Einrichtung geworden ist.

Zwei Kanäle, eine Themenliste

Beide Kanäle behandeln die gleichen Themen mit denselben Parametern. REST ist für ein Programm gedacht, das aufwacht, eine Frage stellt und wieder einschläft. WebSocket ist für eines, das wach bleibt und reagiert.

Über REST bestätigt die Antwort auf einen Befehl, dass die Aufgabe angenommen wurde, nicht dass sie abgeschlossen ist. Das Ausführungsergebnis wird über ein WebSocket-Abonnement auf orders, positions oder balance übermittelt oder indem diese Themen erneut abgefragt werden. Der Rate-Limit-Zähler wird zwischen beiden Kanälen geteilt, daher verschafft ein Wechsel des Übertragungswegs kein zusätzliches Budget.

Worauf Sie Zugriff erhalten

Rufen Sie zuerst conf_enums auf. Diese Funktion gibt die Referenztabellen zurück, mit denen Börsennamen in die numerischen em-IDs umgewandelt werden, die in allen anderen Themen erwartet werden — Binance ist 2, Binance demo ist 101. Das Thema manual liefert den aktuellen Katalog aller Themen mit ihren jeweiligen aktuellen Ratenlimits, sodass Ihr Code die Limits auslesen kann, anstatt sie fest zu programmieren.

Ein Feld, das Sie von Anfang an nutzen sollten: apiid. Es ist Ihr eigenes Tag an einer Order, bis zu 250 Zeichen lang, und erscheint in jedem zukünftigen Bericht zu dieser Order wieder. Tragen Sie dort einen Strategienamen und die Version ein. Wenn zwei Ihrer Programme dasselbe Paar traden, ist dieses Tag das Einzige, was Ihnen zeigt, welches Programm welche Order platziert hat.

Ist die Bitsgap API sicher zu verbinden?

Die Verbindung von Bitsgap zu Ihrer Börse bleibt unverändert. Sie ist ausschließlich für den Handel vorgesehen und hatte niemals Auszahlungsrechte. Die API stellt eine separate Verbindung zwischen Ihrem Programm und Bitsgap her, die mit einem Ed25519-Schlüsselpaar signiert wird, das Sie selbst erzeugen und kontrollieren. Ed25519 ist ein Signaturschema und kein Passwort: Sie besitzen den privaten Schlüssel, Bitsgap speichert nur den öffentlichen Schlüssel, und das Geheimnis verlässt niemals das Netzwerk. Anfragen können nicht wiederholt werden, da jede einen neuen Nonce und einen Zeitstempel enthält, der nach zehn Sekunden abläuft. Widerrufen Sie den Schlüssel, werden alle offenen Sitzungen sofort beendet.

Die Limits, in Zahlen

Zwei davon beeinflussen, wie Sie aufbauen. Ratenzähler werden pro Thema zwischen REST und WebSocket geteilt, sodass eine Polling-LOOP das Budget verbraucht, das ein Live-Abonnement benötigt. Und wenn die Nachrichtenrate pro Verbindung überschritten wird, wird der Socket geschlossen, anstatt die Nachricht abzulehnen – daher muss die Reconnect-Logik ein Backoff, einen neuen Auth-Frame und ein erneutes Abonnement enthalten.

Drei Dinge führen bei ersten Versuchen am häufigsten zum Scheitern, und zwar in dieser Reihenfolge: eine nicht synchronisierte Uhr, eine wiederverwendete Nonce und das erneute Serialisieren des Request-Bodys nach dem Signieren. Das Payload wird Byte für Byte signiert, daher führt schon eine umsortierte Schlüsselreihenfolge oder ein zusätzliches Leerzeichen zu einer anderen Signatur. Senden Sie exakt den String, den Sie signiert haben.

Testen Sie es, ohne etwas auszugeben

Demo-Börsen verhalten sich wie die echten. Orders, Ausführungen, Positionen und Guthaben – alles ohne echtes Geld im Spiel. demo_market_reset setzt das Konto auf den Anfangszustand zurück, sodass Sie eine Strategie bis zum Ende testen und mit nur einem Befehl neu starten können.

Die API ist in jedem Tarif kostenlos, auch im $0 Free Tarif. Keine Karte, kein Upgrade, keine Testversion. Erstellen Sie ein Konto, generieren Sie einen Schlüssel und beginnen Sie noch heute mit dem Signieren von Anfragen.

FAQ

Was ist die Bitsgap API? Eine öffentliche API, mit der Ihr eigenes Programm Marktdaten auslesen und Trades auf jeder mit Ihrem Bitsgap-Konto verbundenen Börse platzieren kann. REST- und WebSocket-Kanäle teilen sich eine gemeinsame Themenliste, authentifiziert mit einem Ed25519-Schlüsselpaar, das Sie selbst erzeugen und verwalten.

Ist die Bitsgap API kostenlos? Ja. Sie ist in jedem Tarif enthalten, auch im Free-Tarif, und verursacht keine zusätzlichen Kosten.

Muss ich programmieren können? Sie müssen in der Lage sein, ein Skript auszuführen. Das Schreiben ist größtenteils optional: Die Protokollreferenz und vier vollständige Referenzimplementierungen sind öffentlich zugänglich, sodass ein KI-Coding-Assistent anhand einer Beschreibung in Alltagssprache eine funktionierende Integration erstellen kann.

Welche Programmiersprachen werden unterstützt? Jede Sprache, die HTTPS-Anfragen stellen und eine Ed25519-Signatur berechnen kann. Offizielle, ausführbare Beispiele sind in Go, Rust, Python und TypeScript verfügbar.

Kann die API meine Gelder abheben? Nein. Bitsgap verbindet sich mit Ihrer Börse über einen reinen Handelsschlüssel, der niemals Abhebungsrechte hatte, und die API ändert daran nichts. Sie fügt einen separaten, signierten Kanal zwischen Ihrem Programm und Bitsgap hinzu, der jederzeit widerrufen werden kann.

REST oder WebSocket – was sollte ich verwenden? REST für einmalige Abfragen und geplante Skripte. WebSocket für alles, was auf Preisbewegungen reagieren oder den Order-Status in Echtzeit verfolgen muss.

Kann ich ohne echtes Geld testen? Ja. Die offiziellen Beispiele verwenden standardmäßig Demo-Börsen, und das Demokonto kann jederzeit auf seine Startguthaben zurückgesetzt werden.

Wie lange dauert die Einrichtung? Die mittlere Zeit vom Erstellen eines API-Schlüssels bis zur ersten erfolgreichen signierten Anfrage beträgt 13 Minuten, gemessen über Bitsgap-Konten, die einen verbunden haben. [Add measurement window before publish]