Kraken Futures API -Tutorial

Kraken -Futures und das API -Ökosystem verstehen

Die Kraken Futures -API ist ein leistungsstarkes Tool, das für Händler und Entwickler entwickelt wurde, die einen automatisierten Zugang zum Markt für Kraken -Derivate suchen. Im Gegensatz zum Spot Trading ermöglichen Futures den Benutzern, über Preisbewegungen von Kryptowährungen zu spekulieren, indem sie Hebelwirkung verwenden. Die Kraken Futures -API bietet Endpunkte für die Aufgabe von Bestellungen, das Abrufen von Marktdaten, das Verwalten von Positionen und die programmgesteuerte Überwachung des Kontostatus. Diese API arbeitet über HTTPS- und WebSocket-Protokolle und ermöglicht sowohl restgestellte Anforderungen als auch Echtzeit-Streaming von Daten.

Um mit der API zu interagieren, müssen Sie zunächst ihre beiden Hauptumgebungen verstehen: die Produktionsumgebung unter futures.kraken.com und die Sandbox-Testumgebung unter demo-futures.kraken.com . Die Sandbox ermöglicht es Entwicklern, Strategien zu testen, ohne reale Fonds zu riskieren. Alle Endpunkte erfordern eine Authentifizierung mit einem API -Schlüssel und einem Geheimnis , das über Ihr Kraken Futures -Account -Dashboard erzeugt wird.

Jede Anfrage an die privaten Endpunkte muss drei Header enthalten:

• Apikey : Ihr öffentlicher API -Schlüssel
• Authentifizierung : Eine SHA256 -HMAC -Signatur, die aus Ihrem geheimen Schlüssel erzeugt wird
• Nonce : Eine eindeutige, inkrementierende Zahl oder Zeitstempel

Diese Sicherheitsmaßnahmen stellen sicher, dass nur autorisierte Benutzer Aktionen ausführen können, z. B. Bestellungen oder Rückzugsmittel.

Einrichten Ihrer Kraken Futures -API -Anmeldeinformationen

Bevor Sie API -Anrufe tätigen, müssen Sie gültige Anmeldeinformationen in Ihrem Kraken Futures -Konto generieren. Navigieren Sie zum API -Management -Abschnitt in Ihrem Kraken Futures Dashboard. Stellen Sie sicher, dass Sie sich in die richtige Umgebung angemeldet haben - entweder leben oder Demo - basierend auf Ihren Entwicklungsbedürfnissen.

• Klicken Sie auf "Neue Schlüssel generieren".
• Weisen Sie Ihrem API -Schlüssel einen deskriptiven Namens zu, um die Identifizierung zu vereinfachen
• Wählen Sie die entsprechenden Berechtigungen aus: Platzierung , Leseausgleich und Anzeigepositionen bestellen
• Aktivieren Sie die IP -Whitelisting bei Bedarf für zusätzliche Sicherheit
• Bestätigen Sie den Erzeugungsprozess

Nach Abschluss erhalten Sie zwei kritische Komponenten: den API -Schlüssel (eine lange alphanumerische Zeichenfolge) und das private Geheimnis . Lagern Sie diese sicher. Das Geheimnis wird nach dem Schließen des Dialogs nicht erneut angezeigt. Wenn Sie es verlieren, müssen Sie den Schlüssel widerrufen und regenerieren.

Verwenden Sie zu Testzwecken die Sandbox -Umgebung, um unbeabsichtigte Geschäfte auf Live -Märkten zu vermeiden. Aktualisieren Sie beim Umschalten zwischen Umgebungen Ihre Basis -URL entsprechend:

• Sandbox: https://demo-futures.kraken.com
• Live: https://futures.kraken.com

Authentifizierungsmechanismus für private Endpunkte

Zugriff auf private Endpunkte wie /orders , /positions oder /account erfordert eine ordnungsgemäße Authentifizierung. Der Kern dieses Prozesses liegt bei der Erzeugung einer gültigen HMAC-Sha256-Signatur . Diese Unterschrift wird aus Ihrem privaten Geheimnis abgeleitet und enthält den Anforderungsweg, die Nonce und den Körper (falls zutreffend).

So konstruieren Sie die Authentifizierungsheader Schritt für Schritt:

• Verkettieren Sie den aktuellen UNIX -Zeitstempel (als Nonce), den Anforderungsweg (z. /api/v3/leads/status ) und die Anforderungskörper (falls nach/put) in eine einzelne Zeichenfolge
• Verwenden Sie Ihr privates Geheimnis, um den HMAC-Sha256-Hash dieser verketteten String zu berechnen
• Codieren das resultierende Hash im Base64 -Format
• Fügen Sie diesen codierten Wert in den Authentification ein

Python -Beispiel:

 import hmac import hashlib import time nonce = str (int (time.time () * 1000)) path = '/api/v3/ordnungen' body = '{' orderType ':' lmt ',' symbol ':' pi_xbtusd ',' Seite ':' Kaufen ',' Größe ': 1000,' limitPrice ': 30000}'
Message = Nonce + Pfad + Körper Signatur = hmac.new (
b'your_private_secret_here', msg=message.encode(), digestmod=hashlib.sha256
 ).verdauen()
 
auth_header = base64.b64code (Signature) .decode ()

Diese Signatur muss zusammen mit APIKey und Nonce in jede private Anfrage enthalten sein.

Platzieren Sie eine Futures -Bestellung über API

