訂閱行情推送
客戶端可以通過 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 定義
訂閱成功後,服務端會推送相應的標的行情到客戶端,具體的數據可以查看行情概覽
其他接口
行情的數據拉去都是通過長連接網關的,具體可以查看行情概覽
協議
想要訂閱行情,必須先了解我們的協議,我們使用的長連接協議