Wie benutze ich die REST -API von Bitfinex?

Mit BitFinex 'Rest API können Sie handeln, Marktdaten abrufen und Ihr Konto programmgesteuert verwalten. Dieser Leitfaden enthält Schritte und Beispiele für die effektive Verwendung.

Apr 14, 2025 at 03:35 am

Mithilfe der REST -API von Bitfinex können Sie mit der Börse programmatisch interagieren, sodass Sie Aufgaben wie Handel, Abruf von Marktdaten und Verwaltung Ihres Kontos ermöglichen. Diese Anleitung führt Sie durch die wesentlichen Schritte und gibt detaillierte Anweisungen zur effektiven Verwendung von Bitfinex 'REST -API.

Erste Schritte mit Bitfinex 'REST -API

Bevor Sie die REST -API von BitFinex verwenden können, müssen Sie einen API -Schlüssel einrichten. Befolgen Sie dazu die folgenden Schritte :

• Melden Sie sich in Ihrem Bitfinex -Konto an.
• Navigieren Sie zum Abschnitt "Konto" und wählen Sie "API".
• Klicken Sie auf "neue Schlüssel", um eine neue API -Taste zu generieren.
• Wählen Sie die Berechtigungen aus, die Sie dem Schlüssel erteilen möchten, z. B. Handel, Abhebungen oder schreibgeschützte Zugriff.
• Bestätigen Sie die Erstellung des Schlüssels und speichern Sie den API -Schlüssel und das Geheimnis sicher.

Sobald Sie Ihren API -Schlüssel und Ihr Geheimnis haben, können Sie Anfragen an die Bitfinex -REST -API stellen. Die API verwendet HTTPS und unterstützt JSON für den Datenaustausch.

Authentifizierung und Sicherheit

Die Authentifizierung ist entscheidend für die Sicherung Ihrer API -Interaktionen . Bitfinex verwendet eine Kombination aus Ihrem API -Schlüssel und einer Signatur, die mit Ihrem API -Geheimnis erzeugt wird. Hier erfahren Sie, wie Sie Ihre Anfragen authentifizieren:

• Generieren Sie einen Nonce : Eine eindeutige Zahl, die sicherstellt, dass jede Anforderung eindeutig ist. Dies kann ein Zeitstempel oder eine inkrementierende Ganzzahl sein.
• Erstellen Sie eine Nutzlast : Kombinieren Sie den API -Pfad, Nonce und zusätzliche Parameter in ein JSON -Objekt.
• Generieren Sie die Signatur : Verwenden Sie den HMAC-Sha384-Algorithmus mit Ihrem API-Geheimnis, um die Nutzlast zu unterzeichnen.
• Fügen Sie die Header hinzu : Fügen Sie den API -Schlüssel, die Nutzlast und die Signatur zu Ihren Anfrage -Headern hinzu.

Hier ist ein Beispiel dafür, wie die notwendigen Header in Python erstellt werden können:

 import time
 import json
 import hmac
 import hashlib api_key = 'your_api_key'
 api_secret = 'your_api_secret'.encode ()

Nonce erzeugen
 nonce = str (int (time.time () * 1000))
Nutzlast erstellen
 payload = {
'request': '/v1/balance', 'nonce': nonce
 }
 
Umwandeln Sie die Nutzlast in JSON und Encode
 payload_json = json.dumps (Payload) .Codode ()
 
Signatur erzeugen
 Signature = hmac.new (api_secret, payload_json, Hashlib.sha384) .hexDigest ()
 
Header vorbereiten
 Headers = {
 
'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature
 }

API -Anfragen machen

Mit der Authentifizierung können Sie jetzt Anfragen an die REST -API von Bitfinex stellen. Hier sind einige häufige Endpunkte und wie man sie benutzt :

• Abrufen von Kontoguthaben : Verwenden Sie den Endpunkt /v1/balances um Ihre Kontostilanzen zu überprüfen.

 import requests url = 'https://api.bitfinex.com/v1/balances'
 response = requests.get (URL, Header = Header)
 print (response.json ())

• Bestellen Sie eine Bestellung : Verwenden Sie den /v1/order/new Endpunkt, um eine neue Bestellung aufzugeben. Sie müssen das Symbol, den Betrag, den Preis und den Bestellentyp angeben.

 payload = { 'request': '/v1/order/new', 'nonce': nonce, 'symbol': 'btcusd', 'amount': '0.01', 'price': '10000', 'exchange': 'bitfinex', 'type': 'exchange limit', 'side': 'buy'

}

payload_json = json.dumps (Payload) .Codode ()
Signature = hmac.new (api_secret, payload_json, Hashlib.sha384) .hexDigest ()

Headers = {

'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature

}

url = 'https://api.bitfinex.com/v1/order/new'
Antwort = Anforderungen.Post (URL, Header = Header)
print (response.json ())

• Marktdaten abrufen : Verwenden Sie den Endpunkt /v1/pubticker -Endpunkt, um den aktuellen Ticker für ein bestimmtes Handelspaar zu erhalten.

 url = 'https://api.bitfinex.com/v1/pubticker/btcusd'
 response = requests.get(url)
 print(response.json())

