API-Fehlermeldungen

Fehler aufgrund fehlender Berechtigung werden zurückgegeben, wenn der API-Client versucht, eine Aufgabe auszuführen, für die der API-Schlüssel keine Berechtigung besitzt. Wenn ein API-Client beispielsweise versucht, den Kontostand mit einem API-Schlüssel abzurufen, der für den Handelszugriff, aber nicht für den Kontoverwaltungszugriff konfiguriert war, würde der Fehler „Berechtigung verweigert“ zurückgegeben. Sie können Ihre API-Schlüssel und deren Einstellungen (z. B. deren Berechtigungen) über die Registerkarte „Einstellungen -> API“ der Kontoverwaltung überprüfen. Sie müssen sicherstellen, dass die von Ihren Drittanbieter-Apps verwendeten API-Schlüssel alle Einstellungen und Berechtigungen haben, die Ihre Apps benötigen.

Dieser Fehler wird zurückgegeben, wenn der für den Aufruf verwendete API-Schlüssel entweder abgelaufen oder deaktiviert ist. Bitte überprüfen Sie den API-Schlüssel in Ihren Einstellungen -> API-Registerkarte der Kontoverwaltung oder generieren Sie einen neuen und aktualisieren Sie Ihre Anwendung.

Sie können die vollständige Liste unserer Asset-Paare über den öffentlichen AssetPairs-Aufruf abrufen und nach dem Paarnamen als Eintrag der Json-Header oder über den Parameter "altname" suchen: https://api.kraken.com/0/public/AssetPairs

Dieser Fehler wird zurückgegeben, wenn eine Methode ohne die erforderlichen Parameter aufgerufen wird. Wenn beispielsweise die Methode QueryOrders ohne Angabe eines gültigen Transaktions-ID-Parameters (txid) aufgerufen wird, würde der Fehler „ungültige Argumente“ zurückgegeben. Das Aufrufen einer Methode mit unnötigen Parametern würde den Fehler „ungültige Argumente“ dennoch nicht zurückgeben, da die unnötigen Parameter einfach ignoriert würden.

Fehler bei ungültiger Signatur treten auf, wenn entweder Ihr API-Schlüssel oder Ihr API-Geheimnis in Ihrem Programm falsch geschrieben sind oder weil die bei der Authentifizierung verwendeten POST-Daten und die an die API gesendeten POST-Daten nicht übereinstimmen.Als zusätzliche Referenz finden Sie im Folgenden ein Beispiel für Python-Code zur Implementierung des API-Signaturalgorithmus. Der entsprechende öffentliche API-Schlüssel sollte aus der Kontoverwaltung kopiert und eingefügt werden, und die API-Methode und die POST-Daten sollten entsprechend aktualisiert werden. Der Ausgabewert kann direkt als Wert für den API-Sign-HTTP-Header verwendet werden. #!/usr/bin/env python

# Erforderliche Python-Bibliotheken importieren
import time
import base64
import hashlib
import hmac

# Privaten API-Schlüssel aus dem in der Kontoverwaltung angezeigten Base64-Format dekodieren
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Variablen (API-Methode, Nonce und POST-Daten)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

# Kryptografische Hash-Algorithmen
api_sha256 = hashlib.sha256(api_nonce + api_post).digest()
api_hmac = hmac.new(api_secret, api_path + api_sha256, hashlib.sha512)

# Signatur in das für den API-Sign-Wert verwendete Base64-Format kodieren
api_signature = base64.b64encode(api_hmac.digest())

# API-Authentifizierungssignatur zur Verwendung im API-Sign-HTTP-Header
print(api_signature)Der SHA256 wird unter Verwendung des Nonce-Wertes selbst und der POST-Daten für die API-Methode berechnet, und die POST-DATEN bestehen aus den Name/Wert-Paaren für die Nonce (erneut) und die API-Methodenparameter. Ein Beispiel für die Daten, die an den SHA256 für die TradeBalance-Methode übergeben werden sollten, wäre wie folgt:SHA256 = SHA256 von "1541933977000nonce=1541933977000&asset=xxbt"Der Zeichenfolgenwert, der an den SHA256 übergeben wird, sollte keine zusätzlichen Nullwerte (\0) enthalten und der Zeichenfolgenwert sollte nicht als Base64 oder Hex kodiert sein (d.h. der Zeichenfolgenwert sollte eine Klartextzeichenfolge sein).Der URI-Pfad ist die gesamte URL der API-Methode mit Ausnahme des Präfixes "https://api.kraken.com", sodass der URI-Pfad der TradeBalance-Methode (zum Beispiel) der Zeichenfolgenwert "/0/private/TradeBalance" ohne zusätzliche Nullwerte wäre.Der HMAC SHA512 wird unter Verwendung des URI-Pfades und des zuvor berechneten SHA256-Digest mit dem Base64-dekodierten privaten API-Schlüssel als HMAC-Schlüssel berechnet. Ein Beispiel für die Daten, die an den HMAC übergeben werden sollten, wäre wie folgt:HMAC SHA512 unter Verwendung des Base64-dekodierten privaten Schlüssels = HMAC von "/0/private/TradeBalanceSHA256"Die HTTP-Header API-Key und API-Sign sind die einzigen beiden erforderlichen benutzerdefinierten HTTP-Header. Der API-Key-Header ist eine exakte Kopie des öffentlichen API-Schlüssels aus der Kontoverwaltung. Der API-Sign-Header ist der HMAC SHA512-Digest, der mit Base64 kodiert ist.

