Inhalt

  • Einführung

  • Voraussetzungen

    • Netzwerkschlüssel testen

    • Laden Sie Postman herunter und installieren Sie es

  • Eine Umgebung schaffen

  • Importieren Sie eine Sammlung

  • Ausführung von Anfragen

  • Abschließende Gedanken


Einführung

Das Verstehen und Verwenden der Kryptowährungs-Handels-API kann eine Welt voller Möglichkeiten eröffnen, wenn es um den Ein- und Ausstieg aus Positionen geht. Mit einigen grundlegenden Programmierkenntnissen können Sie eine Verbindung zum Backend der Börse herstellen, um Ihre Handelsstrategien zu automatisieren. Durch die Umgehung der Website gelangen Sie viel schneller zur passenden Engine für Hochleistungsanwendungen.

Der Zweck dieser Serie besteht darin, Ihnen die Binance REST API vorzustellen und Ihnen beizubringen, wie Sie damit interagieren. Letztendlich sollten Sie sicher sein, dass Sie in der Lage sind, die Märkte und Ihre Positionen abzufragen und verschiedene Arten von Aufträgen zu platzieren.

In diesem Artikel verwenden wir Postman, um mit der Börse zu kommunizieren. Machen Sie sich keine Sorgen – wir setzen kein echtes Geld aufs Spiel.


Voraussetzungen

Netzwerkschlüssel testen

Wir werden für unsere Zwecke ein Testnetz verwenden. Dadurch erhalten wir einige Fonds, die keinen wirklichen Wert haben und mit denen wir experimentieren können. Sie funktionieren genau wie echte Münzen und Token. Sobald Sie sich also an die API gewöhnt haben, können Sie damit beginnen, mit echtem Geld zu handeln.


  1. Gehen Sie zunächst zum Spot Test Network.

  2. Sie müssen mit einem GitHub-Konto angemeldet sein, um Zugriff zu erhalten. Erstellen Sie es, falls Sie es noch nicht getan haben.

  3. Klicken Sie auf „Authentifizieren“ und melden Sie sich mit GitHub an.

  4. Im Abschnitt „API-Schlüssel“ sehen Sie, dass Sie keine registrierten Schlüssel haben. Klicken Sie auf „HMAC_SHA256-Schlüssel generieren“, um ein Paar zu generieren.

  5. Geben Sie auf dem nächsten Bildschirm den Tasten eine Beschriftung. Benennen Sie sie nach Ihren Wünschen und klicken Sie auf „Generieren“.

  6. Ihnen werden zwei Schlüssel angezeigt: API Key und Secret Key. Es ist wichtig, sie jetzt aufzuschreiben. Wenn Sie dies nicht tun, müssen Sie den Schlüsselgenerierungsprozess erneut starten. Wir empfehlen, sie in einer Notizanwendung auf Ihrem Computer zu speichern, um sie später einfach kopieren zu können.

Hinweis: Wenn Sie eine Live-Börse zur Verwaltung verschiedener Schlüssel verwenden, sollten Sie Ihre Schlüssel kennzeichnen. Ihr Konto kann mehrere Schlüssel mit unterschiedlichen Berechtigungen haben. Wenn Sie mehrere Trading-Bots verwenden, erleichtert die Verwendung einzelner Schlüssel mit beschreibenden Bezeichnungen die Verwaltung von Berechtigungen oder das Entfernen einzelner Schlüssel, ohne alle Ihre Bots ändern zu müssen.


Laden Sie Postman herunter und installieren Sie es

Postman ist eine Plattform für die API-Zusammenarbeit. Dies ist ein perfekter Ausgangspunkt für uns – wir haben Zugriff auf Binance-Abfragesammlungen zum Testen, ohne eine einzige Codezeile schreiben zu müssen.

Das Programm ist für Mac, Windows und Linux verfügbar. Gehen Sie zur Seite „Downloads“ und laden Sie die ZIP-Datei herunter.

Suchen Sie es anschließend im Explorer und installieren Sie es. Öffnen Sie die App, um loszulegen. Bitte beachten Sie, dass Sie zum Anmelden ein Konto erstellen können, dies jedoch nicht erforderlich ist. Wenn Sie diesen Schritt überspringen möchten, wählen Sie einfach die entsprechende Option unten im Fenster aus.


