Lägga ordrar - addOrder
Avbryta ordrar - cancelOrder
Handel (att lägga och avbryta ordrar) via WebSocket API v1 tillhandahålls av addOrder- och cancelOrder-slutpunkterna. I likhet med handel via REST API, används addOrder-slutpunkten för att lägga nya ordrar, och cancelOrder-slutpunkten används för att avbryta befintliga (öppna) ordrar.
När en anslutning till WebSocket API har upprättats kan ordrar läggas och avbrytas via följande steg:
hämta en autentiseringstoken via REST API GetWebSocketsToken-slutpunkten (när en giltig token har hämtats kan samma token användas för flera addOrder-/cancelOrder-förfrågningar),
skicka lämplig addOrder-/cancelOrder-förfrågan,
ta emot ett svar som indikerar om förfrågan lyckades eller inte.
Vår WebSocket API-dokumentation tillhandahåller den kompletta specifikationen för addOrder-slutpunkten, inklusive det JSON-format som måste användas, tillsammans med beskrivningar av varje obligatoriskt och valfritt fält.
Som ett exempel skulle följande JSON-meddelande lägga en ny order för att köpa 0,25 ETH/EUR till ett limitpris på 150 €:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Förutsatt att ovanstående order lades framgångsrikt (tillräckliga medel tillgängliga på kontosaldot, etc.), skulle följande JSON-meddelande tas emot som svar:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
Vår WebSocket API-dokumentation tillhandahåller den kompletta specifikationen för cancelOrder-slutpunkten, inklusive det JSON-format som måste användas, tillsammans med beskrivningar av varje obligatoriskt och valfritt fält.
Till skillnad från REST API kan WebSocket API:s cancelOrder-slutpunkt användas för att avbryta flera ordrar samtidigt, genom att ange varje order-ID (eller användarreferens) i txid-arrayen.
Som ett exempel skulle följande JSON-meddelande avbryta alla öppna ordrar med matchande order-ID:n:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Förutsatt att ordrarna avbröts framgångsrikt, skulle följande JSON-meddelande tas emot som svar:
{
"event": "cancelOrderStatus",
"status": "ok"
}