WebSocket API v1 – Orders platzieren und stornieren

Zuletzt aktualisiert: 1. April 2025

Unsere WebSocket API v1 unterstützt den Handel über die addOrder- und cancelOrder-Endpunkte. Der addOrder-Endpunkt wird zum Platzieren neuer Orders verwendet und der cancelOrder-Endpunkt zum Stornieren bestehender (offener) Orders.

Sowohl addOrder als auch cancelOrder sind private Endpunkte, was bedeutet, dass sie nur über eine authentifizierte WebSocket-Verbindung zugänglich sind.

Eine anfängliche Verbindung sollte zur authentifizierten WebSocket-URL wss://ws-auth.kraken.com/ hergestellt werden, die dann unbegrenzt offen gehalten werden kann, während Orders platziert und storniert werden. Eine einzelne WebSocket-Verbindung ist darauf ausgelegt, mehrere Anfragen zu unterstützen, daher ist es nicht notwendig (oder empfohlen), sich für jeden Aufruf der Handels-Endpunkte zu verbinden/trennen.

WebSocket-Authentifizierung

Ein WebSocket-Authentifizierungstoken kann über den REST API GetWebSocketsToken-Endpunkt abgerufen werden.

Sobald ein Token abgerufen wurde, kann eine Verbindung zur privaten WebSocket-URL wss://ws-auth.kraken.com/ hergestellt werden, und die addOrder- und cancelOrder-Endpunkte können dann unbegrenzt verwendet werden (der Token läuft nicht ab, solange er zum Platzieren und Stornieren von Orders verwendet wird).

Beachten Sie, dass der API-Schlüssel, der zum Abrufen des Tokens verwendet wird, sowohl die Berechtigungen Modify Orders als auch Cancel/Close Orders besitzen muss, andernfalls wird ein Fehler „permission denied“ von der WebSocket API empfangen.

Order platzieren

Sobald eine authentifizierte WebSocket-Verbindung hergestellt wurde, kann eine Order durch Senden einer Nachricht wie der folgenden platziert werden:

  • •

    {"event":"addOrder", "token":"nT9n23/7oLdq+bNHNMNJ4VvF1hiHhjTnPOaCMiB1GJ0", "pair":"XBT/USD", "type":"buy", "ordertype":"limit", "price":"9857", "volume":"0.002", "leverage":"5", "userref":"8874657"}

Es wird dann eine Antwort empfangen, die den Status der Anfrage angibt (ob die Order angenommen oder abgelehnt wurde). Für eine Order, die erfolgreich angenommen und platziert wurde, zeigt die Antwort den Status ok an und ist ähnlich der folgenden:

  • •

    {"descr":"buy 0.00200000 XBTUSD @ limit 9857.0 with 5:1 leverage","event":"addOrderStatus","status":"ok","txid":"OPOUJF-BWKCL-FG5DQL"}

Für eine Order, die abgelehnt und nicht platziert wurde, zeigt die Antwort den Status error an, zusammen mit einer Fehlermeldung, die den Grund für die Ablehnung angibt (ungültige Argumente, unzureichende Mittel usw.), wie die folgende Ablehnung für eine Order, die die Mindestordergröße nicht erfüllte:

  • •

    {"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}

Order stornieren

Sobald eine authentifizierte WebSocket-Verbindung hergestellt wurde (oder vorzugsweise eine bestehende Verbindung wiederverwendet wird), kann eine Order durch Senden einer Nachricht wie der folgenden storniert werden:

  • •

    {"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}

Es wird dann eine Antwort empfangen, die den Status der Anfrage angibt (ob die Stornierung angenommen oder abgelehnt wurde). Für eine Order, die erfolgreich storniert wurde, zeigt die Antwort den Status ok an und ist ähnlich der folgenden:

  • •

    {"event":"cancelOrderStatus","status":"ok"}

Für eine abgelehnte Stornierungsanfrage zeigt die Antwort den Status error an, zusammen mit einer Fehlermeldung, die den Grund für die Ablehnung angibt (ungültige Order-ID usw.), wie die folgende Ablehnung für eine Anfrage zur Stornierung einer bereits stornierten Order:

  • •

    {"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}

Beachten Sie, dass es im Gegensatz zum REST API CancelOrder-Endpunkt möglich ist, mehrere Order-IDs in einer einzigen WebSocket-Stornierungsnachricht anzugeben. Die zu stornierenden Order-IDs sollten als separate Einträge innerhalb des txid-Arrays enthalten sein, wie folgt:

  • •

    {"event":"cancelOrder", "token":"c4JjTNHSurKmWDsnrGaCxIuCOa4FurCZK2ppktvT2Yo", "txid":["OLVCRZ-DNKJI-VRTZKY","O67X6E-PBGSR-GU23R5","OECCDC-T2R4V-52CR7T"]}

Brauchst du weitere Hilfe?