WebSocket API v1 -kaupankäynti – addOrder ja cancelOrder

Viimeksi päivitetty: 1. huhtikuuta 2025
  • •

    Toimeksiantojen tekeminen – addOrder

  • •

    Toimeksiantojen peruuttaminen – cancelOrder

Kaupankäynti (toimeksiantojen tekeminen ja peruuttaminen) WebSocket API v1:n kautta tapahtuu addOrder- ja cancelOrder-päätepisteiden avulla. Samoin kuin kaupankäynnissä REST API:n kautta, addOrder-päätepistettä käytetään uusien toimeksiantojen tekemiseen ja cancelOrder-päätepistettä käytetään olemassa olevien (avoimien) toimeksiantojen peruuttamiseen.

Kun yhteys WebSocket API:hin on muodostettu, toimeksiantoja voidaan tehdä ja peruuttaa seuraavasti:

  1. 1

    hae todennustunnus REST API:n GetWebSocketsToken-päätepisteen kautta (kun voimassa oleva tunnus on haettu, samaa tunnusta voidaan käyttää useisiin addOrder/cancelOrder-pyyntöihin),

  2. 2

    lähetä asianmukainen addOrder/cancelOrder-pyyntö,

  3. 3

    vastaanota vastaus, joka ilmoittaa, onnistuiko pyyntö vai ei.

Toimeksiantojen tekeminen – addOrder

WebSocket API -dokumentaatiostamme löytyvät addOrder-päätepisteen täydelliset tekniset tiedot, mukaan lukien käytettävä JSON-muoto sekä kuvaukset jokaisesta pakollisesta ja valinnaisesta kentästä.

Esimerkiksi seuraava JSON-viesti tekisi uuden toimeksiannon, jolla ostetaan 0,25 ETH/EUR rajahintaan 150 €:

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

Olettaen, että yllä oleva toimeksianto tehtiin onnistuneesti (tilillä on riittävästi varoja jne.), vastauksena saataisiin seuraava JSON-viesti:

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

Toimeksiantojen peruuttaminen – cancelOrder

WebSocket API -dokumentaatiostamme löytyvät cancelOrder-päätepisteen täydelliset tekniset tiedot, mukaan lukien käytettävä JSON-muoto sekä kuvaukset jokaisesta pakollisesta ja valinnaisesta kentästä.

Toisin kuin REST API:ssa, WebSocket API:n cancelOrder-päätepistettä voidaan käyttää useiden toimeksiantojen peruuttamiseen samanaikaisesti määrittämällä kukin toimeksiantotunnus (tai käyttäjän viite) txid-taulukossa.

Esimerkiksi seuraava JSON-viesti peruuttaisi kaikki avoimet toimeksiannot, joilla on vastaavat toimeksiantotunnukset:

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

Olettaen, että toimeksiannot peruutettiin onnistuneesti, vastauksena saataisiin seuraava JSON-viesti:

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

Tarvitsetko lisää apua?