Wie kann ich historische Vertragsdaten von der Kraken -API erhalten?

Fetch Kraken Futures Historische OHLC-Daten über `futures-api.kraken.com/api/history/candles` verwenden mit Symbol-, Intervall- und Unix-Zeitstempeln; Authentifizieren Sie mit API-Schlüssel und HMAC-Sha256-Signatur, falls geschwindigkeitsbereit.

Aug 08, 2025 at 02:49 pm

Kraken -API und historische Vertragsdaten verstehen

Die Kraken -API ist eine leistungsstarke Schnittstelle, die es Entwicklern und Händlern ermöglicht, programmgesteuert mit Krakens Kryptocurrency Exchange -Diensten zu interagieren. Bei Bezug auf historische Vertragsdaten ist es wichtig zu klären, dass Kraken hauptsächlich Spot -Handel und Futures -Verträge über seine Kraken Futures -Plattform (früher als Cryptowatch -Derivate bekannt) unterstützt. Die Standard -Kraken -REST -API (api.kraken.com) liefert keine historischen Daten für Futures oder ewige Verträge direkt. Stattdessen sind historische Vertragsdaten über die Kraken Futures-API zugänglich, die bei Futures-api.kraken.com gehostet wird.

Um historische Daten abzurufen, müssen Sie den richtigen Endpunkt basierend auf der Art des Vertrags- und Zeitrahmens identifizieren. Die Kraken Futures -API bietet Endpunkte wie /api/history/candles um OHLC -Daten (offen, hoch, niedrig, eng) für bestimmte Futures -Verträge abzurufen. Jeder Endpunkt erfordert Parameter wie Symbol , Intervall und von/bis Zeitstempel, um den Datenbereich zu definieren.

Einrichten von API -Zugriffsanmeldeinformationen

Bevor Sie Anfragen stellen, müssen Sie authentifizierten Zugriff auf die Kraken Futures -API einrichten. Dies beinhaltet das Erstellen eines API -Schlüssels und eines Geheimnisses:

• Melden Sie sich in Ihrem Kraken -Konto an und navigieren Sie zum Finanzierungsabschnitt .
• Wählen Sie API und wählen Sie Kraken Futures .
• Klicken Sie auf API -Taste erstellen .
• Berechtigungen zuweisen - Der Lesezugriff ist für Marktdaten aktiviert.
• Generieren Sie den Schlüssel und speichern Sie sicher sowohl den API -Schlüssel als auch den geheimen Schlüssel .

Diese Anmeldeinformationen sind erforderlich, um Anfragen mit HMAC-SHA256 zu unterschreiben. Im Gegensatz zum Spot Trading verwendet Kraken Futures einen separaten Authentifizierungsmechanismus. Jede Anfrage muss Header wie APIKey und Authent enthalten, bei denen Authent die berechnete Signatur basierend auf der Anforderungsmethode, Pfad, Körper und Zeitstempel ist.

Erstellung der API -Anfrage für historische Daten

Verwenden Sie den Candles History Endpoint : Um historische Vertragsdaten abzurufen:

 GET https://futures-api.kraken.com/api/history/candles

Erforderliche Abfragungsparameter umfassen:

• Symbol : Das Vertragsymbol wie PI_XBTUSD für den Bitcoin ewigen inversen Vertrag.
• Intervall : Das Candlestick -Intervall. Gültige Werte umfassen 1m , 5m , 15m , 1h , 4h , 1d .
• Aus : Startzeit in Unix Timestamp (Sekunden).
• Bis : Endzeit in Unix Timestamp (Sekunden).

Zum Beispiel 1-stündige Kerzen für den Bitcoin ewigen Vertrag vom 1. Januar 2024 bis 2. Januar 2024 abzurufen:

 https://futures-api.kraken.com/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600

Diese Anfrage erfordert keine Authentifizierung, wenn nur auf öffentliche Marktdaten zugegriffen werden. Wenn Sie jedoch bewertet sind, sollten Sie authentifizierte Anforderungen verwenden.

Bearbeitung der Authentifizierung für preisbegrenzte Anfragen

Wenn Sie das nicht authentifizierte Anforderungslimit überschreiten, wechseln Sie zu signierten Anforderungen. Der Prozess beinhaltet:

• Erstellen einer Anforderungsnutzlast mit Methode, Pfad, Körper und ISO 8601 -Zeitstempel.
• Verkettung des Zeitstempels, der Methode, des Pfades und des Körpers (falls vorhanden) in eine Signierzeichenfolge.
• Verwenden Sie HMAC-SHA256 mit Ihrem geheimen Schlüssel, um eine Signatur zu generieren.
• Einschließlich der Signatur in den Authent -Header und Ihrem Schlüssel in APIKey .

Beispielschritte in Python:

