K线
- 获取单品种K线数据的方法
- 向“
或
/hk_k.action”发送http请求，返回K线数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
默认数据列为时间(周期为60分钟以下则精确到分钟，为日以上则精确到日期)、开盘价、最高价、最低价、收盘价、成交量、成交额。参数如下表。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 品种代码， 指数代码请查阅指数列表。 num K线个数 是 绝对值在2～2000之间的整数。如果num是负数，表示取datetime参数之前的num根K线，正数表示取之后的。 datetime 时间 否 当周期为1～60分钟时，时间精确到分钟，格式为yyyyMMddHHmm；当周期为日以上时，时间精确到日，格式为yyyyMMdd。
如果时间参数值为空，表示时间取当前时间，此时num必须为负数period 周期 否，默认为日线 值有9种取法。"1"表示1分钟，"5"表示5分钟，"15"表示15分钟，"30"表示30分钟，"60"表示60分钟，"d"表示日，"w"表示周，"m"表示月，"y"表示年。
1分钟的历史数据保留2个月，5、15、30、60分钟的历史数据只保留10个月，日以上周期保留全部历史数据。fq 复权 否，默认前复权 值有2种取法，无值或"q"表示前复权，"h"表示后复权。 zb 指标 否 可选的指标列表，多个指标用“,”分隔，最多5个指标。 或/hk_k.action?username=用户名&password=md5加密过的密码&id=00001&period=60&num=100&datetime=202407111030&
zb=macd,kdj表示取00001在日期20240711上午10点半之后100根60分钟线，带macd和kdj两个指标
示例：或/hk_k.action?username=用户名&password=md5加密过的密码&id=00001&period=w&num=-20&zb=macd,kdj
表示取00001在当前时间之前20根周线，带macd和kdj两个指标
- 获取多个品种K线数据的方法
-
向“或/hk_pluralK.action”发送http请求，返回多个品种的若干根K线。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
默认数据列：品种代码、时间(周期为60分钟以下则精确到分钟，为日以上则精确到日期)、开盘价、最高价、最低价、收盘价、成交量、成交额。参数如下表。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 2～1000个品种，用“,”隔开。 指数代码请查阅指数列表。
注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。num K线个数 是 绝对值在2～1000之间的整数。如果num是负数，表示取datetime参数之前的num根K线，正数表示取之后的。 注意品种代码个数和num的乘积不能大于2000。 datetime 时间 否 当周期为1～60分钟时，时间精确到分钟，格式为yyyyMMddHHmm；当周期为日以上时，时间精确到日，格式为yyyyMMdd。
如果时间参数值为空，表示时间取当前时间，此时num必须为负数period 周期 否，默认为日线 值有9种取法。"1"表示1分钟，"5"表示5分钟，"15"表示15分钟，"30"表示30分钟，"60"表示60分钟，"d"表示日，"w"表示周，"m"表示月，"y"表示年。
1分钟的历史数据保留2个月，5、15、30、60分钟的历史数据只保留10个月，日以上周期保留全部历史数据。fq 复权 否，默认前复权 值有2种取法，无值或"q"表示前复权，"h"表示后复权。 zb 指标 否 可选的指标列表，多个指标用“,”分隔，最多5个指标。 或/hk_pluralK.action?username=用户名&password=md5加密过的密码&period=5&id=00001,00700,08001,08003&num=20&zb=kdj,ma5，
表示取00001,00700,08001,08003这4个品种最新的20根5分钟K线数据，带2个指标：kdj,ma5。
分时
- 获取单品种分时数据的方法
-
向“或/hk_fs.action”发送http请求，返回分时数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。参数如下表。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 品种代码， 指数代码请查阅指数列表。 date 日期 否，默认为
最后一个交易日如果日期参数不为空，那么它的格式应为yyyyMMdd，返回结果中的成交量和成交额为累积值。
如果没有date参数或它为空字符串，那么返回最近一个交易日的数据，返回结果中的成交量和成交额不为累积值。zb 指标 否 可选的指标列表，多个指标用“,”分隔，最多5个指标。 只有最新的一个交易日有全指标，过往交易日只有部分市场有分时均价这一个指标，其他市场无。 或/hk_fs.action?username=用户名&password=md5加密过的密码&id=00001，表示取00001在当前的分时行情。
示例：或/hk_fs.action?username=用户名&password=md5加密过的密码&id=00001&date=20240711，
表示取00001在日期20240711的分时行情。
- 获取多个品种实时分时数据的方法
-
向“或/hk_newestFs.action”发送http请求，返回多个品种最近的若干条分时行情数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。参数如下表。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 2～1000个品种，用“,”隔开。 指数代码请查阅指数列表。
注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。num 记录数量 是 不超过2000的正整数。注意品种代码个数和num的乘积不能超过2000。 zb 指标 否 可选的指标列表，多个指标用“,”分隔，最多5个指标。 或/hk_newestFs.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003&num=20
表示取00001,00700,08001,08003这4个品种最新的20条分时记录。
分笔tick
- 获取单个品种分笔数据的方法
-
向“或/hk_fb.action”发送http请求，返回该品种的五档(期货为1档)tick数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
数据列为：时间(精确到秒)、价格、成交次数、成交方向、成交量、成交额、买一到买五价和量、卖一到卖五价和量。
有的tick之间时间间隔大于3秒，是因为此时段内没有成交且五档挂单没有变化。参数列表如下。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 品种代码， 指数代码请查阅指数列表。 column 列 否 当返回数量量过大时容易超时，此情况可通过多次取单列再组合得到自己需要的数据。只能选1个列。可选列见页面：可选列列表 date 日期 否，默认为
最后一个交易日如果日期参数不为空，那么它的格式应为yyyyMMdd。如果没有date参数或它为空字符串，那么返回最近一个交易日的数据。 或/hk_fb.action?username=用户名&password=md5加密过的密码&id=00001&date=20240711&column=price，
返回00001在日期20240711这天的全部tick，只取price这一列。
结果解析：如果获取到的字节流以“0x1F 0x8B 0x08 0x00 0x00”开头，则它是压缩过的。如果是压缩过的，需将获取到的字节码用gzip解压转成字节数组。
查看python解压gzip的方法 查看c#解压gzip的方法 查看用java获取字节流并解析的示例代码 查看php解压gzip的方法
此字节数组的0～3个字节转化成整型后得到一个时间戳，表示起始时间。1之后的4个字节转化成整型，值记为t，表示初始时间戳。之后的1个字节的值表示小数位，0x2表示价格为2位小数，0x3表示3位小数。再往后3个字节转化为整型表示第1个tick的价格，值记为p。注意p是整型，要除以(10^小数位)得到真正的价格。p值用于之后计算成交价格。以后若干个字节为一个tick。
每个tick内部：前3个字节分别记为f1、f2、f3，f1的高1位+1的值表示此tick的时间戳和t的值的差所占字节数，记为a。f3之后a个字节转化为整型加上t得到此tick的时间戳，同时t的值更新为此tick的时间戳。f1的次高1位 a的值在计算时间戳时用到。次高2位记为f，表示本tick相对于上一个tick的价格变动值所占字节数。
次低2位记为c，表示成交方向。当c=0时表示方向为无方向，c=1时表示买，c=0b11表示卖。低3位用于计算成交量，它的值记为v1。
第2个字节转成整型后拆成4部分：高2位用于计算成交量，记为v2，次高2位用于计算成交笔数，记为c，次高2位用于计算成交额，记为e1，次高1位表示成交额的单位，0b0表示单位为元，0b1为角。最低1位的值记为m，m+1表示挂单的价格变动所占字节数。
第3个字节拆成4部分：高2位的值记为g1，用于计算买10档的挂单量，次高2位的值记为g2，也用于计算买挂单量。次低2位的值记为g3，用于计算卖10档的挂单量，低2位的值记为g4，也用于计算卖挂单量。 再之后的(a+1)个字节转化为整型后加上t表示当前tick的时间戳。加完后更新t。
再之后f个字节转成byte型(f值为0)或short型(f值为1)或int型(f值为3)后，加上p值得到本tick的价格。然后将p值更新为本tick的价格。如果f值为0，则价格相对上一个tick的价格无变化。
再之后v1个字节转化为整型后再乘以10的v2次幂得到成交量。如果v1的值为0，那么成交量也为0。
如果c值为0，那么此tick的成交笔数和成交额都为0。如果c值大于0，那么接下来的c个字节转化为整型后得到成交笔数。再接下来(e1+1)个字节转化成整型后得到成交额，记得结合成交额的单位统一转化为元、角或者分。
再之后取(m+1)个字节转成byte型(m值为0)或short型(m值为1)后（此值可能为负）与p值相加，得到买一价格。再之后(v1+1)个字节转化为整型后(记为买挂单参数)乘以10的v2次幂得到买一挂单量。
再之后取(m+1)个字节转成byte型(m值为0)或short型(m值为1)后（此值可能为负）与买一价格相加，得到买二价格。再之后(v1+1)个字节转化为整型后(记为买挂单参数)乘以10的v2次幂得到买二挂单量。以此规律循环直到买5档。
买5档的特殊情况1：集合竞价时，买n(n>1)档会出现有量而无价。此时买n的价格偏移量为无效值(最大byte值即0x81或最大short值即0x8001)。
买10档的特殊情况2：当集合竞价时或当价格在跌停板或接近跌停板时，会出现只有0～9个买挂单。所以当循环计算买挂单时，遇到价格偏移量为无效值(最大byte值即0x81或最大short值即0x8100)且买挂单参数为0，表示买挂单部分结束了，之后的内容表示进入卖挂单部分。
卖挂单计算原理与买挂单相同，只是v1、v2换成v3、v4。价格偏移量的无效值是最小byte值即0x80或最小short值即0x8000。当卖挂单遇到空档结束后，或10个卖挂单结束后，进入下一个tick单元。
- 获取多个品种实时tick数据的方法
-
向“或/hk_newestFb.action”发送http请求，返回多个品种最近若干个tick数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
文本格式，数据列为：时间(精确到秒)、价格、成交次数、成交方向、成交量、成交额、买一到买五价和量、卖一到卖五价和量。参数如下表。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 1～800个品种代码，用“,”隔开。
注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。gd 是否带挂单 否 默认为0，表示带挂单。-1表示不带挂单。 num 记录数量 是 最低值为2，当有挂单时，取值范围为不超过800的正整数，品种代码个数和num的乘积不能超过800。
当无挂单时，取值范围为不超过4000的正整数，品种代码个数和num的乘积不能超过4000。或/hk_newestFb.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003&num=60，
返回00001,00700,08001,08003这4个品种最近60条tick。
获取10档挂单数据的方法
向“或/hk_currFb.action”发送http请求，返回纯文本格式的10档挂单数据。
| 参数名 | 参数含义 | 是否必需 | 说明 |
| username | 用户名 | 是 | |
| password | 密码 | 是 | 用32位md5加密过的密码。查看加密方法 |
| id | 品种代码 | 否 | 1～100个品种，之间用“,”隔开。 注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。 |
或/hk_currFb.action?username=用户名&password=md5加密过的密码&id=
获取即时行情数据的方法
向“或/hk_curr.action”发送http请求，返回的数据列默认为品种代码、价格。在header中加 Accept-Encoding:gzip可让返回值以gzip格式压缩，能让响应速度更快。如果需要其他列，将列加在在column参数里。
| 参数名 | 参数含义 | 是否必需 | 说明 |
| username | 用户名 | 是 | |
| password | 密码 | 是 | 用32位md5加密过的密码。查看加密方法 |
| id | 品种代码 | 否 | 1～1000个品种，之间用“,”隔开。 注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。 |
| column | 列 | 否 | 可选的列列表，多个指标用“,”分隔，最多8个列。 |
或/hk_curr.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003”
表示取品种00001,00700,08001,08003的价格
示例：“
或/hk_curr.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003&column=high,mafs”
表示取品种00001,00700,08001,08003的价格，带2个列：最高价、分时均价。
获取增强版即时行情数据的方法
向“或/hk_currPlus.action”发送http请求，返回当前的行情。在header中加 Accept-Encoding:gzip可让返回值以gzip格式压缩，能让响应速度更快。
| 参数名 | 参数含义 | 是否必需 | 说明 |
| username | 用户名 | 是 | |
| password | 密码 | 是 | 用32位md5加密过的密码。查看加密方法 |
| id | 品种代码 | 否 | 1～1000个品种，之间用“,”隔开。指数代码请查阅指数列表。
注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。。 当id参数有值时，jys参数和zs参数不能有值。当id参数和jys参数同时无值时返回全部个股。 |
| jys | 交易所 | 否 | 值有2种取法：“zb”表示返回所有主板港股，“cyb”表示返回所有创业板个股，只传jys参数不传id参数时返回该交易所全部个股。 |
| zs | 返回指数 | 否 | 值为0时不返回指数，为1时返回指数。zs参数和id参数不能同时有值。 |
| column | 列 | 否 | 可选的列列表，多个指标用“,”分隔，最多20个列。 |
或/hk_currPlus.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003”
表示取品种00001,00700,08001,08003的价格
示例：“
或/hk_currPlus.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003&column=high,mafs”
表示取品种00001,00700,08001,08003的价格，带2个列：最高价、分时均价。
获取排行数据的方法
向“或/hk_rank.action”发送http请求，返回的数据列默认为股票代码、涨幅、价格等。在header中加 Accept-Encoding:gzip可让返回值以gzip格式压缩，能让响应速度更快。| 参数名 | 参数含义 | 是否必需 | 说明 |
| username | 用户名 | 是 | |
| password | 密码 | 是 | 用32位md5加密过的密码。查看加密方法 |
| jys | 交易所 | 否 | 值有3种取法：“zb”表示返回所有主板港股，“cyb”表示返回所有创业板港股，和id参数同时为空时返回全部个股。jys参数和id参数不能同时有值。 |
| id | 品种代码 | 否 | 2～1000个品种，之间用“,”隔开。
注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。 |
| type | 排序依据 | 否，默认按涨幅排降序 | type值有6种取法：zf表示涨幅，jg表示价格，lb表示量比，e表示成交额，hsl表示换手率，zs表示涨速。 |
| order | 排序方式 | 否，默认按倒序排 | 值有两种取法，asc为顺序，desc为倒序 |
| num | 数量 | 否 | 如果无值，表示返回全部个股，如果有值，取值范围为2～1000 |
| column | 列 | 否 | 可选的列列表，多个指标用“,”分隔，最多8个列。 |
或/hk_rank.action?username=用户名&password=md5加密过的密码&id=00001,00700,08001,08003&type=jg&order=desc”
表示将个股00001,00700,08001,08003以价格倒序排序
示例：“
或/hk_rank.action?username=用户名&password=md5加密过的密码&type=e&order=asc”取整个市场按成交额排升序