香港期货行情数据接口使用说明

• K线

  获取单品种K线数据的方法

  向“或/hkFutures_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个月，日以上周期保留全部历史数据。
  zb	指标	否	可选的指标列表，多个指标用“,”分隔，最多5个指标。

  示例：或/hkFutures_k.action?username=用户名&password=md5加密过的密码&id=HSI999&period=60&num=100&datetime=202407111030&zb=macd,kdj表示取HSI999在日期20240711上午10点半之后100根60分钟线，带macd和kdj两个指标
  示例：或/hkFutures_k.action?username=用户名&password=md5加密过的密码&id=HSI999&period=w&num=-20&zb=macd,kdj 表示取HSI999在当前时间之前20根周线，带macd和kdj两个指标

  获取多个品种K线数据的方法

  向“或/hkFutures_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个月，日以上周期保留全部历史数据。
  zb	指标	否	可选的指标列表，多个指标用“,”分隔，最多5个指标。

  示例：或/hkFutures_pluralK.action?username=用户名&password=md5加密过的密码&period=5&id=HSI999,CHH999,HTI999&num=20&zb=kdj,ma5，
  表示取HSI999,CHH999,HTI999这4个品种最新的20根5分钟K线数据，带2个指标：kdj,ma5。

• 分时

  获取单品种分时数据的方法

  向“或/hkFutures_fs.action”发送http请求，返回分时数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。参数如下表。

  参数名	参数含义	是否必需	说明
  username	用户名	是
  password	密码	是	用32位md5加密过的密码。查看加密方法
  id	品种代码	是	品种代码， 品种代码请查阅香港期货品种代码列表。
  date	日期	否，默认为 最后一个交易日	如果日期参数不为空，那么它的格式应为yyyyMMdd，返回结果中的成交量和成交额为累积值。 如果没有date参数或它为空字符串，那么返回最近一个交易日的数据，返回结果中的成交量和成交额不为累积值。
  zb	指标	否	可选的指标列表，多个指标用“,”分隔，最多5个指标。 只有最新的一个交易日有全指标，过往交易日只有部分市场有分时均价这一个指标，其他市场无。

  示例：或/hkFutures_fs.action?username=用户名&password=md5加密过的密码&id=HSI999，表示取HSI999在当前的分时行情。
  示例：或/hkFutures_fs.action?username=用户名&password=md5加密过的密码&id=HSI999&date=20240711， 表示取HSI999在日期20240711的分时行情。

  获取多个品种实时分时数据的方法

  向“或/hkFutures_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个指标。

  示例：或/hkFutures_newestFs.action?username=用户名&password=md5加密过的密码&id=HSI999,CHH999,HTI999&num=20
  表示取HSI999,CHH999,HTI999这4个品种最新的20条分时记录。

• 分笔tick

  获取单个品种分笔数据的方法

  向“或/hkFutures_fb.action”发送http请求，返回该品种的五档(期货为1档)tick数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
  数据列为：时间(精确到秒)、价格、成交次数、成交方向、成交量、买一价和量，卖一价和量。
  有的tick之间时间间隔大于3秒，是因为此时段内没有成交且五档挂单没有变化。参数列表如下。

  参数名	参数含义	是否必需	说明
  username	用户名	是
  password	密码	是	用32位md5加密过的密码。查看加密方法
  id	品种代码	是	品种代码， 品种代码请查阅香港期货品种代码列表。
  column	列	否	当返回数量量过大时容易超时，此情况可通过多次取单列再组合得到自己需要的数据。只能选1个列。可选列见页面：可选列列表
  date	日期	否，默认为 最后一个交易日	如果日期参数不为空，那么它的格式应为yyyyMMdd。如果没有date参数或它为空字符串，那么返回最近一个交易日的数据。

  示例：或/hkFutures_fb.action?username=用户名&password=md5加密过的密码&id=HSI999&date=20240711&column=price，
  返回HSI999在日期20240711这天的全部tick，只取price这一列。

  获取多个品种实时tick数据的方法

  向“或/hkFutures_newestFb.action”发送http请求，返回多个品种最近若干个tick数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
  文本格式，数据列为：时间(精确到秒)、价格、成交次数、成交方向、成交量、买一价和量，卖一价和量。参数如下表。

  参数名	参数含义	是否必需	说明
  username	用户名	是
  password	密码	是	用32位md5加密过的密码。查看加密方法
  id	品种代码	是	1～2000个品种代码，用“,”隔开。 详情请查阅香港期货品种列表 注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。
  gd	是否带挂单	否	默认为0，表示带挂单。-1表示不带挂单。
  num	记录数量	是	最低值为2，当有挂单时，取值范围为不超过2000的正整数，品种代码个数和num的乘积不能超过2000。 当无挂单时，取值范围为不超过4000的正整数，品种代码个数和num的乘积不能超过4000。

  示例：或/hkFutures_newestFb.action?username=用户名&password=md5加密过的密码&id=HSI999,CHH999,HTI999&num=60，
  返回HSI999,CHH999,HTI999这4个品种最近60条tick。

• 获取5档挂单数据的方法

  向“或/hkFutures_currFb.action”发送http请求，返回纯文本格式的5档挂单数据。

  参数名	参数含义	是否必需	说明
  username	用户名	是
  password	密码	是	用32位md5加密过的密码。查看加密方法
  id	品种代码	否	1～200个品种，之间用“,”隔开。 注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。

  示例：或/hkFutures_currFb.action?username=用户名&password=md5加密过的密码&id=list.action?type=xgqh&small=0

• 获取即时行情数据的方法

  向“或/hkFutures_curr.action”发送http请求，返回的数据列默认为品种代码、价格。在header中加 Accept-Encoding:gzip可让返回值以gzip格式压缩，能让响应速度更快。
  如果需要其他列，将列加在在column参数里。

  参数名	参数含义	是否必需	说明
  username	用户名	是
  password	密码	是	用32位md5加密过的密码。查看加密方法
  id	品种代码	是	2～1000个品种，之间用“,”隔开。 品种代码查阅香港期货品种列表。 注意：当品种个数超过120个时，需用post方式发送http请求。用post方式请求时header中必须包含“Content-Type:application/x-www-form-urlencoded”。
  column	列	否	可选的列列表，多个指标用“,”分隔，最多8个列。

  示例：“或/hkFutures_curr.action?username=用户名&password=md5加密过的密码&id=HSI999,CHH999,HTI999”
  表示取品种HSI999,CHH999,HTI999的价格
  示例：“或/hkFutures_curr.action?username=用户名&password=md5加密过的密码&id=HSI999,CHH999,HTI999&column=high,mafs”
  表示取品种HSI999,CHH999,HTI999的价格，带2个列：最高价、分时均价。

• 获取增强版即时行情数据的方法

  向“或/hkFutures_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参数值时，返回全部品种。
  column	列	否	可选的列列表，多个指标用“,”分隔，最多20个列。

  示例：“或/hkFutures_currPlus.action?username=用户名&password=md5加密过的密码&id=HSI999,CHH999,HTI999”
  表示取品种HSI999,CHH999,HTI999的价格
  示例：“或/hkFutures_currPlus.action?username=用户名&password=md5加密过的密码&id=HSI999,CHH999,HTI999&column=high,mafs”
  表示取品种HSI999,CHH999,HTI999的价格，带2个列：最高价、分时均价。