Erweiterte API-FAQ

Zuletzt aktualisiert: 25. Nov. 2025

Mögliche Statuswerte für Ein-/Auszahlungstransaktionen

Mithilfe der REST API Funding-Endpunkte können Kunden Gelder auf ihr Kraken-Konto einzahlen/abheben und den Echtzeitstatus einer Ein-/Auszahlungstransaktion anfordern.

Ein-/Auszahlungen durchlaufen mehrere Phasen zwischen der ursprünglichen Anforderung und dem Abschluss der Transaktion. Daher geben die Funding-Endpunkte je nach Aufruf einen unterschiedlichen Statuswert zurück.

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

Einzahlungen

Die möglichen Statuswerte für Einzahlungstransaktionen sind wie folgt:

•
Settled = Die Einzahlung wurde empfangen, benötigt aber noch zusätzliche Bestätigungen auf der Blockchain.
•
Success = Die Einzahlung hat die erforderliche Anzahl von Bestätigungen auf der Blockchain erreicht.
•
Failure = Die Einzahlung ist fehlgeschlagen (aus einem oder mehreren verschiedenen Gründen).

Im Folgenden finden Sie einige Beispiele, wie die oben genannten Statuswerte in Antworten vom DepositStatus-Endpunkt erscheinen würden:

Settled status:{"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"}]}

Success status:{"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

Die möglichen Statuswerte für Auszahlungstransaktionen sind wie folgt:

•
Initial = Auszahlungsanforderung wurde empfangen und wird auf Gültigkeit geprüft (z. B. Funding-Beschränkungen auf dem Konto).
•
Pending = Die Auszahlung wartet auf die Bearbeitung durch unser Funding-Gateway.
•
Settled = Die Auszahlung wurde an die Blockchain gesendet (zu diesem Zeitpunkt wäre die Blockchain-Transaktions-ID verfügbar).
•
Success = Die Auszahlungstransaktion hat mindestens 1 Bestätigung auf der Blockchain.
•
On hold = Die Auszahlung wurde zurückgehalten und muss manuell von unserem Funding-Team überprüft werden.
•
Failure = Die Auszahlung ist fehlgeschlagen (aus einem oder mehreren verschiedenen Gründen).

Im Folgenden finden Sie einige Beispiele, wie die oben genannten Statuswerte in Antworten vom WithdrawStatus-Endpunkt erscheinen würden:

Initial status:{"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"}]}

Pending status:{"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"}]}

Settled status:{"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"}]}

Success status:{"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"}]}

Failure status:{"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 Ein-/Auszahlungen finden Sie auf unseren Support-Seiten für Cash-Funding und Krypto-Funding.

So rufen Sie historische Zeit- und Verkaufsdaten (Handelshistorie) über den REST API Trades-Endpunkt ab

Der REST API OHLC-Endpunkt liefert nur eine begrenzte Menge an historischen Daten, genauer gesagt 720 Datenpunkte des angeforderten Intervalls. Wenn Sie beispielsweise OHLC-Daten in 1-Minuten-Intervallen anfordern, erhalten Sie die Daten der letzten 720 Minuten (12 Stunden).

Für Anwendungen, die zusätzliche OHLC- oder Tick-Daten benötigen, ist es möglich, die gesamte Handelshistorie unserer Märkte (die historischen Zeit- und Verkaufsdaten) über den REST API Trades-Endpunkt abzurufen. Die OHLC-Daten für jeden Zeitrahmen und jedes Intervall können dann aus den historischen Zeit- und Verkaufsdaten erstellt werden.

Der Trades-Endpunkt akzeptiert einen optionalen Parameter namens since, der das Startdatum/-zeit der Daten angibt. Der since-Wert ist ein UNIX-Timestamp mit Nanosekundenauflösung (ein Standard-UNIX-Timestamp in Sekunden mit 9 zusätzlichen Ziffern).

Zum Beispiel würde ein Aufruf des Trades-Endpunkts wie https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 die historischen Zeit- und Verkaufsdaten für XBT/USD ab dem 1. Juni 2019 um 00:00:00 UTC zurückgeben:

{"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"}}

Nachfolgende Aufrufe des Trades-Endpunkts sollten den Wert des Parameters since durch den Wert des Parameters last aus den Ergebnissen des vorherigen Aufrufs ersetzen, z. B. https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Die Verwendung des speziellen since-Werts 0 (Null) würde die historischen Zeit- und Verkaufsdaten vom Beginn des Marktes (beginnend mit dem allerersten Trade) zurückgeben.

So platzieren, zeigen und stornieren Sie Aufträge mit einer Benutzerreferenz

Eine Benutzerreferenz ist eine vom Kunden bereitgestellte Auftrags-ID, die anstelle der tatsächlichen (von der API bereitgestellten) Auftrags-ID für einige Auftragsverwaltungsaufgaben (insbesondere das Stornieren von Aufträgen) verwendet werden kann.

Benutzerreferenzen sind so flexibel wie möglich implementiert und können daher auf verschiedene Arten verwendet werden, darunter:

•
als eindeutige ID (wobei jeder Auftrag eine andere Benutzerreferenz hat),
•
um zusammengehörige Aufträge zu gruppieren (z. B. das Gruppieren von Aufträgen mit unterschiedlichen Leverage-Levels),
•
oder als Backup-ID für den Fall, dass die tatsächliche Auftrags-ID nicht bekannt ist.

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

Aufträge mit einer Benutzerreferenz platzieren

