如何接入A股、美股、港股的WebSocket实时行情接口?
摘要:Websocket行情接入 请按照下面的步骤完成沪深、港股或美股的行情接入。 原文地址:https:jvquant.comwiki.html#websocket- 分配服务器 为实现更好的用户体验,系统将自动为您分配合适的服务器。 注
Websocket行情接入
请按照下面的步骤完成沪深、港股或美股的行情接入。
原文地址:https://jvquant.com/wiki.html#websocket-
分配服务器
为实现更好的用户体验,系统将自动为您分配合适的服务器。
注意:每次分配的服务器地址会发生变化,连接服务前,请务必调用该接口获取最新的服务器地址。
分配沪深行情服务器:
http://jvQuant.com/query/server?market=ab&type=websocket&token=<token>
Copy
分配港股行情服务器:
http://jvQuant.com/query/server?market=hk&type=websocket&token=<token>
Copy
分配美股行情服务器:
http://jvQuant.com/query/server?market=us&type=websocket&token=<token>
Copy
接口参数:
#参数名类型描述
1
market
string
市场标志,沪深:ab;港股:hk;美股:us
2
type
string
接口类别,行情类别为websocket
3
token
string
jvQuant token
接口返回:
#参数名类型描述
1
code
string
请求状态码
2
server
string
分配服务器地址及端口号
返回示例:
{
"code": "0",
"server": "<分配的行情服务器地址>"
}
Copy
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>
Copy
订阅行情
连接至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对应的行情,数据字段以","为分隔符。