Weitere Informationen zu diesem Fehler finden Sie hier:https://support.kraken.com/hc/en-us/articles/360001148063Und mehr über Nonce und Nonce Window hier:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Fehler bei ungültiger Sitzung werden über die WebSocket-API zurückgegeben, wenn versucht wird, einen authentifizierten (privaten) Feed mit einem Authentifizierungstoken zu abonnieren, das nicht mehr gültig ist (z. B. bereits abgelaufen ist).

Die Lösung besteht einfach darin, ein neues Authentifizierungstoken über den REST-API-Endpunkt GetWebSocketsToken anzufordern und das neue Token für alle nachfolgenden authentifizierten (privaten) Abonnementanfragen zu verwenden.

Ein Fehler bei einer fehlerhaften Anfrage weist darauf hin, dass etwas an der zugrunde liegenden HTTP-Anfrage (nicht der nachfolgenden API-Anfrage) nicht stimmt, z. B. nicht übereinstimmende URLs zwischen REST/WebSocket oder das HTTP-POST-Daten nicht korrekt enthalten sind:

% curl --data "" https://api.kraken.com/0/private/GetWebSocketsToken

{"error":["EAPI:Bad request"]}

Dieser Fehler wird zurückgegeben, wenn der aufgerufene Endpunkt kein gültiger Endpunkt ist.

Sie haben das API-Ratenlimit überschritten.

Das Hinzufügen und Stornieren von Aufträgen wird zwar nicht auf unsere Standard-API-Zählerlimits angerechnet, diese Vorgänge haben jedoch einen eigenen Zähler für das Hinzufügen und Stornieren von Aufträgen. Dieser Zähler funktioniert so, dass je länger Aufträge im Orderbuch verbleiben, desto mehr Aufträge können Kunden hinzufügen oder stornieren.

Fehlermeldungen zu temporären Sperrungen können auftreten, wenn Sie in kurzer Zeit zu viele fehlgeschlagene API-Aufrufe oder zu viele ungültige Nonce-Fehler oder ungültige Signaturen hatten. Auch wenn diese Aufrufe einen Fehler zurückgeben, wird dieser Fehler dennoch auf Ihre API-Limits angerechnet und kann zu einer temporären Sperrung führen.

Temporäre Sperrungen dauern etwa 15 Minuten. Nachdem Sie den Fehler der temporären Sperrung erhalten haben, warten Sie bitte 15 Minuten, bevor Sie neue API-Anfragen senden. Wenn Sie mehrere ungültige Nonce-Fehler auslösen, erhöhen Sie bitte das Nonce-Fenster, da dies dazu beitragen kann, die Häufigkeit dieser Fehler zu reduzieren. Bitte versuchen Sie auch, die Häufigkeit Ihrer privaten API-Aufrufe zu reduzieren.

Das Eröffnen neuer Spot-Positionen auf Margin wurde aufgrund von Wartungsarbeiten an der Trading-Engine vorübergehend ausgesetzt. Die Funktion wird bald wieder verfügbar sein, und Sie können die Updates auf status.kraken.com verfolgen.

Ein weiterer Grund könnte sein, dass Spot-Positionen auf Margin derzeit für Kunden in bestimmten Ländern nicht verfügbar sind.

Auf Kraken können Sie keine Long- und Short-Position für dasselbe Paar eröffnen.

Wenn Sie eine Long- und Short-Position für dieselbe Währung eröffnen möchten, wählen Sie bitte verschiedene Handelspaare mit derselben Währung als Basis- oder Notierungswährung. Beispiel: Short XBT/USD, Long XBT/EUR.

Dieser Fehler tritt auf, wenn Sie die Margin-Freigabegrenzen für Ihr aktuelles Verifizierungslevel überschritten haben. Die Margin-Freigabegrenzen variieren für jede Währung basierend auf Ihrem aktuellen Verifizierungslevel.

Wir haben nur begrenzte Mittel für Margin-Erweiterungen zur Verfügung. Die Meldung "unzureichende Margin" weist darauf hin, dass uns im Moment die Mittel im entsprechenden Margin-Pool ausgegangen sind. Dies kann sich jederzeit ändern. Es kann sein, dass Sie Ihre Order Sekunden oder Minuten später erfolgreich platzieren können, aber Orders mit hohem Volumen und Orders, die zu Zeiten hohen Volumens platziert werden, können länger dauern. Wir bitten um Entschuldigung für etwaige Unannehmlichkeiten.