Aufträge können mit einer angehängten Benutzerreferenz platziert werden, indem der AddOrder-Endpunkt aufgerufen und der Parameter userref 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"]}}

Aufträge mit einer Benutzerreferenz anzeigen

Aufträge, die bereits eine Benutzerreferenz haben, können durch Aufruf der Open-/Closed-/QueryOrders-Endpunkte und Angabe des Parameters userref mit der vorhandenen Benutzerreferenz als Wert angezeigt werden (in diesem Fall fungiert die Benutzerreferenz als Filter und zeigt nur die zugehörigen Aufträge an):

$ ./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}}

Aufträge mit einer Benutzerreferenz stornieren

Aufträge, die bereits eine Benutzerreferenz haben, können mit der Benutzerreferenz storniert werden, indem der CancelOrder-Endpunkt aufgerufen und die Benutzerreferenz als txid-Wert (anstelle des Auftrags-ID-Werts) verwendet wird:

$ ./krakenapi CancelOrder txid=16764529

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

Beachten Sie, dass alle offenen Aufträge mit derselben Benutzerreferenz storniert würden, daher ist es möglich, einen einzigen CancelOrder-Aufruf zu tätigen, um mehrere Aufträge gleichzeitig zu stornieren (wie durch den count-Wert von 3 in der folgenden Antwort angegeben):

$ ./krakenapi CancelOrder txid=48695624

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

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

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 Integrity Check“ aktiviert.

Dies kann auftreten, wenn Ihre Anfrage verdächtige Header enthält. Zum Beispiel könnte Ihrer Anfrage ein User-Agent fehlen oder ein nicht standardmäßiger User-Agent verwendet werden; überprüfen Sie daher bitte Ihre Anfrage-Header.

Wenn Sie keine Standardanfragen erstellen können, die unser System zulässt, senden Sie uns eine vollständige Kopie der Anfrage(n), die Sie versuchen, einschließlich Ihrer IP-Adresse und aller Header. Diese Informationen würden es uns ermöglichen, weitere Untersuchungen durchzuführen.

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 Verwendung 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 Zugang zu dieser Umgebung erfordert einen Onboarding-Prozess, der durch direkte Kontaktaufnahme mit dem API-Team gestartet werden kann.

Testen unserer API mit dem Validate-Testparameter

Wenn Sie eine Order über die REST API AddOrder- oder WebSocket API addOrder-Endpunkte platzieren, kann der Eingabeparameter „validate“ verwendet werden, um die Order zu simulieren.

Der Aufruf von AddOrder/addOrder mit dem auf „true“ gesetzten validate-Parameter (validate=1, validate=true, validate=anything, etc.) führt dazu, dass die Orderdetails auf Fehler überprüft werden, aber die API-Antwort wird niemals eine Order-ID enthalten (die bei einer erfolgreichen Order ohne den validate-Parameter immer zurückgegeben würde).

Beispiel für einen AddOrder-Aufruf mit dem validate-Parameter (beachten Sie 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 reale Orders und/oder Orders mit extremen Preisen

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

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

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

Aus Sicherheitsgründen haben wir die Unterstützung für TLS 1.0 und 1.1 kürzlich eingestellt. Wenn Sie beim Versuch, eine Verbindung zu unserer API herzustellen, SSL/TLS-Verbindungsfehlermeldungen erhalten, liegt dies wahrscheinlich an der Verwendung eines dieser veralteten Standards. Sie müssen Ihren API-Client so ändern, dass die Verwendung von TLS 1.2/1.3 erzwungen wird, oder Ihre .NET-Version auf 4.6 oder höher aktualisieren, die TLS 1.2/1.3 standardmäßig verwendet.

REST API-Authentifizierungsrechner (Google Sheet)

Das folgende Google Sheet kann verwendet werden, um die REST API-Authentifizierungssignatur für jede Kombination von Eingabedaten zu berechnen:

•
API privater (geheimer) Schlüssel
•
API-Endpunkt (Balance, TradeBalance, QueryOrders usw.)
•
Nonce-Wert (weitere Details finden Sie 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, wodurch potenzielle Probleme (insbesondere unerwartete Fehler bei ungültigem Schlüssel) später im Entwicklungszyklus vermieden werden.

Nutzungshinweise

1
Öffnen Sie den REST API-Authentifizierungsrechner in Chrome (oder einem anderen aktuellen Webbrowser)
2
Erstellen Sie eine Kopie des Rechners in Ihrem eigenen Google Drive über das Menü Datei -> Kopie erstellen (Sie müssen sich für diesen Schritt bei Ihrem Google-Konto anmelden)
3
Bearbeiten Sie die Felder API-Schlüssel, API-Endpunkt, Nonce-Wert und Eingabedaten mit Ihrem eigenen API-Schlüssel und Ihren Anfragedetails
4
Vergleichen Sie die berechnete API-Authentifizierungssignatur mit dem Wert, der von Ihrem eigenen API-Code berechnet wurde (die beiden Werte müssen exakt übereinstimmen)

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

Beispiel

Muss ich einen Client-Bibliotheks-Wrapper verwenden?

Der Hauptvorteil der Verwendung unserer Client-Bibliotheks-Wrapper besteht darin, dass Sie keine Zeit und Mühe aufwenden müssen, um das Rad für die Erstellung von API-Signaturen neu zu erfinden – dies ist bereits für Sie erledigt.

Wenn Sie nur Aufrufe an öffentliche Methoden tätigen möchten, können Sie auf Client-Bibliotheken verzichten, da keine Authentifizierung erforderlich ist.

Die Liste der verfügbaren Wrapper finden Sie hier.