Ιδιωτικό κανάλι χρήστη

Προβολή ως Markdown

Δημιουργήστε πρώτα ένα listenKey :

1POST /v1/private/user/listen-key

Παράδειγμα απάντησης:

1{
2 "code": 0,
3 "message": "success",
4 "data": {
5 "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c",
6 "expireAt": 1777539918867
7 },
8 "requestId": "req-listen-key"
9}

listenKey ισχύει για 60 λεπτά από προεπιλογή. Συνιστάται ανανέωση κάθε 30 λεπτά.

Ανανέωση

1PUT /v1/private/user/listen-key
2Content-Type: application/json
1{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

Κλείσιμο

1DELETE /v1/private/user/listen-key
2Content-Type: application/json
1{ "listenKey": "f57cb61ef604ce76be09e753a5dbdd8c" }

Σύνδεση σε ιδιωτικές WebSocket

wss://ws.6mm.com/ws?listenKey=YOUR_LISTEN_KEY

Συμβατή μέθοδος σύνδεσης JWT :

wss://ws.6mm.com/ws?token=YOUR_ACCESS_TOKEN

Μετά την επιτυχία του ελέγχου ταυτότητας, ο διακομιστής εγγράφει αυτόματα τη σύνδεση στο ιδιωτικό κανάλι του τρέχοντος χρήστη. Δεν απαιτείται μη αυτόματη συνδρομή.

Επιτυχής επιβεβαίωση ελέγχου ταυτότητας:

1{ "event": "auth", "success": true, "data": "1188041528" }

Κοινές ιδιωτικές εκδηλώσεις

ΕκδήλωσηΠεριγραφή
ORDER_TRADE_UPDATEΑλλαγές κατάστασης παραγγελίας, συμπεριλαμβανομένης της νέας παραγγελίας, της τροποποίησης, της συναλλαγής και της ακύρωσης
ACCOUNT_UPDATEΑλλαγές υπολοίπου λογαριασμού και θέσης

Περιτύλιγμα ιδιωτικών μηνυμάτων push:

1{
2 "topic": "user.5794",
3 "ts": 1771047000000,
4 "data": {
5 "eventType": "ORDER_TRADE_UPDATE"
6 }
7}

REST τα τελικά σημεία ερωτημάτων και οι ιδιωτικές ροές WebSocket χρησιμοποιούν ξεχωριστά σχήματα. Οι πελάτες θα πρέπει να αναλύουν κάθε σχήμα ανεξάρτητα και δεν θα πρέπει να υποθέτουν ότι τα ονόματα των πεδίων είναι πανομοιότυπα.

Κοινές διαφορές

ΤομέαςREST πεδίοWebSocket πεδίο
Κατάσταση παραγγελίαςstatusorderStatus
Παγωμένο υπόλοιποfrozenMarginfrozenBalance
Λειτουργία περιθωρίουmarginModemarginMode, επιστράφηκε ως συμβολοσειρά σε θέσεις και ροές

Ανάκτηση και συμφιλίωση

  • Ανανεώστε το listenKey πριν από τη λήξη και δημιουργήστε ένα νέο εάν αποτύχει η ανανέωση.
  • Επανασυνδεθείτε, επαναλάβετε τον έλεγχο ταυτότητας και αντιμετωπίστε τη νέα υποδοχή ως νέα περίοδο λειτουργίας συμβάντος.
  • Καταργήστε τα διπλότυπα συμβάντα πριν αλλάξετε τα υπόλοιπα συνεργατών ή τα αρχεία παραγγελιών.
  • Εάν μπορεί να έχουν χαθεί συμβάντα, ρωτήστε Παραγγελίες, Θέσεις, και κατάσταση λογαριασμού μέσω REST.
  • Ακολουθήστε το Οδηγός σύνδεσης και καρδιακού παλμού για επανάληψη και χειρισμό μπαγιάτικης σύνδεσης.