Τοποθέτηση εντολών - addOrder
Ακύρωση εντολών - cancelOrder
Η διαπραγμάτευση (τοποθέτηση και ακύρωση εντολών) μέσω του WebSocket API v1 παρέχεται από τα addOrder και cancelOrder τελικά σημεία. Παρόμοια με τη διαπραγμάτευση μέσω του REST API, το τελικό σημείο addOrder χρησιμοποιείται για την τοποθέτηση νέων εντολών, και το τελικό σημείο cancelOrder χρησιμοποιείται για την ακύρωση υφιστάμενων (ανοιχτών) εντολών.
Μόλις δημιουργηθεί μια σύνδεση με το WebSocket API, οι εντολές μπορούν να τοποθετηθούν και να ακυρωθούν μέσω των ακόλουθων βημάτων:
ανάκτηση ενός διακριτικού ελέγχου ταυτότητας μέσω του REST API GetWebSocketsToken endpoint (μόλις ανακτηθεί ένα έγκυρο διακριτικό, το ίδιο διακριτικό μπορεί να χρησιμοποιηθεί για πολλαπλά αιτήματα addOrder/cancelOrder),
αποστολή του κατάλληλου αιτήματος addOrder/cancelOrder,
λήψη απάντησης που να υποδεικνύει εάν το αίτημα ήταν επιτυχές ή όχι.
Η τεκμηρίωση του WebSocket API μας παρέχει την πλήρη προδιαγραφή για το τελικό σημείο addOrder, συμπεριλαμβανομένης της μορφής JSON που πρέπει να χρησιμοποιηθεί, μαζί με περιγραφές κάθε απαιτούμενου και προαιρετικού πεδίου.
Ως παράδειγμα, το ακόλουθο μήνυμα JSON θα τοποθετούσε μια νέα εντολή αγοράς 0,25 ETH/EUR σε οριακή τιμή 150 €:
{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}
Υποθέτοντας ότι η παραπάνω εντολή τοποθετήθηκε επιτυχώς (επαρκή κεφάλαια διαθέσιμα στο υπόλοιπο λογαριασμού, κ.λπ.), το ακόλουθο μήνυμα JSON θα ληφθεί ως απάντηση:
{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}
Η τεκμηρίωση του WebSocket API μας παρέχει την πλήρη προδιαγραφή για το τελικό σημείο cancelOrder, συμπεριλαμβανομένης της μορφής JSON που πρέπει να χρησιμοποιηθεί, μαζί με περιγραφές κάθε απαιτούμενου και προαιρετικού πεδίου.
Σε αντίθεση με το REST API, το τελικό σημείο cancelOrder του WebSocket API μπορεί να χρησιμοποιηθεί για την ταυτόχρονη ακύρωση πολλαπλών εντολών, καθορίζοντας κάθε αναγνωριστικό εντολής (ή αναφορά χρήστη) στον πίνακα txid.
Ως παράδειγμα, το ακόλουθο μήνυμα JSON θα ακύρωνε οποιαδήποτε ανοιχτή εντολή με τα αντίστοιχα αναγνωριστικά εντολών:
{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}
Υποθέτοντας ότι οι εντολές ακυρώθηκαν επιτυχώς, το ακόλουθο μήνυμα JSON θα ληφθεί ως απάντηση:
{
"event": "cancelOrderStatus",
"status": "ok"
}