FINGER TRADER

marketDataDocsPage.wsQuotes

Giá trực tiếp qua WebSocket

Đăng ký cập nhật giá trên socket dữ liệu thị trường đã xác thực. Chọn công cụ của thị trường rồi đăng ký bằng mã ticker.

Khung tài liệu · Tổng quan

Giá trực tiếp và độ sâu thị trường qua WebSocket

Ứ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.

POST https://prod-api.fingertrader.com/finger-bff-socket/ws-api/v1/auth/build-ticket
Authorization: Bearer <ACCESS_TOKEN>

wss://prod-api.fingertrader.com/finger-bff-socket/ws?ticket=<WS_TICKET>

2. Kết nối Socket production · Đăng ký cập nhật giá: action 3, msgType 1. Thông điệp giá nhận được dùng msgType 0.

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.

Đăng ký cập nhật giá: action 3, msgType 1. Thông điệp giá nhận được dùng msgType 0.

{"action":3,"fromUserId":"<SESSION_USER_ID>","timestamp":"<EPOCH_MILLISECONDS>","msgType":1,"msgId":"<UNIQUE_MESSAGE_ID>","content":{"tickerList":["<TICKER>"]}}

Trường dữ liệu thị trường nhận được

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.

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ợ.