Handhabungsfehler und Antworten

Bei der Verwendung der Bitfinex -REST -API ist es wichtig, Fehler zu behandeln und Antworten korrekt zu interpretieren. Hier sind einige Tipps :

• Überprüfen Sie den HTTP -Statuscode : Ein 200 -Status -Code zeigt eine erfolgreiche Anforderung an, während andere Codes Fehler angeben.
• Analysieren Sie die Antwort JSON : Die Antwort enthält ein JSON -Objekt mit den angeforderten Daten oder Fehlermeldungen.
• Häufige Fehlercodes : Machen Sie sich mit gemeinsamen Fehlercodes wie 400 (schlechte Anforderung), 401 (nicht autorisiert) und 500 (interner Serverfehler) vertraut.

Hier ist ein Beispiel dafür, wie man Fehler in Python umgeht:

 import requests url = 'https://api.bitfinex.com/v1/balances'
 response = requests.get (URL, Header = Header)

if response.status_code == 200:
print('Request successful:', response.json())
 anders:
 
print('Error:', response.status_code, response.text)
 Verwenden von Websockets für Echtzeitdaten
 Während die Rest-API für viele Aufgaben geeignet ist, kann die Verwendung von Websockets Echtzeitdatenaktualisierungen bereitstellen. Befolgen Sie die folgenden Schritte, um eine Verbindung zur WebSocket -API von Bitfinex herzustellen :
 
Stellen Sie eine WebSocket-Verbindung her : Verwenden Sie eine WebSocket-Bibliothek wie websocket-client in Python.
 import websocket
 WS = WebSocket.Websocket ()
 Ws.Connect ('WSS: //api-pub.bitfinex.com/ws/2')

• Abonnieren Sie Kanäle : Senden Sie eine JSON -Nachricht, um bestimmte Kanäle zu abonnieren, z. B. Ticker oder Buchaktualisierungen.

 subscribe_msg = { 'event': 'subscribe', 'channel': 'ticker', 'symbol': 'tBTCUSD'

}

ws.send (json.dumps (subcribe_msg))

• Verarbeitung eingehende Nachrichten : Analysieren Sie die eingehenden JSON-Nachrichten, um Echtzeitdaten zu verarbeiten.

 result = ws.recv()
 print(result)

Verwalten von API -Ratengrenzen

Bitfinex stellt die API -Anfragen zur Verhinderung von Missbrauch zu Zinsgrenzen. Diese Grenzen effektiv zu verwalten :

• Verstehen Sie die Grenzen : Bitfinex hat unterschiedliche Ratengrenzen für authentifizierte und nicht authentifizierte Anforderungen. Authentifizierte Anfragen sind in der Regel auf 90 Anfragen pro Minute begrenzt.
• Implementieren Sie die Rate -Limiting in Ihrem Code : Verwenden Sie Bibliotheken wie ratelimit in Python, um sicherzustellen, dass Sie innerhalb der Grenzen bleiben.

 from ratelimit import limits, sleep_and_retry @sleep_and_retry
 @limits (Anrufe = 90, Periode = 60)
 Def call_api ():

# Make your API call here pass
 Verwenden Sie die Funktion
 call_api ()

Häufig gestellte Fragen

F: Kann ich die REST -API von Bitfinex verwenden, um Handelsstrategien zu automatisieren?

A: Ja, Sie können die REST -API verwenden, um Handelsstrategien zu automatisieren, indem Sie programmatisch Bestellungen abgeben, Guthaben überprüfen und Marktdaten abrufen. Stellen Sie sicher, dass Sie die ordnungsgemäße Fehlerbehandlung und die Ratenbeschränkung implementieren, um ein stabiles Handelsumfeld aufrechtzuerhalten.

F: Ist es möglich, Mittel mit der BitFinex -REST -API abzuheben?

A: Ja, Sie können Mittel mit dem Endpunkt /v1/withdraw . Sie müssen die Auszahlungsmethode, den Betrag und die Adresse angeben. Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen für Ihren API -Schlüssel verfügen, um Abhebungen durchzuführen.

F: Wie kann ich meine API -Anfragen testen, ohne mein Live -Konto zu beeinflussen?

A: BitFinex bietet eine TestNet -Umgebung, in der Sie Ihre API -Anfragen testen können, ohne sich auf Ihr Live -Konto auswirken. Sie können sich für ein TestNet -Konto anmelden und die TestNet -API -Endpunkte verwenden, um den Handel und andere Operationen zu simulieren.

F: Was soll ich tun, wenn ich auf einen Authentifizierungsfehler stoße?

A: Wenn Sie auf einen Authentifizierungsfehler stoßen, überprüfen Sie Ihren API-Schlüssel, das Geheimnis und den Signaturerzeugungsprozess. Stellen Sie sicher, dass der Nonce für jede Anfrage eindeutig ist und dass die Nutzlast korrekt formatiert ist. Wenn Themen bestehen bleiben, sollten Sie Ihren API -Schlüssel und Ihr Geheimnis regenerieren.