• Setzen Sie die Anforderungsmethode: GET
• Definieren Sie den Pfad: /api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• Erzeugen Sie den ISO-Zeitstempel: 2024-01-01T00:00:00Z
• Erstellen Sie die Signiernachricht: 2024-01-01T00:00:00ZGET/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• Berechnen Sie HMAC-SHA256 der Nachricht mit Ihrem geheimen Schlüssel
• Codieren das Ergebnis in Base64
• Header einstellen:
  • APIKey: YOUR_PUBLIC_KEY
  • Authent: BASE64_SIGNATURE
  • Nonce: 2024-01-01T00:00:00Z

Senden Sie die Anfrage mit einer Bibliothek wie requests .

Verarbeitung und Speichern der Antwortdaten

Die API gibt eine JSON -Antwort mit einer Reihe von Kerzenobjekten zurück. Jede Kerze enthält:

• TIMESTAMP : Unix Time of the Candle Start.
• Öffnen : Eröffnungspreis.
• Hoch : Höchster Preis.
• Niedrig : niedrigster Preis.
• Schließung : Schließungspreis.
• Volumen : gehandelter Volumen.

Beispielantwort:

 {
 'result': 'success',
 'candles': [ { 'timestamp': 1704067200, 'open': '42000.00', 'high': '42500.00', 'low': '41800.00', 'close': '42300.00', 'volume': '120.5' }

]
}

Analysieren Sie den JSON und extrahieren Sie das candles . Sie können diese Daten in CSV, einer Datenbank oder einem Datenrahmen für die Analyse speichern. Stellen Sie sicher, dass die Zeitstempel nach Bedarf in lokale Zeit oder UTC umgewandelt werden. Paginierung handhaben, wenn der Zeitbereich groß ist - kraken kann die Ergebnisse pro Anforderung begrenzen, wobei mehrere Anrufe mit from und until Werten angepasst werden müssen.

Häufige Fehler und Fehlerbehebung

• Ungültiges Symbol : Überprüfen Sie das Vertragsymbol. Verwenden Sie GET /api/instruments um alle verfügbaren Verträge aufzulisten.
• Zinsbegrenzung : Nicht authentifizierte Anfragen sind begrenzt. Verwenden Sie die Authentifizierung oder fügen Sie Verzögerungen zwischen Aufrufen hinzu.
• Ungültiges Zeitstempelformat : Stellen Sie sicher, dass Unix -Zeitstempel in Sekunden dauern, nicht in Millisekunden.
• Signaturfehlanpassung : Überprüfen Sie, ob die Signaturzeichenfolge die genauen Pfad- und Abfrageparameter enthält und dass der geheime Schlüssel korrekt ist.
• Leere Antwort : Bestätigen Sie, dass der Zeitbereich aktive Handelsperioden enthält.

Verwenden Sie Tools wie Postman- oder Python -Skripte, um Anforderungen inkrementell zu testen. Aktivieren Sie die Protokollierung, um Anforderungsheader und Antworten zum Debuggen zu erfassen.

Häufig gestellte Fragen

Wie finde ich das richtige Symbol für einen Kraken -Futures -Vertrag?

Verwenden Sie den Instrumenteendpunkt : GET https://futures-api.kraken.com/api/instruments . Dies FI_ETHUSD alle aktiven Verträge mit ihren Symbolen zurück, wie PI_XBTUSD .

Kann ich historische Daten auf Tick-Level anstelle von Kerzen abrufen?

Die Kraken Futures-API liefert keine Daten auf Tick-Ebene über öffentliche Endpunkte. Der Endpunkt /api/history/candles unterstützt nur aggregierte OHLC -Daten in festgelegten Intervallen. Betrachten Sie für detaillierte Daten Websocket-Feeds oder Datenanbieter von Drittanbietern.

Gibt es eine Grenze dafür, wie viel historische Daten ich gleichzeitig holen kann?

Ja, die API kann die Anzahl der pro Anfrage zurückgegebenen Kerzen einschränken. Wenn Ihr Zeitbereich groß ist, teilen Sie sie in kleinere Intervalle auf - wie ein Tag nach dem anderen - und stellen Sie mehrere Anfragen. Überprüfen Sie die Antwort auf Vollständigkeit und passen Sie die from und until Parameter entsprechend an.

Muss ich ein verifizierter Kraken -Benutzer sein, um auf historische Vertragsdaten zuzugreifen?

Für nicht authentifizierte öffentliche Datenanfragen reicht grundlegender Kontozugriff aus. Um die Zinsgrenzen zu erhöhen und einen stabilen Zugriff sicherzustellen, wird ein verifiziertes Konto mit API -Anmeldeinformationen empfohlen. Für das Abrufen von Daten sind keine vollständigen Handelsberechtigungen erforderlich.