Eine Umgebung schaffen

Zu diesem Zeitpunkt sollten Sie über eine Schnittstelle verfügen, die der folgenden ähnelt.



Zuerst müssen Sie eine Umgebung erstellen. Es handelt sich lediglich um eine Möglichkeit, Variablen zu den Abfragen hinzuzufügen, mit denen wir arbeiten werden. Dazu müssen wir zunächst einige Informationen aus dem Binance GitHub-Repository abrufen. Gehen Sie hierher und laden Sie die ZIP-Datei herunter.



Der Download wird nicht lange dauern. Suchen Sie es in Ihrem Datei-Explorer und entpacken Sie es. Dann können wir zu Postman zurückkehren.



Klicken Sie auf das Zahnradsymbol in der oberen rechten Ecke (wie oben gezeigt). Sie sehen ein Popup-Fenster „Umgebungen verwalten“.

  1. Wählen Sie „Importieren“ und navigieren Sie zum neu entpackten Ordner (binance-postman-api).

  2. Geben Sie dann den Umgebungsordner ein.

  3. Sie sehen nun zwei Dateien (eine für das Hauptnetzwerk, eine für das Testnetzwerk). Wir suchen nach binance_com_spot_testnet_api.postman_environment.json. Stellen Sie sicher, dass Sie den richtigen Schlüssel auswählen, da unsere Schlüssel nicht mit anderen funktionieren.



Fast fertig. Klicken Sie auf „Binance Spot Testnet API“ und Sie sehen die Variablen unten. Bearbeiten Sie die beiden rot hervorgehobenen Parameter, indem Sie die zuvor gespeicherten Schlüssel einfügen. Klicken Sie auf „Aktualisieren“ und schließen Sie das Popup-Fenster.



Lassen Sie auf diesem Bildschirm die Felder „Zeitstempel“ und „Signatur“ leer. Diese beiden Werte werden bei jeder Anfrage automatisch generiert.

Es gibt noch etwas zu tun. Rechts neben dem Zahnradsymbol, auf das wir zuvor geklickt haben, um die Umgebung einzurichten, sehen Sie ein Dropdown-Menü, in dem derzeit „Keine Umgebung“ steht. Klicken Sie darauf und wählen Sie „Binance Spot Testnet API“.


Importieren Sie eine Sammlung

Jetzt importieren wir eine Sammlung, die eine große Sammlung von Abfragen ist, die uns die schwere Arbeit abnehmen. Um es in unsere Umgebung hochzuladen, führen Sie die folgenden Schritte aus:

  1. Klicken Sie oben links auf „Importieren“.

  2. Wählen Sie im Popup-Fenster auf der Registerkarte „Datei“ die Option „Dateien hochladen“.

  3. Wir suchen erneut nach dem Ordner binance-postman-api. Finden und öffnen Sie es.

  4. Geben Sie dieses Mal „collections“ in das Unterverzeichnis ein.

  5. Hier sind noch einmal zwei Dateien. Eine für die Arbeit mit der Futures-API. Da wir jedoch mit Spot arbeiten, müssen Sie die Datei „binance_spot_api_v1.postman_collection.json“ auswählen.

  6. Sie sollten nun einen Bestätigungsbildschirm sehen, der den Import als Postman-Sammlungsformat identifiziert. Wählen Sie „Importieren“.

Im Reiter „Sammlungen“ auf der linken Seite des Fensters werden Sie nun feststellen, dass wir einen Ordner mit über 100 Anfragen haben. Glückwunsch! In Ordnung. Im nächsten Abschnitt schauen wir uns an, welche Anfragen wir senden können.


Ausführung von Anfragen

