注册 登录

获取行情服务器

每次业务操作前,请查询并获取服务器地址,系统会自动分配。注意,每次的地址可能不同,故每次连接前需重新查询。
请求模板https://api.level2.top/api/server/query?market=&token=<您的API token>
marketSZ or SH , 请选择距离您最近的交易所,上海==SH,深圳==SZ
token您的账户API token
请求示例https://api.level2.top/api/server/query?market=SZ&token=<您的API token>

连接行情服务器

您需通过WebSocket协议连接到该服务器。登录地址模板如下:
ws://<行情服务器地址>?token=<账户token>

行情订阅指令

在成功连接行情服务器后,您可以使用以下指令与服务器进行交互,以管理和查看行情订阅信息:
add:新增需要订阅的代码。
del:取消对某个代码的订阅。
all:订阅所有可用的行情代码。
list:查询当前已订阅的行情信息。
history:查看当天已订阅的历史记录。

标志与服务类型

lv1代表基础行情
lv2代表level2行情
lv10代表十档盘口行情

订阅行情说明

订阅代码由行情标志和证券代码组成,使用下划线“_”连接。例如:
lv1_000001:表示订阅代码为000001的股票基础行情。
lv2_600519:表示订阅代码为600519的股票逐笔成交数据。
lv10_601318:表示订阅代码为601318的股票十档盘口数据。

订阅代码说明

在成功连接至WebSocket行情服务器后,您可以通过以下指令进行行情订阅:
add=lv1_600519,lv2_127063:增加订阅代码为600519的股票基础行情和代码为127063的股票逐笔成交数据。
del=lv1_600519,lv2_127063:删除订阅代码为600519的股票基础行情和代码为127063的股票逐笔成交数据。
all=lv1_600519将全部订阅代码设置为仅包含代码为600519的股票基础行情。
all=清空全部订阅。
list:无需参数,直接查看当前连接已订阅的行情信息。
history:无需参数,直接查看账号今日已订阅的行情信息。

接收信息解析

为提高数据传输效率,WebSocket行情采用顺序编码进行二进制压缩后传输。接收端需对接收到的数据进行解压缩并解析。

基础行情解析

解压缩后的行情推送数据以换行符\n作为分隔符。每一行数据以行情标志_证券代码为开头,沪深基础行情推送数据包的格式如下:
lv1_证券代码1=推送时间,证券名称,最新价格,涨幅,成交额,成交量,买五档[挂单数量,挂单价格],卖五档[挂单数量,挂单价格]...
lv1_证券代码2=推送时间,证券名称,最新价格,涨幅,成交额,成交量,买五档[挂单数量,挂单价格],卖五档[挂单数量,挂单价格]...
...
行情标志:表示行情类型,lv1代表基础行情。
证券代码:证券的唯一标识。
推送时间:行情推送的时间。
证券名称:证券的名称。
最新价格:证券的最新交易价格。
涨幅:证券价格的涨幅百分比。
成交额:证券的累计成交金额。
成交量:证券的累计成交数量。
买五/卖五:分别表示前五档的买单和卖单信息,每档包括挂单数量和挂单价格。

逐笔成交解析

同一数据包中可能包含多笔交易记录,以|作为分隔符,数据字段之间以,分隔。沪深逐笔成交推送数据包的格式如下:
lv2_证券代码1=成交时间1,成交编号1,成交价格1,成交数量1|成交时间2,成交编号2,成交价格2,成交数量2...
lv2_证券代码2=成交时间1,成交编号1,成交价格1,成交数量1|成交时间2,成交编号2,成交价格2,成交数量2...
...
行情标志:lv2代表逐笔成交行情。
证券代码:证券的唯一标识。
成交时间:逐笔成交的时间。
成交编号:逐笔成交的唯一标识。
成交价格:逐笔成交的价格。
成交数量:逐笔成交的数量。

十档盘口解析

沪深十档盘口推送数据包的格式与基础行情类似,但提供了更详细的买卖盘口信息:
lv10_证券代码1=推送时间,证券名称,最新价格,昨收,成交额,成交量,买十档[挂单数量,.....挂单价格,...],卖十档[挂单数量,.....挂单价格,...]
lv10_证券代码2=推送时间,证券名称,最新价格,昨收,成交额,成交量,买十档[挂单数量,.....挂单价格,...],卖十档[挂单数量,.....挂单价格,...]
...
行情标志:lv10代表十档盘口行情。
证券代码:证券的唯一标识。
推送时间:行情推送的时间。
证券名称:证券的名称。
最新价格:证券的最新交易价格。
昨收:证券的昨日收盘价。
成交额:证券的累计成交金额。
成交量:证券的累计成交数量。
买十/卖十:分别表示前十档的买单和卖单信息,每档包括挂单数量和挂单价格。