FINGER TRADER

marketDataDocsPage.wsQuotes

ราคาเรียลไทม์ผ่าน WebSocket

สมัครรับการอัปเดตราคาผ่าน market socket ที่ยืนยันตัวตนแล้ว เลือกผลิตภัณฑ์ของตลาดและสมัครด้วย ticker

โครงสร้างเอกสาร · ภาพรวม

ราคาและความลึกตลาดเรียลไทม์ผ่าน WebSocket

แอป Flutter ใช้ market socket ของ Finger Trader ที่กำหนดไว้ รับ WebSocket ticket ผ่านเอนด์พอยต์ที่ยืนยันตัวตนแล้วจึงเชื่อมต่อ Ticket เป็นข้อมูลรับรองเซสชัน อย่าเปิดเผยหรือนำกลับมาใช้ซ้ำ

เรียก POST /ws-api/v1/auth/build-ticket บนบริการ Socket ของ Finger Trader พร้อม Bearer Token ของบัญชี แอปอ่าน ticket จากฟิลด์ data ในคำตอบ API มาตรฐาน

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. เชื่อมต่อ Production Socket · สมัครรับราคา: action 3, msgType 1 ข้อความราคาที่รับเข้ามาใช้ msgType 0

เรียก POST /ws-api/v1/auth/build-ticket บนบริการ Socket ของ Finger Trader พร้อม Bearer Token ของบัญชี แอปอ่าน ticket จากฟิลด์ data ในคำตอบ API มาตรฐาน

พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ

การตอบกลับจะแสดงที่นี่

Access Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกในพื้นที่จัดเก็บของเบราว์เซอร์หรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader ระบบจะส่ง Token ไปยัง API อย่างเป็นทางการที่เลือกหลังจากคุณกดส่งคำขอเท่านั้น

สมัครรับราคา: action 3, msgType 1 ข้อความราคาที่รับเข้ามาใช้ msgType 0

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

ฟิลด์ข้อมูลตลาดที่รับเข้า

ข้อความราคามี marketType, ticker, time, change, percent, volume, number, high, low, ask, bid, open, close และ quoteVolume ข้อความความลึกมี marketType, ticker, time และระดับราคา ask/bid สัญญาไคลเอนต์ไม่ได้ระบุความถี่การส่งหรือจำนวนระดับความลึก

ค่าด้านล่างคือ enum marketType ที่กำหนดไว้ในแอป Flutter ไม่ใช่รายการตลาดที่โบรกเกอร์ของคุณเปิดใช้ ขอบเขตที่รองรับจริงขึ้นอยู่กับการตั้งค่าบัญชีและการเชื่อมต่อ โปรดขอรายการตลาดที่รองรับจากโบรกเกอร์ ใช้รหัสที่ตรงกันกับตัวกรองตลาด REST และคำขอข้อมูลย้อนหลัง ส่วน WebSocket ให้ค้นหา ticker ที่โบรกเกอร์ตั้งค่าไว้ในตลาดนั้นก่อนสมัครรับ ticker คุณใช้ ticker-list เพื่อตรวจดูผลิตภัณฑ์ที่ส่งกลับได้ แต่ผลลัพธ์ว่างเพียงอย่างเดียวไม่ได้ยืนยันว่าไม่รองรับตลาดนั้น