Wenn Sie die Ordner unter der Registerkarte „Sammlungen“ erweitern, werden Sie sehen, dass wir unzählige verschiedene Abfragen durchführen können. Anhand der Farbcodierung können Sie erkennen, dass wir drei Arten von Methoden verwenden können:


  • GET: Mit der Methode „GET“ werden Daten vom Server abgerufen. Wir werden damit Informationen über Ihren Kontostand, Vermögenspreise usw. ermitteln.

  • POST: Wir verwenden normalerweise die Methode „POST“, um Informationen auf dem Server zu erstellen. Dies ist für Dinge wie das Aufgeben von Bestellungen, die Beantragung von Auszahlungen usw. erforderlich.

  • DELETE: Die Methode „DELETE“ ist eine Aufforderung an den Server, Informationen zu löschen. Dies ist nützlich, um Bestellungen zu stornieren.


Suchen Sie nach einer Liste von Symbolen und Handelsregeln

Zeit für unsere erste Anfrage! Wir besorgen uns die Symbole, die an der Börse gehandelt werden können, und die Handelsregeln:

GET /exchangeInfo


Diese Anfrage erfordert keine zusätzlichen Parameter – Sie können sie kopieren und in die Adressleiste einfügen und erhalten eine Antwort. Postman erleichtert das Anzeigen und Ändern von Abfragen, bei denen wir mehrere Parameter einbeziehen.

Um diese Anfrage herunterzuladen, wählen Sie Markt > Börseninformationen. Die folgende Registerkarte wird angezeigt:



Wir müssen hier nichts weiter tun, klicken Sie also auf „Senden“. Sie erhalten die Antwort:



Im oberen hervorgehobenen Abschnitt sehen Sie wichtige Informationen:

  • Antwortstatus (200 bedeutet, dass die Anfrage erfolgreich ist, 400-499 bedeutet, dass wir ein Problem haben)

  • Zeit, die benötigt wird, um eine Antwort zu erhalten (weniger als eine Sekunde)

  • Antwortgröße (~22 KB).


Das zweite Feld enthält den Hauptteil der Antwort. Es ist wunderschön bedruckt, um die Augen etwas zu schonen. Es enthält Informationen über die Börse selbst sowie über die Paare, die Sie handeln können, und deren Mindest-/Höchstbeträge.

Es scheint, dass es viele Informationen gibt, aber das Format erleichtert die programmgesteuerte Arbeit damit. Beim Schreiben von Interaktionsskripten können Sie ganz einfach bestimmte Eigenschaften bestimmter Elemente aus der Antwort auswählen.


Überprüfung des Kontostandes

Schauen wir uns an, welche Vermögenswerte wir haben und wie viele:

GET /Konto

Diese Anfrage finden Sie unter „Handel“ > „Kontoinformationen“. Klicken Sie darauf und Sie sehen ein Layout, das dem vorherigen ähnelt. Sie werden jedoch auch feststellen, dass wir zwei neue Variablen haben: „Zeitstempel“ und „Signatur“. Die Signatur ist eine Sicherheitsmaßnahme. Da wir nun um vertrauliche Informationen bitten, beweisen wir damit, dass wir der Inhaber des Kontos sind.

Der Zeitstempel teilt dem Server mit, wann die Anfrage gesendet wurde. Da Netzwerke unzuverlässig oder ausgefallen sein können, erhält der Server unsere Anfrage möglicherweise viel später als erwartet. Wenn zu viel Zeit vergangen ist, wird die Anfrage abgelehnt. Mit dem Parameter „recvWindow“ können Sie festlegen, wie lange Sie warten möchten. Der Standardwert beträgt 5.000 Millisekunden.

Postman übernimmt für uns die Erstellung dieser beiden Felder. Klicken Sie auf „Senden“ und Sie erhalten eine Antwort. Unter Guthaben sollten Sie sechs Vermögenswerte sehen – BNB, BTC, BUSD, ETH, LTC und TRX. Der Saldo wird in frei und gesperrt aufgeteilt. Wir haben noch nichts blockiert, daher sollten alle Ihre Vermögenswerte frei sein.

Herzlichen Glückwunsch zu Ihrem neuen (nicht vorhandenen) Vermögen!


So erfahren Sie den aktuellen Preis eines Symbols

Wir können den aktuellen Preis eines Vermögenswerts auf verschiedene Arten ermitteln. Am einfachsten geht es vielleicht mit einer solchen Anfrage:

GET /api/v3/ticker/24hr

