FAQ zur erweiterten API

Last updated: 25. Nov. 2025

Mögliche Statuswerte für Einzahlungs-/Auszahlungstransaktionen

Durch die Verwendung der REST-API-Finanzierungsendpunkte können Kunden Mittel auf ihr Kraken Konto einzahlen oder von dort auszahlen und den Echtzeitstatus einer Einzahlungs- bzw. Auszahlungstransaktion anfordern.

Einzahlungen/Auszahlungen durchlaufen mehrere Phasen von der ursprünglichen Anfrage bis zum Abschluss der Transaktion, daher geben die Finanzierungsendpunkte unterschiedliche Statuswerte zurück, je nachdem, wann sie aufgerufen werden.

Beachte, dass die Statuswerte ursprünglich von den Seiten 16/17 des Internet Financial Exchange Protocol (IFEX)-Dokuments stammen, sie wurden jedoch leicht modifiziert, um besser für Krypto-Transaktionen geeignet zu sein (es werden beispielsweise nicht alle möglichen Statuswerte verwendet).

Einzahlungen

Mögliche Statuswerte für Einzahlungstransaktionen sind folgende:

•
Ausgeglichen = die Einzahlung wurde erhalten, es werden jedoch noch zusätzliche Bestätigungen auf der Blockchain benötigt.
•
Erfolgreich = die Einzahlung hat die erforderliche Anzahl von Bestätigungen auf der Blockchain erreicht.
•
Fehlgeschlagen = die Einzahlung ist fehlgeschlagen (aus einem oder mehreren unterschiedlichen Gründen).

Im Folgenden findest du einige Beispiele dafür, wie die oben genannten Statuswerte in den Antworten des DepositStatus-Endpunkts erscheinen könnten:

Status „Ausgeglichen“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}}

Status „Erfolgreich“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}}

Auszahlungen

Mögliche Statuswerte für Auszahlungstransaktionen sind folgende:

•
Anfang = die Auszahlungsanfrage wurde empfangen und wird auf Gültigkeit überprüft (etwaige Finanzierungsbeschränkungen für das Konto usw.).
•
Ausstehend = die Auszahlung ist noch nicht von unserem Zahlungsdienstleister bearbeitet worden.
•
Ausgeglichen = die Auszahlung wurde an die Blockchain gesendet (zu diesem Zeitpunkt wird die Blockchain-Transaktions-ID verfügbar).
•
Erfolgreich = Auszahlungstransaktion hat mindestens 1 Bestätigung auf der Blockchain.
•
In der Warteschleife = Auszahlung wurde zurückgehalten und muss von unserem Finanzierungsteam manuell überprüft werden.
•
Fehlgeschlagen = die Auszahlung ist fehlgeschlagen (aus einem oder mehreren unterschiedlichen Gründen).

Im Folgenden findest du einige Beispiele dafür, wie die oben genannten Statuswerte in den Antworten des WithdrawStatus-Endpunkts erscheinen könnten:

Status „Anfang“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}}

Status „Ausstehend“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Status „Ausgeglichen“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}}

Status „Erfolgreich“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}}

Status „Fehlgeschlagen“:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}}

Zusätzliche Informationen zu Einzahlungen/Auszahlungen sind über unsere Support-Seiten über Cash-Finanzierung und Krypto-Finanzierung verfügbar.

So rufst du historische Zeit- und Verkaufsdaten (Trading-Verlauf) über den REST API-Trades-Endpunkt ab

The REST API OHLC endpoint only provides a limited amount of historical data, specifically 720 data points of the requested interval. For example, asking for OHLC data in 1 minute intervals will return the most recent 720 minutes (12 hours) of data.

For applications that require additional OHLC or tick data, it is possible to retrieve the entire trading history of our markets (the historical time and sales) via the REST API Trades endpoint. The OHLC for any time frame and any interval can then be created from the historical time and sales data.

The Trades endpoint takes an optional parameter named since, which specifies the starting date/time of the data. The since value is a UNIX timestamp at nanosecond resolution (a standard UNIX timestamp in seconds with 9 additional digits).

For example, a call to the Trades endpoint such as https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 would return the historical time and sales for XBT/USD from the 1st of June 2019 at 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Subsequent calls to the Trades endpoint should replace the since parameter's value with the last parameter's value from the results of the previous call such as https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Using the special since value of 0 (zero) would return the historical time and sales from the beginning of the market (starting with the very first trade).

