Saluran Pengguna Pribadi

View as Markdown

Buat listenKey terlebih dahulu:

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

Contoh respons:

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

listenKey berlaku selama 60 menit secara default. Perpanjangan setiap 30 menit sangat dianjurkan.

Perbarui

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

Tutup

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

Terhubung ke WebSocket pribadi

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

Metode koneksi JWT yang kompatibel:

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

Setelah autentikasi berhasil, server secara otomatis berlangganan koneksi ke saluran privat pengguna saat ini. Tidak diperlukan langganan manual.

Pengakuan autentikasi yang berhasil:

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

Acara pribadi umum

AcaraDeskripsi
ORDER_TRADE_UPDATEPerubahan status pesanan, termasuk pesanan baru, perubahan, perdagangan, dan pembatalan
ACCOUNT_UPDATEPerubahan saldo akun dan posisi

Pembungkus pesan push privat:

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

REST endpoint query dan WebSocket private stream menggunakan skema terpisah. Klien harus memparse setiap skema secara independen dan tidak boleh mengasumsikan nama bidang identik.

Perbedaan umum

Domainbidang RESTbidang WebSocket
Status pesananstatusorderStatus
Keseimbangan bekufrozenMarginfrozenBalance
Mode marginmarginModemarginMode, dikembalikan sebagai string dalam posisi dan aliran

Pemulihan dan rekonsiliasi

  • Perbarui listenKey sebelum kedaluwarsa dan buat yang baru jika perpanjangan gagal.
  • Hubungkan kembali, autentikasi ulang, dan perlakukan soket baru sebagai sesi acara baru.
  • Deduplikasi peristiwa sebelum mengubah saldo mitra atau catatan pesanan.
  • Jika event mungkin terlewat, tanyakan orders, positions, dan account state melalui REST.
  • Ikuti panduan koneksi dan detak jantung untuk penanganan ulang dan koneksi yang tidak aktif.