Inserimento ordini - addOrder
Annullamento ordini - cancelOrder
Il trading (inserimento e annullamento ordini) tramite l'API WebSocket v1 è fornito dagli addOrder e cancelOrder endpoint. Analogamente al trading tramite la REST API, l'endpoint addOrder viene utilizzato per inserire nuovi ordini e l'endpoint cancelOrder viene utilizzato per annullare ordini esistenti (aperti).
Una volta stabilita una connessione all'API WebSocket, gli ordini possono essere inseriti e annullati tramite i seguenti passaggi:
recuperare un token di autenticazione tramite l'endpoint GetWebSocketsToken dell'API REST (una volta recuperato un token valido, lo stesso token può essere utilizzato per più richieste addOrder/cancelOrder),
inviare la richiesta appropriata addOrder/cancelOrder,
ricevere una risposta che indichi se la richiesta è andata a buon fine o meno.
La nostra documentazione dell'API WebSocket fornisce la specifica completa per l'endpoint addOrder, incluso il formato JSON che deve essere utilizzato, insieme alle descrizioni di ogni campo richiesto e opzionale.
Ad esempio, il seguente messaggio JSON inserirebbe un nuovo ordine per acquistare 0,25 ETH/EUR a un prezzo limite di 150 €:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Supponendo che l'ordine di cui sopra sia stato inserito con successo (fondi sufficienti disponibili nel saldo del conto, ecc.), il seguente messaggio JSON verrebbe ricevuto in risposta:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
La nostra documentazione dell'API WebSocket fornisce la specifica completa per l'endpoint cancelOrder, incluso il formato JSON che deve essere utilizzato, insieme alle descrizioni di ogni campo richiesto e opzionale.
A differenza dell'API REST, l'endpoint cancelOrder dell'API WebSocket può essere utilizzato per annullare più ordini contemporaneamente, specificando ogni ID ordine (o riferimento utente) nell'array txid.
Ad esempio, il seguente messaggio JSON annullerebbe qualsiasi ordine aperto con gli ID ordine corrispondenti:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Supponendo che gli ordini siano stati annullati con successo, il seguente messaggio JSON verrebbe ricevuto in risposta:
{
"event": "cancelOrderStatus",
"status": "ok"
}