Wie benutze ich die Bitbit -API für den Vertragshandel?

BYBIT API ermöglicht den automatisierten Vertragshandel mit sichern Authentifizierung, Echtzeitdaten über WebSocket und volles Bestellmanagement für USDT- und inverse Verträge.

Aug 11, 2025 at 01:01 pm

Verständnis der Bybit -API für den Vertragshandel

Die Bitbit -API ist ein leistungsstarkes Tool, mit dem Händler ihre Vertragshandelsstrategien an der Bitbit -Börse automatisieren können. Durch die Nutzung der API können Benutzer programmgesteuert Bestellungen eingeben, Positionen verwalten, Marktdaten abrufen und den Kontostatus überwachen. Zunächst ist es wichtig zu verstehen, dass von Bitbit eine erholsame API und Websocket-API für die Echtzeit-Interaktion unterstützt. Die API -Endpunkte für den Vertragshandel sind speziell auf USDT Perpetual, Inverse Perpetual und Futures Contracts zugeschnitten. Stellen Sie vor einer Integration sicher, dass Sie auf der Grundlage des Vertragstyps, den Sie handeln möchten, auf die richtige API -Dokumentation zugreifen.

Navigieren Sie zu Ihren Bitbit -Kontoeinstellungen und generieren Sie API -Schlüssel. Während dieses Prozesses müssen Sie Berechtigungen wie "Order", "Asset" und "schreibgeschützt" definieren. Für den Vertragshandel sind sowohl "Bestell" als auch "Position" -Remmelden erforderlich. Entdecken Sie niemals Ihren geheimen Schlüssel im kundenseitigen Code oder in öffentlichen Repositories. Verwenden Sie immer HTTPS, wenn Sie API -Anrufe tätigen, um eine sichere Kommunikation zu gewährleisten.

Einrichten Ihrer API -Anmeldeinformationen

Um die Bitbit -API effektiv zu verwenden, müssen Sie zuerst Ihre API -Schlüssel erstellen und konfigurieren. Melden Sie sich in Ihrem Bitbit -Konto an und wenden Sie sich unter Ihrem Profil zum API -Verwaltungsabschnitt . Klicken Sie auf API erstellen und weisen Sie Ihrem Schlüssel einen Namen zu, um eine einfache Identifizierung zu erhalten. Beim Festlegen von Berechtigungen:

• Ermöglichen
• Aktivieren Sie die Positionsberechtigung , um auf offene Positionen zuzugreifen und Einstellungen zu nutzen
• Beschränken Sie die Auszahlung , es sei denn, dies ist unbedingt erforderlich, um Sicherheitsrisiken zu verringern

Nach der Erstellung erhalten Sie drei kritische Komponenten: API -Schlüssel , Geheimschlüssel und Benutzer -ID . Lagern Sie diese sicher. Sie können auch IP -Beschränkungen festlegen, um den API -Zugriff auf bestimmte IP -Adressen zu begrenzen und die Sicherheit zu verbessern. Wenn sich Ihre IP ändert, müssen Sie den Whitelist entsprechend aktualisieren. Beachten Sie, dass Bitbit HMAC-SHA256 zur Authentifizierung verwendet, sodass Ihre Anfragen eine ordnungsgemäß signierte Nachricht enthalten müssen.

Authentifizierung von API -Anfragen

Jede private API -Anfrage nach Bitbit muss mit Ihrem API -Schlüssel und Ihrem geheimen Schlüssel authentifiziert werden. Der Authentifizierungsprozess beinhaltet die Erstellung einer Signatur mit HMAC-Sha256-Hashing. Die zu signierende Zeichenfolge enthält typischerweise die HTTP -Methode, die Anforderungspfad, die Abfrageparameter und den Zeitstempel. Der Zeitstempel muss innerhalb von 5 Sekunden entfernt sein, um Wiederholungsangriffe zu verhindern.

So konstruieren Sie die Signatur:

• Verkettieren Sie die Anforderungsmethode (z. B. Post), den Anforderungspfad (z. B./v5/order/create) und die Abfragezeichenfolge (falls vorhanden)
• Verwenden Sie Ihren geheimen Schlüssel , um die verkettete Zeichenfolge mit HMAC-SHA256 zu haben
• Codieren das Ergebnis im hexadezimalen Format
• Fügen Sie die Signatur in den Anforderungsheader als X-BAPI-SIGN

Zu den zusätzlichen Headern gehören X-BAPI-API-KEY , X-BAPI-TIMESTAMP und X-BAPI-RECV-WINDOW (optional, Standard 5000 ms). Falscher Zeitstempel oder Signatur führt zu einem Authentifizierungsfehler. Überprüfen Sie, ob Ihre Systemuhr immer mit NTP -Servern synchronisiert ist.

Vertragsaufträge abgeben und verwalten

Verwenden Sie den Endpunkt /v5/order/erstellen Sie eine Vertragsauftrag über die Bitbit -API. Sie müssen wesentliche Parameter wie Symbol , Seite (kaufen oder verkaufen), orderType (Limit, Markt usw.), Qty und Preis (für Grenzbestellungen) einbeziehen. Bei USDT-Margined-Verträgen ist das Symbolformat BTCUSDT . Für inverse Verträge ist es BTCUSD .

Zu berücksichtigende wichtige Parameter:

