WebSocket API v1 Handel - addOrder og cancelOrder

Senest opdateret: 1. april 2025
  • Placering af ordrer - addOrder

  • Annullering af ordrer - cancelOrder

Handel (placering og annullering af ordrer) via WebSocket API v1 leveres af addOrder- og cancelOrder-slutpunkterne. I lighed med handel via REST API'en bruges addOrder-slutpunktet til at placere nye ordrer, og cancelOrder-slutpunktet bruges til at annullere eksisterende (åbne) ordrer.

Når en forbindelse til WebSocket API'en er etableret, kan ordrer placeres og annulleres via følgende trin:

  1. 1

    hent et autentificeringstoken via REST API GetWebSocketsToken-slutpunktet (når et gyldigt token er hentet, kan det samme token bruges til flere addOrder-/cancelOrder-anmodninger),

  2. 2

    send den passende addOrder-/cancelOrder-anmodning,

  3. 3

    modtag en respons, der angiver, om anmodningen var vellykket eller ej.

Placering af ordrer - addOrder

Vores WebSocket API-dokumentation giver den komplette specifikation for addOrder-slutpunktet, inklusive det JSON-format, der skal bruges, samt beskrivelser af hvert påkrævet og valgfrit felt.

Som et eksempel ville følgende JSON-meddelelse placere en ny ordre om at købe 0,25 ETH/EUR til en limitpris på 150 €:

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

Forudsat at ovenstående ordre blev placeret med succes (tilstrækkelige midler tilgængelige på kontosaldoen osv.), ville følgende JSON-meddelelse blive modtaget som respons:

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

Annullering af ordrer - cancelOrder

Vores WebSocket API-dokumentation giver den komplette specifikation for cancelOrder-slutpunktet, inklusive det JSON-format, der skal bruges, samt beskrivelser af hvert påkrævet og valgfrit felt.

I modsætning til REST API'en kan WebSocket API'ens cancelOrder-slutpunkt bruges til at annullere flere ordrer samtidigt ved at specificere hvert ordre-ID (eller brugerreference) i txid-arrayet.

Som et eksempel ville følgende JSON-meddelelse annullere enhver åben ordre med de matchende ordre-ID'er:

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

Forudsat at ordrerne blev annulleret med succes, ville følgende JSON-meddelelse blive modtaget som respons:

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

Har du brug for mere hjælp?