Wie Sie vielleicht schon erraten haben, erhalten wir dadurch Informationen über die Vermögenspreise der letzten 24 Stunden. Finden Sie es unter „Markt“ > „24-Stunden-Ticker-Preisänderungsstatistik“. Das Standardpaar, das wir als Symbolvariable sehen, ist BTCUSDT.

Sie können es jetzt senden, um eine Aufschlüsselung der Preisinformationen anzuzeigen. Sie können auch das Symbol ändern (in BNBBUSD, LTCUSDT usw.) oder die Variable deaktivieren, um Daten für 40 Paare zurückzugeben.

Wir haben auch einen einfacheren Aufruf („Markt“ > „Symbolpreis-Ticker“), der den aktuellen Preis zurückgibt, zu dem der Vermögenswert gehandelt wird:

GET /api/v3/Preis

Wie bisher können Sie die Symbolvariable ändern oder ganz entfernen und erhalten den aktuellen Preis für alle Symbole.


Überprüfung der aktuellen Orderbuchtiefe

Die Tiefe des Orderbuchs (auch Markttiefe oder DOM genannt) kann uns viel über den Markt verraten. Wir werden einen Anruf tätigen, um nützliche Informationen zurückzusenden:

GET api/v3/tiefe

Wenn wir es mit den Standardwerten („Markt“ > „Orderbuch“) senden, erhalten wir eine Antwort, die uns den Geld- und Briefkurs für BTCUSDT mitteilt. Der Testnet-Server gibt nicht so viele Daten aus wie der tatsächliche Server. Nachfolgend finden Sie einen Screenshot dessen, was Sie in einer realen Umgebung erwarten würden:



Im oben hervorgehobenen Abschnitt sehen wir das erste Problem. Da wir uns das Hauptbuch für BTCUSDT ansehen, ist die oberste Zahl der Preis, den jemand bereit ist, für Ihre BTC zu zahlen. Nachfolgend finden Sie den Betrag, den sie zu kaufen bereit sind. Dies deutet also darauf hin, dass diese Bestellung 0,999 BTC zu einem Kurs von 9.704,65 USDT pro BTC verlangt. Wenn wir weiter nach unten scrollen würden, würden wir sehen, dass der Angebotspreis sinkt – was bedeutet, dass der Käufer weniger bezahlt wird.

Das beste Angebot ist natürlich auch das attraktivste, wenn Sie Gewinn machen wollen. Wenn Sie jedoch versuchen, beispielsweise 3 BTC auf dem Markt zu verkaufen, können Sie nur 0,999 BTC zum besten Preis verkaufen. Sie müssen weitere (günstigere) Gebote annehmen, bis Ihre Bestellung vollständig ausgeführt ist.



Scrollen Sie weiter und Sie werden die Frage sehen. Funktionell ähneln sie Geboten, mit der Ausnahme, dass es sich um Aufträge zum Verkauf von BTC für USDT handelt.


Eine Testbestellung aufgeben

Jetzt werden wir eine Testbestellung aufgeben.

POST api/v3/order/test

Auch wenn wir lediglich Testnet-Mittel verwenden, führt diese Anfrage nicht zu einer tatsächlichen Bestellung. Dies kann nützlich sein, um Bestellungen vor dem Versenden zu testen. Finden Sie es unter „Handel“ > „Neue Bestellung testen (TRADE)“.



