Wie verwende ich die Kraken Futures API mit Python? (Entwicklerhandbuch)

Authentifizierungsdaten einrichten

1. Melden Sie sich bei Ihrem Kraken-Konto an und navigieren Sie zum Abschnitt „Einstellungen“ unter „API“.

2. Generieren Sie ein neues API-Schlüsselpaar speziell für den Futures-Handel und stellen Sie sicher, dass die Berechtigung „Futures“ aktiviert ist.

3. Bewahren Sie den API-Schlüssel und den privaten Schlüssel sicher auf – kodieren Sie sie niemals fest in Quelldateien und übergeben Sie sie niemals der Versionskontrolle.

4. Verwenden Sie Umgebungsvariablen wie KRAKEN_FUTURES_API_KEY und KRAKEN_FUTURES_PRIVATE_KEY , um Anmeldeinformationen zur Laufzeit einzufügen.

5. Validieren Sie die Schlüssel, indem Sie eine minimale authentifizierte Anfrage stellen, z. B. das Abrufen von Kontoständen über den Endpunkt GET /api/v3/accounts .

Erforderliche Bibliotheken installieren und konfigurieren

1. Installieren Sie das offizielle Kraken Futures Python SDK mit pip: pip install kraken-futures-api .

2. Alternativ können Sie Anfragen direkt verwenden, wenn eine differenzierte Kontrolle über Header und Signaturlogik erforderlich ist.

3. Importieren Sie die erforderlichen Module: KrakenFuturesAPI , json und base64 für die manuelle Signaturgenerierung.

4. Initialisieren Sie den Client mit Ihren Anmeldeinformationen: client = KrakenFuturesAPI(key=key, Secret=secret) .

5. Bestätigen Sie die Konnektivität, indem Sie client.get_server_time() aufrufen und überprüfen, ob die Antwort einen gültigen Unix-Zeitstempel enthält.

Erteilen und Verwalten von Futures-Aufträgen

1. Erstellen Sie eine Order-Nutzlast unter Angabe des Symbols (z. B. PI_XBTUSD ), der Seite ( Kauf oder Verkauf ), der Größe und des Ordertyps ( Limit , Markt , Stop ).

2. Senden Sie die Bestellung mit client.send_order(...) , das eine strukturierte Antwort mit order_id , status und Filled_size zurückgibt.

3. Stornieren Sie eine aktive Bestellung mit client.cancel_order(order_id) und validieren Sie den Stornierungsstatus im zurückgegebenen JSON.

4. Rufen Sie offene Aufträge mit client.get_open_orders() ab und filtern Sie bei Bedarf nach Symbol oder Auftrags-ID.

5. Überwachen Sie Echtzeitfüllungen, indem Sie client.get_fills() abfragen oder Ausführungsereignisse in den WebSocket-Feed von Kraken integrieren.

Umgang mit Margin- und Positionsdaten

1. Aktuelle Margin-Anforderungen pro Vertrag mit client.get_margin_requirements(symbol='PI_XBTUSD') abrufen.

2. Fragen Sie offene Positionen über client.get_open_positions() ab und prüfen Sie dabei Felder wie size , mark_price und unrealized_pnl .

3. Passen Sie den Hebel für eine Position mit client.set_leverage(symbol='PI_XBTUSD', Leverage=5) an, vorbehaltlich der abgestuften Margin-Regeln von Kraken.

4. Schließen Sie eine Position explizit, indem Sie eine gegnerische Marktorder senden, die der aktuellen Größe entspricht, oder verwenden Sie client.close_position(symbol='PI_XBTUSD') .

5. Liquidationsrisikoindikatoren aus client.get_account_summary() analysieren, insbesondere margin_level und available_margin .

Häufig gestellte Fragen

F: Kann ich denselben API-Schlüssel für Spot- und Futures-Endpunkte verwenden? A: Nein. Kraken benötigt separate API-Schlüssel für Spot- und Futures-Dienste. Den unter den Spot-API-Einstellungen generierten Schlüsseln fehlen Futures-Berechtigungen und sie geben HTTP 403 auf Futures-Endpunkten zurück.

F: Was passiert, wenn meine Bestellunterschrift abläuft? A: Kraken erzwingt ein Gültigkeitsfenster von 60 Sekunden für signierte Anfragen. Wenn der Zeitstempel im Kraken-Api-Key- Header um mehr als 60 Sekunden von der Serverzeit abweicht, schlägt die Anfrage mit dem Fehlercode EAPI:Invalid nonce fehl .

F: Wie interpretiere ich das Statusfeld in Bestellantworten? A: Zu den gültigen Werten gehören „accepted “, „triggered “, „canceled “, „filled “ und „ expired “. Jedes spiegelt eine bestimmte Lebenszyklusphase wider, die durch Preisbedingungen und Systemverarbeitung bestimmt wird.

F: Gibt es eine Kursbegrenzung für die Futures-API? A: Ja. Kraken wendet dynamische Ratenbegrenzungen basierend auf der Kontostufe und der Endpunktkategorie an. Das Überschreiten der Grenzwerte gibt HTTP 429 zurück und enthält einen Retry-After- Header, der die Verzögerungsdauer in Sekunden angibt.