Özel Kullanıcı Kanalı

Markdown olarak görüntüle

Önce bir listenKey oluşturun:

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

Yanıt örneği:

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

listenKey varsayılan olarak 60 dakika geçerlidir. Her 30 dakikada bir yenileme önerilir.

Yenileme

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

Kapat

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

Özel WebSocket

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

Uyumlu JWT bağlantı yöntemi:

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

Kimlik doğrulama başarılı olduktan sonra, sunucu bağlantıyı otomatik olarak mevcut kullanıcının özel kanalına abone eder. Manuel abonelik gerektirmez.

Başarılı kimlik doğrulama onayı:

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

Yaygın özel etkinlikler

EtkinlikTanım
ORDER_TRADE_UPDATESipariş durumu değişiklikleri, yeni emir, düzeltme, ticaret ve iptal dahil
ACCOUNT_UPDATEHesap bakiyesi ve pozisyon değişiklikleri

Özel push mesaj wrapper:

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

REST sorgu uç noktaları ve WebSocket özel akışlar ayrı şemalar kullanır. Müşteriler her şemayı bağımsız olarak ayrıştırmalı ve alan adlarının aynı olduğunu varsaymamalıdır.

Ortak farklar

AlanREST alanıWebSocket alanı
Sipariş durumustatusorderStatus
Donmuş dengefrozenMarginfrozenBalance
Marj modumarginModemarginMode, pozisyonlarda ve akışlarda bir ip olarak geri döndü

İyileşme ve uzlaşma

  • Süresi dolmadan önce listenKey yenilemek ve yenileme başarısız olursa yeni bir tane oluşturmak gerekir.
  • Yeniden bağlanın, yeniden kimlik doğrulama yapın ve yeni soketi yeni bir etkinlik oturumu olarak ele alın.
  • Ortak bakiyelerini veya sipariş kayıtlarını değiştirmeden önce olayları deduplicate edin.
  • Eğer etkinlikler kaçırılmış olabilirse, sorgulama Emirler, Pozisyonlar, ve hesap durumu RESTiçin.
  • Takip edin Bağlantı ve Kalp Atışı Rehberi Yeniden deneme ve eski bağlantı yönetimi için.