Wie Sie sehen, sind noch mehr Parameter beteiligt. Gehen wir die markierten Punkte durch:


  • Symbol - das haben wir schon einmal gesehen. Dies ist das Paar, mit dem Sie handeln möchten.

  • Seite – hier geben Sie an, ob Sie KAUFEN oder VERKAUFEN möchten. Beim BTCUSDT-Paar gibt BUY an, dass Sie BTC für USDT kaufen möchten, während SELL BTC für USDT verkaufen wird.

  • Typ – die Art der Bestellung, die Sie senden möchten. Mögliche Werte (Details hier):

    • GRENZE

    • MARKT

    • STOP_LOSS

    • STOP_LOSS_LIMIT

    • Gewinn mitnehmen

    • TAKE_PROFIT_LIMIT

    • LIMIT_MAKER

  • timeInForce – dieser Parameter drückt aus, wie der Auftrag ausgeführt werden soll:

    • GTC (Good Until Cancelled) ist vielleicht die beliebteste Einstellung. GTC garantiert, dass Ihre Bestellung gültig ist, bis sie ausgeführt wird oder bis Sie sie stornieren.

    • FOK (Execute or Cancel) – FOK weist die Börse an, den Auftrag sofort auszuführen. Sollte dies der Börse nicht möglich sein, wird die Bestellung sofort storniert.

    • IOC (Sofort ausführen oder stornieren) – Der Auftrag muss ganz oder teilweise sofort ausgeführt werden, sonst wird er storniert. Im Gegensatz zu FOK werden Aufträge nicht storniert, wenn sie teilweise ausgeführt werden können.

  • Die Menge ist einfach die Menge des Vermögenswerts, den Sie kaufen oder verkaufen möchten.

  • Preis – der Preis, zu dem Sie verkaufen möchten. Für das BTCUSDT-Paar wird dies in USDT ausgedrückt.

  • newClientOrderId – Bestellkennung. Dies ist kein Pflichtfeld, aber Sie können es auf einen Bezeichner setzen, der die Abfrage später vereinfacht. Andernfalls wird es zufällig an der Börse generiert.

Bußgeld! Jetzt erstellen wir einen Testauftrag. Wir werden die automatisch generierten Werte verwenden: eine Verkaufslimitorder von 0,1 BTC pro USDT zu einem Preis von 9.000 $. Klicken Sie auf „Senden“. Wenn alles erfolgreich war, erhalten wir als Antwort nur {{}}.

 

Eine echte Bestellung aufgeben

Zeit, eine echte Fake-Bestellung aufzugeben.

POST /api/v3/order

Gehen Sie zu Handel > Neue Bestellung. Da Sie bereits mit Testaufträgen vertraut sind, werden Sie die Parameter hier nicht überraschen. Lassen wir alle Werte unverändert, ändern aber den Preis, zu dem wir verkaufen, auf 40.000 US-Dollar. Ändern Sie den Preiswert, um dies widerzuspiegeln. Klicken Sie dann auf „Senden“.

Im Erfolgsfall enthält Ihre Antwort detaillierte Informationen zur Bestellung.


Überprüfen Sie den Status einer offenen Bestellung

Wir haben im vorherigen Abschnitt die Bestätigung erhalten, dass die Bestellung aufgegeben wurde, aber was ist, wenn wir sie später überprüfen möchten? Uns liegen mehrere Anfragen vor.

GET /api/v3/openOrders

Sie finden es unter „Handel“ > „Aktuell offene Bestellungen (USER_DATA)“. BTCUSDT ist standardmäßig ausgewählt. Wenn Sie auf „Senden“ klicken, erhalten Sie alle Ihre offenen BTCUSDT-Bestellungen (bisher sollten Sie nur die zuvor festgelegte sehen). Sie können das Symbol weglassen, um stattdessen alle Ihre offenen Bestellungen anzuzeigen.

GET /api/v3/allOrders

„Handel“ > „Alle Bestellungen (USER_DATA)“ gibt Ihnen einen Überblick über alle Bestellungen, nicht nur über die offenen. Hier müssen Sie das Symbol angeben. „orderId“, „startTime“, „endTime“ sind optionale Parameter, die Ihnen helfen können, Ihre Suche zu verfeinern. Wir belassen sie hier, also deaktivieren Sie die Kontrollkästchen. Klicken Sie auf „Senden“ und Sie sehen die gleiche Antwort wie zuvor. Wenn Sie abgeschlossene oder stornierte Bestellungen hatten, werden Sie diese auch hier sehen.


Schließlich können wir spezifische Bestellungen anfordern über:

GET /api/v3/order

Erhalten Sie es unter „Handel“ > „Abfrageauftrag (USER_DATA)“. Sie müssen entweder „orderId“ oder „origClientOrderId“ angeben (ein optionales „newClientOrderId“-Tag, das zu Bestellungen hinzugefügt werden kann). Deaktivieren Sie „orderId“. Für „origClientOrderId“ stellen wir das zuvor verwendete Standard-Tag bereit – „my_order_id_1“. Füllen Sie das Feld aus und klicken Sie auf „Senden“, um eine Antwort zu erhalten.