• TimeInforce : Zu den Optionen gehören Goodtillcancel, unmittelbarer Kanzel, Filkill
• Reduzieren : Eingestellt auf True, um sicherzustellen, dass die Bestellung nur die Positionsgröße verringert
• CloseOntrigger : Nützlich für Stop-Loss- oder Take-Profit-Bestellungen
• PositionIDX : Für den Hedge -Modus erforderlich; 0 für Einweg, 1 für lange, kurz 2 kurz

Um eine Bestellung zu stornieren, verwenden Sie den Endpunkt /v5/order/stornieren mit dem OrderID oder OrderLinkid . Um aktive Bestellungen abzurufen, verwenden Sie /v5/order/realtime . Für das Positionsmanagement gibt der Endpunkt /v5/Position/List die aktuellen Positionen zurück, einschließlich Größe , Eintrittspreis und Hebel . Passen Sie den Hebel mit /v5/Position/Set-Leverage ein.

Abrufen von Markt- und Kontodaten

Echtzeit-Marktdaten sind für fundierte Handelsentscheidungen von entscheidender Bedeutung. BYBIT bietet zu diesem Zweck mehrere öffentliche Endpunkte. Nutzung /V5/Markt/Ticker, um die neuesten Preise, Finanzierungsraten und das 24-Stunden-Volumen für alle Verträge zu erhalten. Für Auftragsbuchdaten, verwenden Sie /v5/markt/orderbook mit den Symbol- und Tiefenparametern (z. B. 1, 5, 50 Stufen). Um historische Candlestick -Daten zu holen, verwenden Sie /v5/markt/kline mit Kategorie , Symbol , Intervall und Start/Endzeit .

Für Kontodaten gibt der Endpunkt /v5/Konto/Brieftaschenbalance Ihren Brieftaschenbetrag über alle Münzen zurück. Verwenden Sie /V5/Konto/Info, um Gesamtkonto -Details zu erhalten, einschließlich des gesamten Eigenkapitals und der verfügbaren Guthaben. Um die aktuellen Bestellausfüllungen zu überwachen, verwenden Sie /v5/Bestell-/Ausführungsliste . Dies kehrte mit Preis , Qty , Gebühr und Exectime ausgeführt.

Implementierung von WebSocket für Echtzeit-Updates

Verwenden Sie für den Handel mit geringem Latenz die WebSocket-API von Bybit anstatt REST-Endpunkte zu befragen. Verbindung zu wss://stream.bybit.com/v5/public/linear für USDT -Verträge oder wss://stream.bybit.com/v5/public/inverse für inverse Verträge. Um Echtzeitdaten zu abonnieren, senden Sie eine JSON-Nachricht mit dem OP- Feld auf "abonnieren" und das Args- Array mit Themen wie orderBookL2_25.BTCUSDT , tickers.BTCUSDT oder candle.1.BTCUSDT .

Für private Daten wie Auftragsaktualisierungen und Positionsänderungen authentifizieren Sie die WebSocket -Verbindung. Senden Sie eine Authentifizierungsanforderung mit Ihrem API -Schlüssel , Ihrem Zeitstempel und Ihrer Signatur . Abonnieren Sie nach authentifiziert, um sich auf order , position und execution abzuschließen, um Live -Updates zu erhalten. WebSocket -Nachrichten werden mit ZLIB komprimiert. Dekomprimieren Sie sie daher vor der Parsen.

Häufig gestellte Fragen

Was ist die Ratenlimit für die Bitbit -API?

Bybit erzwingt die Zinsgrenzen, um Missbrauch zu verhindern. Für die REST -API beträgt die Grenze in der Regel 60 Anforderungen pro Sekunde pro API -Schlüssel. Dies führt zu HTTP 429 -Fehlern. WebSocket -Verbindungen ermöglichen einen höheren Durchsatz, unterliegen jedoch auch Grenzwerte, die auf Abonnementzahl und Nachrichtenfrequenz basieren.

Wie gehe ich mit API -Fehlern wie „ungültige Signatur“ um?

Stellen Sie sicher, dass Ihr geheimer Schlüssel korrekt und nicht abgeschnitten ist. Stellen Sie sicher, dass die Signaturzeichenfolge die genaue Methode, den Pfad und die Parameter enthält. Überprüfen Sie, ob sich der Zeitstempel in Millisekunden und innerhalb von 5 Sekunden nach der Serverzeit von Bybit befindet. Verwenden Sie https://api.bybit.com/v5/market/time um die aktuelle Serverzeit abzurufen.

Kann ich die Bitbit -API für Grid -Handel oder DCA -Bots verwenden?

Ja, die API unterstützt automatisierte Strategien. Verwendung /V5/Bestellung/Erstellen in einer Schleife mit unterschiedlichen Preisen und Mengen. Logik implementieren, um abgestandene Bestellungen zu stornieren und Positionen anhand der Marktbedingungen anzupassen. Stellen Sie sicher, dass Ihr Bot die Finanzierungszinszahlungen und die Liquidationsrisiken übernimmt.

Ist TestNet für den API -Vertragshandel verfügbar?

Ja, BYBIT bietet eine TestNet-Umgebung unter https://api-testnet.bybit.com . Verwenden Sie es, um Trades zu simulieren, ohne echte Fonds zu riskieren. Generieren Sie separate API -Schlüssel für TestNet. Alle Endpunkte spiegeln die Live -Umgebung wider und ermöglichen eine vollständige Strategie -Tests.