Websocket行情接入
请按照下面的步骤完成沪深、港股或美股的行情接入。
原文地址:https://jvquant.com/wiki.html#websocket-
分配服务器
为实现更好的用户体验，系统将自动为您分配合适的服务器。
注意：每次分配的服务器地址会发生变化，连接服务前，请务必调用该接口获取最新的服务器地址。
分配沪深行情服务器:
http://jvQuant.com/query/server?market=ab&type=websocket&token=<token>分配港股行情服务器:
http://jvQuant.com/query/server?market=hk&type=websocket&token=<token>分配美股行情服务器:
http://jvQuant.com/query/server?market=us&type=websocket&token=<token>接口参数:
| # | 参数名 | 类型 | 描述 |
|---|---|---|---|
| 1 | market | string | 市场标志,沪深:ab;港股:hk;美股:us |
| 2 | type | string | 接口类别,行情类别为websocket |
| 3 | token | string | jvQuant token |
接口返回:
| # | 参数名 | 类型 | 描述 |
|---|---|---|---|
| 1 | code | string | 请求状态码 |
| 2 | server | string | 分配服务器地址及端口号 |
返回示例:
{
"code": "0",
"server": "<分配的行情服务器地址>"
}code规范
沪深行情支持共7000只沪深主板、科创板、创业板，股票以及可转债、ETF基金行情，提供level1和level2逐笔成交数据推送。
港股行情支持共5000只香港主板、涡轮牛熊、ETF基金行情，提供level1十档行情和level2逐笔数据推送。
美股行情支持纽约交易所、纳斯达克交易所、美国交易所共12000只产品行情和超6000只ETF基金行情，提供level1快照行情和level2逐笔数据推送。
订阅代码由行情标志和证券代码组成，用分隔符"_"连接。
如:
lv1_600519，代表贵州茅台level1行情
lv1_512170，代表医疗ETF level1行情
lv2_127063，代表贵轮转债level2行情
lv1_00700，代表港股腾讯控股level1行情
lv2_00700，代表港股腾讯控股level2行情
lv1_aapl，代表美股苹果公司快照行情
lv2_aapl，代表美股苹果公司逐笔成交行情
| # | 行情标志 | 类型 | 描述 |
|---|---|---|---|
| 1 | lv1 | string | level1行情 |
| 2 | lv2 | string | level2行情 |
连接登录
获取分配的服务器地址后，通过websokcet协议连接服务器。
连接Websocket行情服务器:
ws://<分配的行情服务器地址>?token=<token>订阅行情
连接至websocket行情服务器，输入以下指令进行行情订阅:
| # | 指令 | 参数 | 描述 |
|---|---|---|---|
| 1 | add | string | 增加订阅code |
| 2 | del | string | 删除订阅code |
| 3 | all | string | 覆盖全部code |
| 4 | list | string | 查看全部订阅code |
| 5 | his | string | (history)查看今日已订阅的code汇总信息 |
指令后接code参数,用分隔符"="连接，多个code用分隔符","分隔。
例:
add=lv1_600519,lv2_127063 ，表示增加订阅lv1_600519,lv2_127063行情。
del=lv1_600519,lv2_127063 ，表示删除订阅lv1_600519,lv2_127063行情。
all=lv1_600519 ，表示覆盖全部订阅code。
all= ，后接参数为空，表示删除全部订阅code。
list ，无需参数，表示查看全部订阅code。
his ，无需参数，查看今日已订阅的code信息。
*美股、港股行情操作指令同上
解析行情
为提高数据传输速率，行情推送采用顺序编码和二进制方式传输，请在接收端解压缩为字符串并解析。
level1(行情快照)
level1行情推送数据以换行符"\n"为分隔，每一行以lv1_xxxxxx=为开头，代表该类别code对应的行情，数据字段以","为分隔符。
沪深level1推送数据包格式如下:
lv1_证券代码1=推送时间 ,证券名称,最新价格,涨幅,成交额,成交量,买五档[挂单数量,挂单价格],卖五档[挂单数量,挂单价格]...lv1_证券代码2=推送时间,证券名称,最新价格,涨幅,成交额,成交量,买五档[挂单数量,挂单价格],卖五档[挂单数量,挂单价格]...
港股level1推送数据包格式如下:
lv1_证券代码1=推送时间 ,证券名称(英),证券名称(中),最新价格,涨幅,成交额,成交量,买十档[挂单数量,挂单价格],卖十档[挂单数量,挂单价格]...lv1_证券代码2=推送时间,证券名称(英),证券名称(中),最新价格,涨幅,成交额,成交量,买十档[挂单数量,挂单价格],卖十档[挂单数量,挂单价格]...
美股快照行情推送数据包格式如下:
lv1_证券代码1=美股代码,最新价格,涨幅,成交额,成交量,行情时间...lv1_证券代码2=美股代码,最新价格,涨幅,成交额,成交量,行情时间...
level2(逐笔明细)
level2行情推送数据以换行符"\n"为分隔，每一行以lv2_xxxxxx=为开头，代表该类别code对应的行情。
同一时刻会存在多笔交易，以"|"为分隔符，数据字段以","为分隔符。
沪深level2推送数据包格式如下:
lv2_证券代码1=成交时间1,成交编号1,成交价格1,成交数量1|成交时间2,成交编号2,成交价格2,成交数量2... lv2_证券代码2=成交时间1,成交编号1,成交价格1,成交数量1|成交时间2,成交编号2,成交价格2,成交数量2...
港股level2推送数据包格式如下:
lv2_证券代码1=成交时间1,成交编号1,成交价格1,成交数量1...|成交时间2,成交编号2,成交价格2,成交数量2... lv2_证券代码2=成交时间1,成交编号1,成交价格1,成交数量1...|成交时间2,成交编号2,成交价格2,成交数量2...
美股逐笔明细推送数据包格式如下:
lv2_证券代码1=成交时间1,时段类别1,成交编号1,成交价格1,成交数量1,成交价格2,成交数量2...|成交时间2,时段类别2,成交编号2,成交价格2,成交数量2... lv2_证券代码1=成交时间1,时段类别1,成交编号1,成交价格1,成交数量1,成交价格2,成交数量2...|成交时间2,时段类别2,成交编号2,成交价格2,成交数量2...
| # | 美股时段标志 | 类别 |
|---|---|---|
| 1 | PRE | 盘前交易 |
| 2 | RTH | 盘中交易 |
| 3 | AFT | 盘后交易 |
行情在线测试
CN沪深实时行情测试 HK港股实时行情测试 US美股实时行情测试