Longbridge Developers
立即開始

訂閱行情推送

NOTE

我們的 OpenAPI SDK 已經完整實現了訂閱行情的功能,你可以直接使用 SDK。

https://open.longbridge.com/sdk

本章節文檔提供給大家參考 API 細節。

客戶端可以通過 WebSocket 或者 TCP 和行情網關建立長連接,客戶端訂閱股票行情,行情網關會實時推送客戶端訂閱的實時行情。

Info

WebSocket Endpoint: wss://openapi-quote.longbridge.com

TCP Endpoint: openapi-quote.longbridge.com:2020

流程如下:

sequenceDiagram
autonumber
Client ->> Server: 握手
Server -->> Client: 鏈接建立
Client -->> Server: 登錄鑑權
Server -->> Client: 返回登錄鑑權結果

par 訂閱行情
Client -->> Server: 訂閱行情請求,req_id: 10, cmd: 6
Server -->> Client: 返回訂閱行情響應,req_id: 10, cmd: 6

Server -->> Client: 實時價格推送,cmd: 101
Server -->> Client: 實時盤口推送,cmd: 102
Server -->> Client: 實時經紀隊列推送,cmd: 103
Server -->> Client: 實時成交明細推送,cmd: 104

end

訂閱

客戶端在和服務端建立連接後需要通過訂閱行情的指令訂閱不同類型的行情。

訂閱的 Protobuf 定義可以查看

Example:

{
  "symbol": ["700.HK", "AAPL.US"]
  "sub_type": [1, 2]
  "is_first_push": true
}

這裏方便展示使用 JSON,實際上需要通過 protobuf 序列化請求到服務端

客戶端也可以通過獲取已訂閱接口查看自己已經訂閱的標的行情,Protobuf 定義

訂閱成功後,服務端會推送相應的標的行情到客戶端,具體的數據可以查看行情概覽

其他接口

行情的數據拉去都是通過長連接網關的,具體可以查看行情概覽

協議

想要訂閱行情,必須先了解我們的協議,我們使用的長連接協議