Megbízások elhelyezése - addOrder
Megbízások törlése - cancelOrder
Kereskedés (megbízások elhelyezése és törlése) a WebSocket API v1-en keresztül az addOrder és cancelOrder végpontok biztosítják. Hasonlóan a REST API-n keresztüli kereskedéshez, az addOrder végpont új megbízások elhelyezésére, a cancelOrder végpont pedig meglévő (nyitott) megbízások törlésére szolgál.
Miután létrejött a kapcsolat a WebSocket API-hoz, a megbízások a következő lépésekben helyezhetők el és törölhetők:
hitelesítési token lekérése a REST API GetWebSocketsToken végponton keresztül (miután egy érvényes token lekérésre került, ugyanaz a token több addOrder/cancelOrder kéréshez is felhasználható),
küldje el a megfelelő addOrder/cancelOrder kérést,
fogadjon választ, amely jelzi, hogy a kérés sikeres volt-e vagy sem.
A WebSocket API dokumentációnk tartalmazza az addOrder végpont teljes specifikációját, beleértve a használandó JSON formátumot, valamint az egyes kötelező és opcionális mezők leírását.
Példaként a következő JSON üzenet egy új megbízást helyezne el 0,25 ETH/EUR vásárlására 150 € limitáron:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Feltételezve, hogy a fenti megbízás sikeresen elhelyezésre került (elegendő fedezet áll rendelkezésre a számlaegyenlegen stb.), a következő JSON üzenet érkezne válaszként:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
A WebSocket API dokumentációnk tartalmazza a cancelOrder végpont teljes specifikációját, beleértve a használandó JSON formátumot, valamint az egyes kötelező és opcionális mezők leírását.
A REST API-val ellentétben a WebSocket API cancelOrder végpontja több megbízás egyidejű törlésére is használható, az egyes megbízásazonosítók (vagy felhasználói hivatkozások) megadásával a txid tömbben.
Példaként a következő JSON üzenet törölne minden nyitott megbízást a megfelelő megbízásazonosítókkal:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Feltételezve, hogy a megbízások sikeresen törlésre kerültek, a következő JSON üzenet érkezne válaszként:
{
"event": "cancelOrderStatus",
"status": "ok"
}