So platzierst und stornierst du Orders mit einer Benutzerreferenz und siehst sie ein

Eine Benutzerreferenz ist eine vom Kunden bereitgestellte Order-ID, die anstelle der tatsächlichen (von der API bereitgestellten) Order-ID für bestimmte Aufgaben der Orderverwaltung (insbesondere die Stornierung von Orders) verwendet werden kann.

Benutzerreferenzen sind so implementiert, dass sie so flexibel wie möglich sind, und können daher auf verschiedene Arten verwendet werden, einschließlich:

•
als eindeutige ID (wobei jede Order eine andere Benutzerreferenz hat),
•
um verwandte Orders zusammenzufassen (z. B. um Orders mit unterschiedlichen Leverage-Stufen zu gruppieren),
•
oder als Backup-ID für den Fall, dass die tatsächliche Order-ID nicht bekannt ist.

Eine Benutzerreferenz muss ein numerischer Wert zwischen 1 und 2.147.483.647 (al eine beliebige positive 32-Bit-Zahl) sein und könnte daher als einfacher Zähler, als zufälliger signierter 32-Bit-Wert oder sogar als Zeitstempel in Sekunden implementiert werden (obwohl dies nach dem 19. Januar 2038 um 3:14:07 UTC fehlschlagen würde).

Orders mit Benutzerreferenz aufgeben

Orders können mit einer angefügten Benutzerreferenz aufgegeben werden, indem der AddOrder-Endpunkt aufgerufen und der userref-Parameter mit der Benutzerreferenz als Wert angegeben wird:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Anzeigen von Orders mit Benutzerreferenz

Orders, denen bereits eine Benutzerreferenz angefügt ist, können durch Aufrufen der Open/Closed/QueryOrders-Endpunkte angezeigt werden, wobei der userref-Parameter mit der vorhandenen Benutzerreferenz als Wert angegeben wird (in diesem Fall fungiert die Benutzerreferenz als Filter, der nur die zugehörigen Orders anzeigt):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Stornieren von Orders mit Benutzerreferenz

Orders, denen bereits eine Benutzerreferenz angefügt ist, können mit der Benutzerreferenz storniert werden, indem der CancelOrder-Endpunkt aufgerufen und die Benutzerreferenz als txid-Wert verwendet wird (anstatt des Order-ID-Werts):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Beachte, dass alle offenen Orders mit derselben Benutzerreferenz storniert werden, daher ist es möglich, einen einzelnen CancelOrder-Aufruf zu tätigen, um mehrere Orders gleichzeitig zu stornieren (wie durch den count-Wert von 3 in der folgenden Antwort angezeigt):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

Warum erhalte ich bei der Verwendung der Kraken-API einen 403-Fehler?

Dieses Problem könnte mit Cloudflare zusammenhängen:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

HINWEIS: Kraken hat die „Browser-Integritätsprüfung“ aktiviert.

Dies kann auftreten, wenn deine Anfrage verdächtige Header enthält. Beispielsweise fehlt bei deiner Anfrage möglicherweise ein User-Agent oder es wird ein nicht standardmäßiger User-Agent verwendet. Überprüfe daher bitte deine Anfrage-Header.

Wenn du keine Standardanfragen erstellen kannst, die unser System zulässt, sende uns eine vollständige Kopie der von dir versuchten Anfrage(n), einschließlich deiner IP-Adresse und aller Header. Diese Informationen ermöglichen es uns, den Fall genauer zu untersuchen.

Bietet Kraken eine API-Testumgebung an?

Futures-API

Für unsere Futures REST- und WebSocket-APIs (futures.kraken.com) bieten wir eine vollständige Testumgebung unter der API-URL „demo-futures.kraken.com“ an.

REST-, WebSocket- und FIX-Testumgebungen

Für unsere Spot REST/WebSocket-API und FIX-API bieten wir derzeit eine Testumgebung für qualifizierte Kunden an. Der Zugriff auf diese Umgebung erfordert einen Onboarding-Prozess, der durch direktes Kontaktieren des API-Teams gestartet werden kann.

Testen unserer API mithilfe des Validierungstestparameters

Beim Platzieren einer Order über die Endpunkte „AddOrder“ der REST API oder „addOrder“ der WebSocket-API kann der Eingabeparameter „validate“ verwendet werden, um die Order zu simulieren.

