Orders plaatsen - addOrder
Orders annuleren - cancelOrder
Handelen (het plaatsen en annuleren van orders) via de WebSocket API v1 wordt mogelijk gemaakt door de addOrder- en cancelOrder-endpoints. Vergelijkbaar met handelen via de REST API, wordt het addOrder-endpoint gebruikt om nieuwe orders te plaatsen en het cancelOrder-endpoint om bestaande (openstaande) orders te annuleren.
Zodra er een verbinding met de WebSocket API tot stand is gebracht, kunnen orders worden geplaatst en geannuleerd via de volgende stappen:
haal een authenticatietoken op via het REST API GetWebSocketsToken-endpoint (zodra een geldig token is opgehaald, kan hetzelfde token worden gebruikt voor meerdere addOrder/cancelOrder-aanvragen),
verstuur de juiste addOrder/cancelOrder-aanvraag,
ontvang een reactie die aangeeft of de aanvraag succesvol was of niet.
Onze WebSocket API-documentatie bevat de volledige specificatie voor het addOrder-endpoint, inclusief het JSON-formaat dat moet worden gebruikt, samen met beschrijvingen van elk vereist en optioneel veld.
Als voorbeeld zou het volgende JSON-bericht een nieuwe order plaatsen om 0,25 ETH/EUR te kopen tegen een limietprijs van € 150:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Ervan uitgaande dat de bovenstaande order succesvol is geplaatst (voldoende saldo beschikbaar op de account, enz.), wordt het volgende JSON-bericht als reactie ontvangen:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
Onze WebSocket API-documentatie bevat de volledige specificatie voor het cancelOrder-endpoint, inclusief het JSON-formaat dat moet worden gebruikt, samen met beschrijvingen van elk vereist en optioneel veld.
In tegenstelling tot de REST API kan het WebSocket API cancelOrder-endpoint worden gebruikt om meerdere orders tegelijkertijd te annuleren, door elke order-ID (of gebruikersreferentie) op te geven in de txid-array.
Als voorbeeld zou het volgende JSON-bericht alle openstaande orders met de overeenkomstige order-ID's annuleren:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Ervan uitgaande dat de orders succesvol zijn geannuleerd, wordt het volgende JSON-bericht als reactie ontvangen:
{
"event": "cancelOrderStatus",
"status": "ok"
}