WebSocket API v1 Handel - addOrder og cancelOrder

Sist oppdatert: 1. april 2025
  • Plassere ordre - addOrder

  • Kansellere ordre - cancelOrder

Handel (plassering og kansellering av ordre) via WebSocket API v1 tilbys av addOrder- og cancelOrder-endepunktene. I likhet med handel via REST API, brukes addOrder-endepunktet til å plassere nye ordre, og cancelOrder-endepunktet brukes til å kansellere eksisterende (åpne) ordre.

Når en tilkobling til WebSocket API er etablert, kan ordre plasseres og kanselleres via følgende trinn:

  1. 1

    hent et autentiseringstoken via REST API GetWebSocketsToken-endepunktet (når et gyldig token er hentet, kan det samme tokenet brukes for flere addOrder/cancelOrder-forespørsler),

  2. 2

    send den aktuelle addOrder/cancelOrder-forespørselen,

  3. 3

    motta et svar som indikerer om forespørselen var vellykket eller ikke.

Plassere ordre - addOrder

Vår WebSocket API-dokumentasjon gir den komplette spesifikasjonen for addOrder-endepunktet, inkludert JSON-formatet som må brukes, sammen med beskrivelser av hvert obligatoriske og valgfrie felt.

Som et eksempel vil følgende JSON-melding plassere en ny ordre for å kjøpe 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"
}

Forutsatt at ordren ovenfor ble plassert vellykket (tilstrekkelige midler tilgjengelig på kontosaldoen, osv.), vil følgende JSON-melding mottas som svar:

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

Kansellere ordre - cancelOrder

Vår WebSocket API-dokumentasjon gir den komplette spesifikasjonen for cancelOrder-endepunktet, inkludert JSON-formatet som må brukes, sammen med beskrivelser av hvert obligatoriske og valgfrie felt.

I motsetning til REST API, kan WebSocket API cancelOrder-endepunktet brukes til å kansellere flere ordre samtidig, ved å spesifisere hver ordre-ID (eller brukerreferanse) i txid-arrayet.

Som et eksempel vil følgende JSON-melding kansellere enhver åpen ordre med de samsvarende ordre-ID-ene:

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

Forutsatt at ordrene ble kansellert vellykket, vil følgende JSON-melding mottas som svar:

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

Trenger du mer hjelp?