Wie benutze ich die Bitbit -API?

Die Bitbit-API ermöglicht automatisierte Handel, Echtzeitdaten-Streaming und Positionsmanagement über sichere Endpunkte von REST und WebSocket.

Aug 04, 2025 at 11:42 pm

Verständnis der Bybit -API und ihrer Anwendungsfälle

Die Bitbit -API ist eine leistungsstarke Schnittstelle, die es Händlern und Entwicklern ermöglicht, programmgesteuert mit der Handelsplattform von Bybit zu interagieren. Es ermöglicht die Automatisierung von Handelsstrategien, Echtzeit-Marktdatenabruf, Auftragsplatzierung, Positionsmanagement und Kontostandüberwachung. Die API unterstützt sowohl erholte als auch Websocket -Protokolle und bietet Flexibilität für verschiedene Anwendungsfälle. REST-APIs eignen sich ideal für einmalige Anfragen wie das Aufgeben einer Bestellung oder das Überprüfen von Guthaben, während WebSocket am besten für kontinuierliche Datenstreaming wie Live-Preis-Updates oder Bestellungsbuchänderungen geeignet ist. Vor der Verwendung der API müssen Benutzer API -Schlüssel aus ihrem Bitbit -Konto generieren, die als Authentifizierungsanmeldeinformationen dienen.

Generieren Sie Ihren Bybit -API -Schlüssel

Um mit der Bitbit -API zu beginnen, müssen Sie zunächst einen API -Schlüssel erstellen. Dieser Vorgang erfolgt direkt in Ihrem Bitbit -Konto -Dashboard. Navigieren Sie unter Ihren Profileinstellungen zum API -Management -Abschnitt. Klicken Sie auf API erstellen , wo Sie aufgefordert werden, einen Namen für Ihre API -Taste einzugeben und IP -Beschränkungen einzurichten. IP Whitelisting verbessert die Sicherheit, indem der API -Zugriff auf bestimmte IP -Adressen eingeschränkt wird. Nach dem Eingeben der erforderlichen Details generiert Bitbit ein Paar von Anmeldeinformationen: einen API -Schlüssel und einen geheimen Schlüssel . Diese müssen sicher gespeichert werden, da der geheime Schlüssel nach der ersten Erstellung nicht erneut angezeigt wird. Teilen Sie diese Schlüssel niemals oder enthüllen Sie sie im clientseitigen Code.

Konfigurieren der API -Authentifizierung für Anforderungen

Alle privaten Endpunkte in der Bitbit -API erfordern eine Authentifizierung unter Verwendung des API -Schlüssels und des geheimen Schlüssels. Die Authentifizierung wird über HMAC SHA256 -Signaturen implementiert. Jede Anfrage muss bestimmte Header enthalten:

• X-BAPI-API-Key : Ihre API-Schlüssel
• X-BAPI-Sign : Die generierte Signatur
• X-BAPI-Timestamp : Der aktuelle Zeitstempel in Millisekunden
• X-BAPI-Recv-Window : Optional definiert das Zeitfenster für die Anforderungsgültigkeit (Standard ist 5000 ms)

Um das X-BAPI-Sign zu generieren, verkettet die Anforderungsparameter in einer bestimmten Reihenfolge (Timestamp + api_key + recv_window + query_string) und hash sie mit HMAC SHA256 mit Ihrem geheimen Schlüssel. Die meisten Programmiersprachen bieten dafür integrierte Bibliotheken. Verwenden Sie beispielsweise in Python die hmac und hashlib -Module. Stellen Sie sicher, dass die Zeitstempel mit der Serverzeit von Bybit synchronisiert werden, um Signaturfehler zu vermeiden.

Bestellungen mit der Rest -API geben

Senden Sie eine Postanforderung an den entsprechenden Endpunkt, z /v5/order/create Die erforderlichen Parameter gehören:

• Symbol : Das Handelspaar, z. B. btcusdt
• Seite : entweder kaufen oder verkaufen
• OrderType : Limit , Markt oder Stopp
• Qty : Die Menge zum Handel
• Preis : Erforderlich für Grenzbestellungen
• TimeInForce : Gibt Ausführungsanweisungen an, z. B. GTC (gut bis abbrechen)

Stellen Sie vor dem Senden der Anforderung sicher, dass alle Parameter korrekt formatiert und in die Signaturberechnung enthalten sind. Eine erfolgreiche Antwort gibt ein JSON -Objekt zurück, das den OrderID , OrderLinkid und den Status enthält. Überprüfen Sie immer den Antwortcode und die Nachricht, um die Ausführung zu bestätigen. Verwenden Sie das OrderLinkid , um Ihre Bestellung in nachfolgenden Abfragen zu verfolgen.