Sobald Sie authentifiziert sind, können Sie mit der Interaktion mit Handelsendpunkten beginnen. Um eine neue Bestellung aufzugeben, senden Sie eine Postanforderung an /api/v3/sendorder . Die Nutzlast muss wesentliche Parameter wie Symbol, Seiten, Größe und Auftragstyp enthalten.

Erforderliche Felder im JSON -Körper:

• OrderType : Kann lmt (Limit), mkt (Markt) oder post (Post-Nur-Limit) sein
• Symbol : Zum Beispiel pi_xbtusd für den ewigen Bitcoin/USD -Vertrag
• Seite : entweder buy oder sell
• Größe : Anzahl der Verträge (mindestens 1 für die meisten Paare)
• LimitPrice : Erforderlich für Grenzbestellungen

Beispielanforderung mit Curl:

 curl -X POST https://futures.kraken.com/api/v3/sendorder \ -H 'APIKey: your_api_key_here' \ -H 'Nonce: 1234567890' \ -H 'Authentification: generated_signature_here' \ -d '{'orderType':'lmt','symbol':'pi_xbtusd','side':'buy','size':100,'limitPrice':35000}'

Nach der Einreichung gibt die API eine Antwort zurück, die den orderId , den Status und andere Metadaten enthält. Sie können diese ID verwenden, um die Bestellung später zu stornieren oder abzufragen.

Marktdaten und Kontoinformationen abrufen

Öffentliche Endpunkte erfordern keine Authentifizierung und eignen sich ideal, um Echtzeitmarktbedingungen zu holen. Nützliche Endpunkte umfassen:

• GET /api/v3/tickers : Renditen die neuesten Preise, Finanzierungsraten und offene Zinsen für alle Symbole
• GET /api/v3/orderbook?symbol=pi_xbtusd
• GET /api/v3/history?symbol=pi_xbtusd&lastTime=... : Ruft die jüngste Handelsgeschichte ab

Für Kontospezifische Daten verwenden Sie private Endpunkte:

• GET /api/v3/accounts : Rand, Randbilanzen, Eigenkapital und PNL über alle Ledger hinweg
• GET /api/v3/positions : Listet alle aktiven Positionen mit dem Einstiegspreis, der Größe und der Liquidationsstufe auf
• GET /api/v3/orders : Ruft offene Bestellungen ab; hinzufügen ?order_status=closed , um gefüllt/storniert zu sehen

Alle Antworten sind im JSON -Format, so dass sie in Code analysiert werden können. Umfrageintervalle sollten Tarifbegrenzungen respektieren - typisch 10 Anfragen pro Sekunde für öffentliche Endpunkte und 5 für private.

Umgang mit Fehlern und Debuggen von API -Aufrufen

Selbst bei der korrekten Syntax können API -Anforderungen aufgrund ungültiger Parameter, unzureichender Marge oder Konnektivitätsprobleme fehlschlagen. Zu den gemeinsamen HTTP -Statuscodes gehören:

• 400 schlechte Anfrage : missgebildete JSON oder fehlende erforderliche Felder
• 401 nicht autorisiert : Ungültiger API -Schlüssel oder fehlgeschlagene Signaturüberprüfung
• 403 Verboten : IP nicht weißeListete oder unzureichende Berechtigungen
• 429 Zu viele Anfragen : Zinsbegrenzung überschritten

Fehlerantworten enthalten eine code und error . Beispielsweise gibt 'error': 'Invalid signature' ein Missverhältnis in der HMAC -Berechnung an. Überprüfen Sie die Verkettungslogik und die Codierungsschritte.

Aktivieren Sie die Protokollierung von Rohanfragen und Antworten während der Entwicklung. Tools wie Postman oder Curl mit -v -Flaggen helfen, Header und Nutzlasten zu inspizieren. Validieren Sie Zeitstempel - Sie müssen sich innerhalb eines kleinen Fensters (normalerweise ± 60 Sekunden) der Serverzeit von Kraken über GET /api/v3/time abrufen.

Häufig gestellte Fragen

Wie finde ich das richtige Symbol für einen Futures -Vertrag? Symbole folgen einer bestimmten Namenskonvention. Perpetuale beginnen mit pi_ , gefolgt von der Basis- und Zitatwährung (z. B. pi_ethusd ). Vierteljährliche Futures Verwenden Sie f_ Präfix und enthalten das Ablaufdatum (z. B. f_xbtusd_240628 ). Überprüfen Sie /api/v3/instruments für eine vollständige Liste.

Kann ich den gleichen API -Schlüssel für den Spot- und den Futures -Handel verwenden? Nr. Kraken Spot und Futures -Plattformen arbeiten auf getrennten Systemen. Sie müssen unterschiedliche API -Schlüssel aus dem Kraken Futures Dashboard erzeugen, nicht aus der Hauptschnittstelle von Kraken.com.

Wie hoch ist die Mindestbestellgröße für Kraken -Futures? Die meisten ewigen Verträge haben eine Mindestbestellgröße von 1 Vertrag. Ein Vertrag entspricht typischerweise 1 USD des zugrunde liegenden Vermögenswerts. Für pi_xbtusd , 1 Vertrag = $ 1 im Wert von Bitcoin. Überprüfen Sie immer über /api/v3/instruments .

Ist WebSocket -Unterstützung für Kraken -Futures verfügbar? Ja. Stellen Sie eine Verbindung zu wss://futures.kraken.com/ws/v1 für Live -Updates zu Bestellbüchern, Trades und Ihren privaten Bestellveranstaltungen. Die Authentifizierung beinhaltet das Senden eines aus dem Endpunkt /api/v3/auth/token erhaltenen token .