Das Aufrufen von „AddOrder/addOrder“ mit auf „true“ gesetztem validate-Parameter (validate=1, validate=true, validate=anything usw.) führt dazu, dass die Order-Details auf Fehler überprüft werden, aber die API-Antwort wird niemals eine Order-ID enthalten (die für eine erfolgreiche Order immer ohne den „validate“-Parameter zurückgegeben würde).

Beispiel-AddOrder-Aufruf mit dem validate-Parameter (beachte die fehlende Order-ID):

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Kleine echteOrders und/oder Orders mit extremen Preisen

Für einen umfassenden API-Test mit dem Validierungsparameter empfehlen wir, sehr kleine Market-Orders (Orders gemäß der Mindestordergröße) oder Limit-Orders, die weit vom aktuellen Marktpreis abweichen, aufzugeben (z. B. eine Limit-Order zum Verkauf von ETH/USD zu 800 USD, wenn der Marktpreis 200 USD beträgt).

Das Testen mit Live-Orders ermöglicht es deinem API-Code, in realen Bedingungen mit unserer API zu interagieren, sodass jeder Aspekt des Tests genau ist (wie deine Orders das Orderbuch beeinflussen usw.).

TLS-Upgrade, das deine API-Verbindungen beeinträchtigen könnte

Aus Sicherheitsgründen haben wir kürzlich die Unterstützung für TLS 1.0 und 1.1 eingestellt. Wenn du bei dem Versuch, eine Verbindung zu unserer API herzustellen, auf SSL/TLS-Verbindungsfehler stößt, liegt dies wahrscheinlich an der Verwendung eines dieser veralteten Standards. Du musst deinen API-Client ändern, um die Verwendung von TLS 1.2/1.3 zu erzwingen, oder deine .NET-Version auf 4.6 oder höher aktualisieren, die TLS 1.2/1.3 als Standard verwendet.

REST API-Authentifizierungsrechner (Google-Tabelle)

Die folgende Google-Tabelle kann verwendet werden, um die REST API-Authentifizierungssignatur für beliebige Kombinationen von Eingabedaten zu berechnen:

•
Privater (geheimer) API-Schlüssel
•
API-Endpunkt (Balance, TradeBalance, QueryOrders, usw.)
•
Nonce-Wert (weitere Details findest du auf unserer Support-Seite Was ist eine Nonce)
•
Endpunkt-Eingabeparameter (z. B. asset=doge)

Der Rechner kann verwendet werden, um zu überprüfen, ob der Authentifizierungsalgorithmus korrekt implementiert wurde, um potenzielle Probleme (insbesondere unerwartete Fehler wegen ungültiger Schlüssel) später im Entwicklungszyklus zu vermeiden.

Gebrauchsanweisung

1
Öffne den REST API-Authentifizierungsrechner in Chrome (oder einem anderen aktuellen Webbrowser)
2
Erstelle eine Kopie des Rechners in deinem eigenen Google Drive über das Menü Datei -> Kopie erstellen (du musst dich für diesen Schritt in dein Google-Konto einloggen)
3
Bearbeite die Felder API-Schlüssel, API-Endpunkt, Nonce-Wert und Eingabedaten mit deinem eigenen API-Schlüssel und den Anforderungsdetails
4
Vergleiche die berechnete API-Authentifizierungssignatur mit dem Wert, der von deinem eigenen API-Code berechnet wurde (die beiden Werte müssen genau übereinstimmen)

Aus Sicherheitsgründen empfehlen wir, den Authentifizierungsrechner mit einem temporären API-Schlüssel zu verwenden und den API-Schlüssel aus deinem Konto zu löschen, sobald deine Implementierung der Authentifizierungssignatur als korrekt nachgewiesen ist.

Beispiel

Muss ich einen Client-Library-Wrapper verwenden?

Der Hauptvorteil der Verwendung unserer Client-Bibliotheks-Wrapper besteht darin, dass du nicht die Zeit und Mühe aufwenden musst, um das Rad neu zu erfinden, um API-Signaturen zu erstellen, das haben wir bereits für dich erledigt.

Wenn du nur beabsichtigst, Aufrufe an öffentliche Methoden zu machen, kannst du dich entscheiden, auf Client-Bibliotheken zu verzichten, da keine Authentifizierung erforderlich ist.

Die Liste der verfügbaren Wrapper findest du hier.