WebSocket API v1 Handel – addOrder und cancelOrder

Zuletzt aktualisiert: 1. April 2025
  • Aufträge platzieren – addOrder

  • Aufträge stornieren – cancelOrder

Der Handel (Platzieren und Stornieren von Aufträgen) über die WebSocket API v1 wird bereitgestellt durch die addOrder und cancelOrder Endpunkte. Ähnlich wie beim Handel über die REST API, wird der addOrder-Endpunkt zum Platzieren neuer Aufträge und der cancelOrder-Endpunkt zum Stornieren bestehender (offener) Aufträge verwendet.

Sobald eine Verbindung zur WebSocket API hergestellt wurde, können Aufträge über die folgenden Schritte platziert und storniert werden:

  1. 1

    einen Authentifizierungs-Token abrufen über den REST API GetWebSocketsToken endpoint (sobald ein gültiger Token abgerufen wurde, kann derselbe Token für mehrere addOrder-/cancelOrder-Anfragen verwendet werden),

  2. 2

    die entsprechende addOrder-/cancelOrder-Anfrage senden,

  3. 3

    eine Antwort erhalten, die angibt, ob die Anfrage erfolgreich war oder nicht.

Aufträge platzieren – addOrder

Unsere WebSocket API-Dokumentation bietet die vollständige Spezifikation für den addOrder-Endpunkt, einschließlich des zu verwendenden JSON-Formats, zusammen mit Beschreibungen jedes erforderlichen und optionalen Feldes.

Als Beispiel würde die folgende JSON-Nachricht einen neuen Auftrag zum Kauf von 0,25 ETH/EUR zu einem Limitpreis von 150 € platzieren:

{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}

Angenommen, der obige Auftrag wurde erfolgreich platziert (ausreichende Mittel im Kontostand verfügbar usw.), würde die folgende JSON-Nachricht als Antwort empfangen werden:

{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

Aufträge stornieren – cancelOrder

Unsere WebSocket API-Dokumentation bietet die vollständige Spezifikation für den cancelOrder-Endpunkt, einschließlich des zu verwendenden JSON-Formats, zusammen mit Beschreibungen jedes erforderlichen und optionalen Feldes.

Im Gegensatz zur REST API kann der WebSocket API cancelOrder-Endpunkt verwendet werden, um mehrere Aufträge gleichzeitig zu stornieren, indem jede Auftrags-ID (oder Benutzerreferenz) im txid-Array angegeben wird.

Als Beispiel würde die folgende JSON-Nachricht alle offenen Aufträge mit den übereinstimmenden Auftrags-IDs stornieren:

{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}

Angenommen, die Aufträge wurden erfolgreich storniert, würde die folgende JSON-Nachricht als Antwort empfangen werden:

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

Brauchst du weitere Hilfe?