✅NOTE

我们的 OpenAPI SDK 已经完整实现了订阅行情的功能，你可以直接使用 SDK。

https://open.longportapp.com/sdk

本章节文档提供给大家参考 API 细节。

客户端可以通过 WebSocket 或者 TCP 和行情网关建立长连接，客户端订阅股票行情，行情网关会实时推送客户端订阅的实时行情。

ℹ️Info

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

TCP Endpoint: openapi-quote.longportapp.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 定义

订阅成功后，服务端会推送相应的标的行情到客户端，具体的数据可以查看行情概览

其他接口

行情的数据拉去都是通过长连接网关的，具体可以查看行情概览

协议

想要订阅行情，必须先了解我们的协议，我们使用的长连接协议