Kraken Futures Api Python Beispiel

Mit der Kraken Futures-API können Händler den Futures-Handel über REL-Anrufe automatisieren und HMAC-Signed-Anforderungen, gültige Symbole wie `pi_xbtusd` und separate API-Schlüssel von Krakens Futures-Registerkarte erfordern.

Jul 26, 2025 at 07:29 pm

Was ist Kraken Futures API?

Die Kraken Futures-API ist eine ruhbasierte Schnittstelle, mit der Händler und Entwickler programmgesteuert mit der Futures-Handelsplattform von Kraken interagieren können. Dies beinhaltet das Festlegen von Bestellungen, das Abrufen von Marktdaten, das Checkieren von Kontos und die Verwaltung von Positionen. Es ist ideal für algorithmische Händler oder diejenigen, die automatisierte Handelsbots bauen. Um es in Python zu verwenden, müssen Sie zunächst einen API -Schlüssel und ein Geheimnis aus Ihrem Kraken Futures -Account -Dashboard erhalten. Diese Anmeldeinformationen müssen sicher - vor allem in Umgebungsvariablen - gespeichert werden, um sie im Code zu vermeiden.

So installieren Sie die erforderlichen Python -Bibliotheken

Stellen Sie vor dem Schreiben eines Codes sicher, dass die erforderlichen Bibliotheken installiert sind. Die kritischsten sind requests nach HTTP-Kommunikation und python-dotenv wenn Sie planen, Umgebungsvariablen für API-Anmeldeinformationen zu verwenden. Führen Sie die folgenden Befehle in Ihrem Terminal aus:

• pip install requests
• pip install python-dotenv
  

  Nach der Installation können Sie sie in Ihr Skript wie folgt importieren:

   import os
   import requests
   import time
   import hashlib
   import hmac
   from dotenv import load_dotenv

  Rufen Sie sicher, dass Sie load_dotenv() oben in Ihrem Skript anrufen, wenn Sie eine .env -Datei verwenden, um Ihre Anmeldeinformationen zu speichern.

  Einrichten von Authentifizierungsheadern

  
  Kraken Futures API verwendet HMAC-SHA256 für die Unterzeichnung von Anforderungen. Sie müssen eine Signatur für jeden privaten Endpunktanruf generieren. Der Prozess beinhaltet:
• Erstellen eines Nonce (ein einzigartiger Zeitstempel in Sekunden)
• Verkettung des Anforderungsweges, Nonce und Körper
• Verwenden Sie Ihr API -Geheimnis, um die Nachricht zu haben

• Hinzufügen von Headern wie APIKey und Authent (die Signatur)
  

  Hier erfahren Sie, wie man die Authentifizierung strukturiert:

   def get_kraken_signature(urlpath, data, secret):
   postdata = data
   encoded = (str(data['nonce']) + postdata).encode()
   message = urlpath.encode() + hashlib.sha256(encoded).digest()
   mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512)
   sigdigest = base64.b64encode(mac.digest())
   return sigdigest.decode()

  Diese Funktion gibt den Authent -Header -Wert zurück, der für private API -Aufrufe wie das Aufgeben von Bestellungen oder das Abholen Ihres Gleichgewichts erforderlich ist.

  Platzieren Sie eine Futures -Bestellung über API

  
  Um eine Futures -Bestellung aufzugeben, müssen Sie eine Postanforderung an /derivatives/api/v3/sendorder senden. Hier ist ein vollständiges Beispiel:

   url = 'https://futures.kraken.com/derivatives/api/v3/sendorder' headers = { 'User-Agent': 'Python API Client', 'APIKey': os.getenv('KRAKEN_API_KEY'), } Data = {
  'OrderType': 'lmt',,
  'Größe': 1,,
  'Symbol': 'pi_xbtusd',
  'Seite': 'Kaufen',
  'LimitPrice': '69000.0',
  'cliordid': f'my order {int (time.time ())} ',
  'nonce': str (int (time.time () * 1000),),
  }
  
  Signature = get_kraken_signature ('/sendOrder', Data, os.getenv ('kraken_api_secret'))
  Header ['Authent'] = Signatur
  response = requests.post (URL, Header = Header, Daten = Daten)
  The **`cliOrdId`** ensures each order is unique. The **`symbol`** must match Kraken's futures contract naming convention (eg, `pi_xbtusd` for perpetual Bitcoin/USD). 
  Fetching Open Positions and Account Info
   To retrieve your current open positions, send a GET request to `/derivatives/api/v3/openpositions`. No body is needed, but you still need authentication:
   url = 'https://futures.kraken.com/derivatives/api/v3/openpositions'
   Headers = {
   'Apikey': os.getenv ('kraken_api_key'),
   "Benutzer-Agent": "Python-API-Client",
   }
   nonce = str (int (time.time () * 1000))
   Data = {'nonce': nonce}
   Signature = get_kraken_signature ('/openPositions', data, os.getenv ('kraken_api_secret'))
   Header ['Authent'] = Signatur
   

response = requests.get (URL, Header = Header)
Positionen = response.json ()

Die positions enthält eine Liste der aktiven Positionen, einschließlich Einstiegspreis, Größe und nicht realisiertes P & L.

Häufige Fehler und wie man sie behebt

• Ungültige Signatur : Überprüfen Sie die Verkettungslogik in Ihrer Signaturfunktion. Stellen Sie sicher, dass der nonce eine Zeichenfolge ist und die in der Datennutzlast entspricht.
• Unzureichende Marge : Kraken kann Bestellungen ablehnen, wenn Ihrem Konto die Marge fehlt. Überprüfen Sie zuerst Ihren Kontostand mit /accountsummary .
• Ungültiges Symbol : Verwenden Sie /instruments , um eine Liste gültiger Futures -Verträge abzurufen. Nehmen Sie keine Namensmuster an.
• Zinsbegrenzung : Kraken erzwingt Tarifgrenzen. Wenn Sie einen 429 -Fehler erhalten, fügen Sie eine Verzögerung zwischen Anforderungen mit time.sleep(1) hinzu.
  

  Häufig gestellte Fragen

  Wie finde ich das richtige Futures -Symbol für BTC/USD?
  
  Verwenden Sie den Endpunkt /instruments : GET https://futures.kraken.com/derivatives/api/v3/instruments . Suchen Sie nach Symbolen, die in usd enden - das häufigste ist pi_xbtusd für den ewigen Futures -Vertrag.

  Kann ich den gleichen API -Schlüssel für den Spot- und Futures -Handel verwenden?
  
  Nein. Kraken Futures erfordert einen separaten API -Schlüssel, der aus der Registerkarte Futures in Ihrem Kraken -Konto erzeugt wird. Die Verwendung eines Spot -Schlüssels gibt einen Authentifizierungsfehler zurück.

  Warum wird meine Bestellung auch mit korrekten Parametern abgelehnt?
  
  Überprüfen Sie, ob Ihre Bestellgröße unter dem Minimum liegt (z. B. 0,001 BTC für BTC/USD). Überprüfen Sie auch, ob limitPrice die zulässige Abweichung vom Markpreis befindet. Kraken kann Bestellungen zu weit vom aktuellen Markt entfernt ablassen.

  Ist es sicher, API -Schlüssel in Umgebungsvariablen zu speichern?
  
  Ja, solange Ihre .env -Datei nicht für öffentliche Repositorys verpflichtet ist. Fügen Sie immer .env in Ihre .gitignore -Datei hinzu und drucken oder protokollieren Sie Ihre API -Schlüssel niemals in Code.