港股行情数据接口使用说明

• 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～200个品种，之间用“,”隔开。 注意：当品种个数超过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”取整个市场按成交额排升序