Streaming von Echtzeitdaten mit WebSocket

Für Anwendungen, die Live -Updates erfordern - wie beispielsweise algorithmische Handelsbots oder Marktüberwachungs -Dashboards -, ist die WebSocket -API von WebSocket von wesentlicher Bedeutung. Stellen Sie eine Verbindung zum WebSocket -Endpunkt her: wss://stream.bybit.com/v5/public/linear für USDT Perpetual Contracts. Abonnieren Sie nach der Erstellung der Verbindung Themen mit dem Abonnement -Nachrichtenformat. Beispiele sind:

• Orderbookl2_25.BTCUSDT : Top 25 Bestellbuchstufen
• Tickers.BTCUSDT : Echtzeit-Tickerdaten
• Kerzen.1.BTCUSDT : 1-minütige Candlestick-Daten
• publicTrade.btcusdt : jüngste Geschäfte

Jede empfangene Nachricht enthält ein Themenfeld und eine Datennutzlast . Analysieren Sie die JSON -Antwort entsprechend. Für private Daten wie Positionen oder Gleichgewichtsaktualisierungen stellen Sie eine separate WebSocket -Verbindung zum privaten Endpunkt her und fügen Sie Authentifizierungsheader ähnlich wie Ruhe ein.

Verwaltung von Positionen und Risiko über API

Die Bitbit -API ermöglicht die volle Kontrolle über offene Positionen. Um aktuelle Positionen abzurufen, senden Sie eine GET -Anforderung an /v5/position/list . Die Antwort umfasst Größe , EntryPrice , nicht realisierte PNL und Hebelwirkung . Verwenden Sie den Endpunkt /v5/position/trading-stop -Endpunkt, um eine Position zu ändern, z. B. das Anpassen von Stop-Loss- oder Take-Profit-Werten. Erforderliche Parameter:

• Symbol
• Stopplosen : Stop-Loss-Preis
• Take Profit : Take-Profit-Preis

Stellen Sie sicher, dass diese Werte innerhalb der zulässigen Preisbereiche und Einstellungen für die Kontoverwirtschaftung liegen. Geben Sie eine Position für eine Position mit der gleichen Menge eine gegnerische Marktordnung. Wenn Sie beispielsweise eine Kaufposition von 1 BTC abhalten, senden Sie einen Verkaufsmarktauftrag für 1 BTC. Bestätigen Sie den Schließ, indem Sie die aktualisierte Positionsgröße in der nächsten Position abfragen.

Häufig gestellte Fragen

Wie setze ich meinen Bybit -API -Geheimschlüssel zurück?

Bybit erlaubt nicht das Zurücksetzen des geheimen Schlüssels direkt. Sie müssen den vorhandenen API -Schlüssel löschen und eine neue erstellen. Navigieren Sie zur API -Verwaltung , suchen Sie den Schlüssel, klicken Sie auf Löschen , bestätigen Sie die Aktion und generieren Sie dann ein neues Schlüsselpaar. Aktualisieren Sie Ihre Anwendung sofort mit den neuen Anmeldeinformationen.

Kann ich die Bitbit -API ohne IP -Einschränkungen verwenden?

Ja, aber es ist sehr entmutigt. Wenn IP -Beschränkungen deaktiviert werden, werden Sie Ihren API -Schlüssel zum potenziellen Missbrauch ausgesetzt. Wenn Sie es deaktivieren müssen, stellen Sie sicher, dass Ihre Anwendung zusätzliche Sicherheitsebenen wie verschlüsselter Speicher und minimale Berechtigungsbereiche verwendet.

Welche Ratengrenzen gelten für die Bitbit -API?

Bybit erzwingt die Zinsgrenzen, um Missbrauch zu verhindern. Die Rest -API ermöglicht bis zu 60 Anforderungen pro Sekunde pro IP. WebSocket Connections unterstützen bis zu 24 Abonnements pro Verbindung . Das Überschreiten von Grenzen führt zu einem 429 -Fehler. Verteilen Sie Anforderungen über mehrere IPs oder verwenden Sie nach Möglichkeit Stapel.

Warum bekomme ich einen "ungültigen" Fehler?

Dies tritt typischerweise aufgrund einer falschen Parameterbestellung, der Zeitstempelfehlanpassung oder einer falschen Hashing -Methode auf. Stellen Sie sicher, dass der Zeitstempel mit dem X-BaPi-Timestamp- Header übereinstimmt, Parameter sortiert sind und HMAC SHA256 mit dem richtigen geheimen Schlüssel verwendet werden. Testen Sie mit einem einfachen Endpunkt wie /v5/user/query-api um das Problem zu isolieren.