Stornierung der Bestellung

Nach einiger Zeit kommen wir möglicherweise zu dem Schluss, dass das Ziel von 40.000 US-Dollar zu optimistisch ist, sodass wir die Bestellung stornieren möchten. In diesem Fall würden wir verwenden:

LÖSCHEN /api/v3/order

Unter „Handel“ > „Auftrag stornieren“ finden Sie eine Abfrage, mit der wir Aufträge zur Stornierung markieren können. Deaktivieren Sie „orderId“ und „newClientOrderId“ und übergeben Sie „my_order_id_1“ als Wert für „origClientOrderId“.

Wenn Sie diese Anfrage absenden, wird die Bestellung zurückgesendet. Wenn Sie nach unten zu „Status“ scrollen, werden Sie sehen, dass es tatsächlich storniert ist. Um dies zu bestätigen, verwenden Sie erneut den Endpunkt GET /api/v3/openOrders (mit einer leeren Liste) oder GET /api/v3/order mit origClientOrderId .


Unschärfe der Bestellung, die sofort ausgeführt wird

Unser vorheriger Auftrag wurde nicht ausgeführt, da es sich um einen Limitauftrag handelte, der nur funktioniert, wenn der BTC-Preis 40.000 $ erreicht. Im Falle einer Marktorder sagen wir im Wesentlichen „Kauf/Verkauf zu jedem Preis, zu dem der Vermögenswert gerade gehandelt wird“. Diese Bestellung wird sofort ausgeführt.

Kehren wir dazu zu „Handel“ > „Neue Bestellung“ zurück. Wir werden den Antworttyp (newOrderRespType) demonstrieren, einen Parameter, den wir je nach der Antwort, die wir vom Server erhalten möchten, konfigurieren können. Hier gibt es drei Optionen: ACK, RESULT oder FULL – Beispiele für jede Antwort finden Sie hier. Wir werden ein „ACK“ verwenden, das uns eine einfache Bestätigung gibt, dass die Bestellung eingegangen ist.

Unten sehen Sie, dass wir einen Marktauftrag zum Verkauf von BNB für BUSD zum aktuellen Marktpreis senden werden.



Beachten Sie, dass die Antwort uns nur minimale Informationen liefert:



Sie können über den Endpunkt /api/v3/allOrders überprüfen, ob die Bestellung ausgeführt wurde.


Überprüfen Sie Ihre Angebote

Schauen wir uns abschließend einen Endpunkt zur Überprüfung Ihrer Transaktionen an:

GET /api/v3/myTrades

Die Anfrage befindet sich im Abschnitt „Handel“ > „Konto-Handelsliste (USER_DATA)“. Es ermöglicht Ihnen, jede Transaktion anhand eines bestimmten Symbols zu überprüfen. Wenn Sie alle Ihre Trades für das Standardsymbol (BTCUSDT) sehen möchten, deaktivieren Sie einfach „startTime“, „endTime“ und „fromId“. Als Antwort erhalten Sie bis zu 500 Trades – ändern Sie einfach das Limit, wenn Sie mehr sehen möchten.


Debuggen mit Postman

In Postman können Sie zusätzlich die rohe HTTP-Anfrage und -Antwort verfügbar machen.



Dieses Menü öffnet die Postman-Konsole, die die Details jeder Anfrage anzeigt.



Abschließende Gedanken

Der Zweck dieses Leitfadens besteht darin, Ihnen die Binance-API vorzustellen, ohne eine einzige Codezeile schreiben zu müssen. Wenn Sie alle notwendigen Schritte durchgeführt haben, sollten Sie nun verstehen, wie wir Informationen anfordern und versenden können.

In den nächsten Teilen dieser Serie werden wir einige grundlegende Codierungskonzepte vorstellen, die es uns ermöglichen, den Kauf und Verkauf von Kryptowährungen und anderen digitalen Vermögenswerten zu automatisieren.

Haben Sie noch Fragen? Besuchen Sie unser wachsendes Binance-Entwickler-Community-Forum oder schauen Sie sich die Dokumentation an.