marketDataDocsPage.wsDepth
Độ sâu thị trường qua WebSocket
Đăng ký độ sâu bid/ask trên socket dữ liệu thị trường đã xác thực. Hỗ trợ và số mức giá phụ thuộc cấu hình môi giới và thị trường.
Đăng ký cập nhật độ sâu: action 3, msgType 3. Thông điệp độ sâu nhận được dùng msgType 2.
Ứng dụng Flutter dùng socket thị trường Finger Trader đã cấu hình. Lấy WebSocket ticket qua điểm cuối đã xác thực rồi kết nối bằng ticket đó. Ticket là thông tin xác thực phiên, không chia sẻ hoặc tái sử dụng.
Gọi POST /ws-api/v1/auth/build-ticket trên dịch vụ Socket Finger Trader với Bearer Token của tài khoản. Ứng dụng đọc ticket từ trường data trong phản hồi API chuẩn.
{"action":3,"fromUserId":"<SESSION_USER_ID>","timestamp":"<EPOCH_MILLISECONDS>","msgType":3,"msgId":"<UNIQUE_MESSAGE_ID>","content":{"tickerList":["<TICKER>"]}}Thông điệp giá gồm marketType, ticker, time, change, percent, volume, number, high, low, ask, bid, open, close và quoteVolume. Thông điệp độ sâu gồm marketType, ticker, time, các mức giá ask và bid. Hợp đồng ứng dụng không quy định tần suất gửi hoặc số mức độ sâu.
2. Kết nối Socket production · Đăng ký cập nhật độ sâu: action 3, msgType 3. Thông điệp độ sâu nhận được dùng msgType 2.
Gọi POST /ws-api/v1/auth/build-ticket trên dịch vụ Socket Finger Trader với Bearer Token của tài khoản. Ứng dụng đọc ticket từ trường data trong phản hồi API chuẩn.
Sẵn sàng. Chưa gửi gì cho đến khi bạn chọn Gửi yêu cầu.
Phản hồi sẽ hiển thị tại đây.
Access Token chỉ ở trong bộ nhớ của trang này, không lưu trong bộ nhớ trình duyệt hoặc gửi đến máy chủ website Finger Trader. Token chỉ được gửi đến môi trường API chính thức đã chọn sau khi nhấn Gửi yêu cầu.
Các giá trị dưới đây là enum marketType được định nghĩa trong ứng dụng Flutter, không phải danh sách thị trường broker của bạn đã bật. Phạm vi hỗ trợ thực tế tùy cấu hình tài khoản và kết nối, vì vậy hãy hỏi broker danh sách thị trường được hỗ trợ. Dùng mã tương ứng cho bộ lọc thị trường REST và yêu cầu dữ liệu lịch sử. Với WebSocket, hãy tìm ticker do broker cấu hình trong thị trường đó rồi đăng ký ticker. ticker-list giúp xem các công cụ trả về, nhưng kết quả trống không đủ để kết luận thị trường không được hỗ trợ.