极速接入港交所OMD-C 港股L2数据，JAR WebSocket API获取数据

港交所港股L2数据WebSocket快速接入指南：

数据类型：实时行情、BMP、延迟行情、历史数据、成交数据、L2盘口数据、经纪席位。
产品种类：股票数据、涡轮牛熊权证、期权、基金、债券、中华通、
股票挂钩票据、港股通资金流向、发行人信息。
接收方式：Socket、Fix、Restful API、JAR（订阅），RabiitMQ（全盘）
技术交流：QQ244982588
作者：阿龙

RabiitMQ为港交所原始数据经适配层后的原始数据全盘推送到中间件，也可以转发港交所OMD-C SP全部原始数据

入门：
通源数据提供了一个标准化的接口，用于使用WebSocket协议流式传输实时股票数据。用户可以通过动作的形式发送订阅/取消订阅指令，来指定想要接收的股票数据。WebSocket 服务端收到订阅后会向客户端推送订阅成功的状态，并在盘中交易时/有数据流时，向客户端及时推送已订阅的股票数据。

第一步：连接信息

与服务端建立连接，连接建立成功后可向服务端发送订阅，获取相应股票的数据。
只允许1个API密钥连接到WebSocket服务端，如果有另一个客户端尝试连接，当前连接将会被断开。

**连接地址：**
ws://{host}:{port}/Push/{appId}/{appKey}

- 请求说明

1、host：请求地址；
2、port：端口号；
3、appId、appKey：客户端的ID及密钥；

**连接请求成功**
{"code":200,"message":"conncetion success"}

第二步：心跳检测

您必须先发送心跳，来检测您与WebSocket服务端的连接状态，检测成功后才能向服务端提出其他数据请求。
发送心跳包，每次时间间隔最好在30s，服务端默认在60s没有收到心跳将会主动断开您的连接。

**发送心跳**
{"action":"PING"}

第三步：发送订阅

为了获取股票数据，可在与服务端连接成功的情况下，向服务端发送订阅请求。一旦发送订阅成功后，服务端会实时向您推送已订阅的股票数据。

**订阅：“SUBSCRIBE”。**
{"action":"SUBSCRIBE","symbols":"HKEX|1|Q|00001,HKEX|1|T|00001,HKEX|1|O|00001"}

- 请求说明

1、symbols：证券市场｜证券类型｜数据类型｜证券代码
· 证券市场标识：SZSE-深交所市场数据、SSE-上交所市场数据、US-美股市场数据、HKEX-港股市场数据；

· 数据类型标识：Q-行情数据；O-盘口数据；T-逐笔成交；B-港股经纪席位（HKEX独有数据类型）；
· 证券代码标识：具体股票在该市场的代码，例如：美股中的苹果，对应为AAPL；港股中的长和，对应为00001；

2、可同时订阅多个市场数据，用“,”分隔即可，单个市场不需要加“,”；

- 返回参数

{"action":"Q","data":"HKEX|1|1589469440|00001..."}
`证券市场 | 证券类型 | 最新时间 | 证券代码 | 最新价 | 最高价 | 开盘价 | 最低价 | 收盘价 | 成交量 | 成交额 | 加权均价`
{"action":"T","data":"HKEX|1|1589469440|00001..."}
`证券市场 | 证券类型 | 最新时间 | 证券代码 | 成交价 | 成交量 | 方向（B/S/N）`
{"action":"O","data":"HKEX|1|1589469440|00001..."}
`证券市场 | 证券类型 | 最新时间 | 证券代码 | 卖一价 | 卖一数量 | 卖一量 | ... | 买一价 | 买一数量 | 买一量 | ... `

取消订阅

已发送订阅后，如想取消订阅，不接受当前订阅股票的相关数据。只需将“SUBSCRIBE”替换成“DELSUBSCRIBE”即可，其他格式同订阅时的格式；取消订阅后，如需再次订阅股票信息，请重新发送订阅请求，服务端不会保存您的订阅信息。

取消订阅：“DELSUBSCRIBE”
{"action":"DELSUBSCRIBE","symbols":"HKEX|1|Q|00001,HKEX|1|T|00001,HKEX|1|O|00001"}

返回参数

{"msg":"unsubscribe success","code":0,"action":"DELSUBSCRIBE"}

断开连接

1、断开连接后，服务端将会清楚您的所有订阅，不会记录您的订阅信息；
2、导致断开连接的原因：客户端主动断开、未在规定时间内发送心跳、网络连接波动、当前密钥被另一客户端使用；