Dieser Fehler tritt auf, wenn nicht genügend freie Margin vorhanden ist, um eine neue Position auf dem Konto zu eröffnen, oder wenn der aktuelle Versuch, eine Position zu eröffnen, dazu führen würde, dass die freie Margin des Kontos unter 100 % fällt.

Sie verfügen nicht über die notwendigen Mittel, um diese Order zu platzieren. Bitte überprüfen Sie Ihre offenen Positionen und Orders auf Posten, die Ihre Mittel blockieren könnten.

Sie haben das Mindestordervolumen für diesen Vermögenswert nicht erreicht.

Sie haben die maximale Anzahl offener Orders für Ihr Konto überschritten.

Diese Limits basieren auf Ihrem Verifizierungslevel. Bitte schließen Sie einige Ihrer offenen Orders oder verifizieren Sie Ihr Konto auf ein höheres Level.

Sie haben die maximale Anzahl offener Positionen für Ihr Konto überschritten.

Diese Limits basieren auf Ihrem Verifizierungslevel. Bitte schließen oder begleichen Sie einige oder alle Ihrer offenen Positionen oder verifizieren Sie Ihr Konto, falls möglich, auf ein höheres Level.

Es wurde versucht, eine bestehende (offene) Order zu bearbeiten, aber die Änderungen konnten nicht erfolgreich abgeschlossen werden. Mögliche Gründe sind unzureichende Mittel für die neue Order, einige Teilausführungsszenarien und einige gehebelte Orders.

Das neue Volumen ist geringer als das bereits ausgeführte/gefüllte Volumen.

Die Auftragsgröße hat das Positionsgrößenlimit für Margin des Handelspaares überschritten.

Das angezeigte Volumen hat das Mindestauftragsvolumen nicht erreicht.

Das angezeigte Volumen muss kleiner sein als das Volumen des Auftrags.

Iceberg-Orders sind mit keinen anderen Orderarten außer Limit-Orders kompatibel.

Jede Kryptowährung hat maximal 5 neue (unbenutzte) Einzahlungsadressen. Jeder Versuch, eine 6. neue Adresse zu erstellen, führt zu einem Fehler.

Dieser Fehler wird zurückgegeben, wenn die Finanzierungs-Endpunkte mit einem ungültigen oder fehlenden "method"-Parameter aufgerufen werden. 

Der Eingabeparameter "key" entspricht nicht der Adressbeschreibung, die in der Kontoverwaltung (über Finanzierung -> Auszahlung) festgelegt wurde.

Die Mindestauszahlungsbeträge variieren je nach Währung, und jeder Auszahlungsversuch unterhalb des Minimums würde zu diesem Fehler führen.

Dies ist ein allgemeiner Fehler, der darauf hinweist, dass eine Finanzierungsanfrage nicht abgeschlossen werden konnte (zum Beispiel würden Kunden aus bestimmten Regionen, die versuchen, On-Chain-Staking-Anfragen zu stellen, diesen Fehler verursachen).

Die angeforderte Auszahlung konnte nicht abgeschlossen werden, da der Zieladresse die erforderlichen Begünstigten-/Empfängerinformationen fehlen (beachten Sie, dass dies derzeit nur für ausgewählte Auszahlungen von kanadischen Konten gilt).

Die Dienstfehler, die Sie erleben, sollten nur vorübergehend sein. Sie können Ihre Anfragen erneut senden, falls sie fehlgeschlagen sind. Wir werden die Probleme überwachen und unsere Seite aktualisieren:

https://status.kraken.com/

Wenn wir mit Problemen bei der API-Leistung konfrontiert sind, können sich diese für Kraken in Form von Meldungen über nicht verfügbare Dienste und Website-Ausfällen äußern.

Dieses Problem hängt mit der Sicherheit Ihres Kontos zusammen, das möglicherweise kompromittiert wurde. Bitte ändern Sie Ihr Passwort und die Zwei-Faktor-Authentifizierung und kontaktieren Sie unser Support-Center.

Dieser Fehler tritt auf, wenn ein Flag oder ein Eingabeparameter vorübergehend oder dauerhaft deaktiviert ist. Der Fehler sollte von einer der übergebenen Eingaben stammen. Bitte kontaktieren Sie unseren Support und senden Sie ein Protokoll mit den vollständigen Informationen, die für den Aufruf verwendet wurden, der den Fehler generiert hat.

Diese 5xx- und 10xx-Fehler sind keine eigentlichen API-Fehler, sondern Webserver-Fehler von Cloudflare.

API-Fehler werden immer im JSON-Format zurückgegeben, z. B. „error“:[„ErrorType:ErrorMessage“]. Wenn also ein Fehler in einem anderen Format empfangen wird (z. B. ein HTTP-Statuscode von 520, 504, 502, 1020 usw.), besteht die vorläufige Lösung darin, den API-Aufruf kurz danach erneut zu versuchen, und hoffentlich wird der Aufruf dann erfolgreich sein.