K线
- 获取单品种K线数据的方法
- 向“
或
/new3_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个指标。 或/new3_k.action?username=用户名&password=md5加密过的密码&id=400009&period=60&num=100&datetime=202407111030&
zb=macd,kdj表示取400009在日期20240711上午10点半之后100根60分钟线，带macd和kdj两个指标
示例：或/new3_k.action?username=用户名&password=md5加密过的密码&id=400009&period=w&num=-20&zb=macd,kdj
表示取400009在当前时间之前20根周线，带macd和kdj两个指标
- 获取多个品种K线数据的方法
-
向“或/new3_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个指标。 或/new3_pluralK.action?username=用户名&password=md5加密过的密码&period=5&id=899001,899050,430017,430047&num=20&zb=kdj,ma5，
表示取899001,899050,430017,430047这4个品种最新的20根5分钟K线数据，带2个指标：kdj,ma5。
分时
- 获取单品种分时数据的方法
-
向“或/new3_fs.action”发送http请求，返回分时数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。参数如下表。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 品种代码， 指数代码请查阅指数列表。 date 日期 否，默认为
最后一个交易日如果日期参数不为空，那么它的格式应为yyyyMMdd，返回结果中的成交量和成交额为累积值。
如果没有date参数或它为空字符串，那么返回最近一个交易日的数据，返回结果中的成交量和成交额不为累积值。zb 指标 否 可选的指标列表，多个指标用“,”分隔，最多5个指标。 只有最新的一个交易日有全指标，过往交易日只有部分市场有分时均价这一个指标，其他市场无。 或/new3_fs.action?username=用户名&password=md5加密过的密码&id=400009，表示取400009在当前的分时行情。
示例：或/new3_fs.action?username=用户名&password=md5加密过的密码&id=400009&date=20240711，
表示取400009在日期20240711的分时行情。
- 获取多个品种实时分时数据的方法
-
向“或/new3_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个指标。 或/new3_newestFs.action?username=用户名&password=md5加密过的密码&id=899001,899050,430017,430047&num=20
表示取899001,899050,430017,430047这4个品种最新的20条分时记录。
分笔tick
- 获取单个品种分笔数据的方法
-
向“或/new3_fb.action”发送http请求，返回该品种的五档(期货为1档)tick数据。在header中加Accept-Encoding:gzip值可让返回值以gzip格式压缩，能让响应速度更快。
数据列为：时间(精确到秒)、价格、成交次数、成交方向、成交量、成交额、买一到买五价和量、卖一到卖五价和量。
有的tick之间时间间隔大于3秒，是因为此时段内没有成交且五档挂单没有变化。参数列表如下。
示例：参数名 参数含义 是否必需 说明 username 用户名 是 password 密码 是 用32位md5加密过的密码。查看加密方法 id 品种代码 是 品种代码， 指数代码请查阅指数列表。 column 列 否 当返回数量量过大时容易超时，此情况可通过多次取单列再组合得到自己需要的数据。只能选1个列。可选列见页面：可选列列表 date 日期 否，默认为
最后一个交易日如果日期参数不为空，那么它的格式应为yyyyMMdd。如果没有date参数或它为空字符串，那么返回最近一个交易日的数据。 或/new3_fb.action?username=用户名&password=md5加密过的密码&id=400009&date=20240711&column=price，
返回400009在日期20240711这天的全部tick，只取price这一列。
结果解析：如果获取到的字节流以“0x1F 0x8B 0x08 0x00 0x00”开头，则它是压缩过的。如果是压缩过的，需将获取到的字节码用gzip解压转成字节数组。
查看python解压gzip的方法 查看c#解压gzip的方法 查看用java获取字节流并解析的示例代码 查看php解压gzip的方法
此字节数组的0～3个字节转化成整型后得到一个时间戳，表示起始时间。之后1个字节的值记为x。x的高4位的值表示解码后价格的单位，3为厘，2为分，x的低4位值表示是否包含挂单，1为包含，0为不包含。之后3个字节转化成整型，值记为p，用于计算成交价格。以后若干个字节为一个tick。
每个tick内部：第0个字节转成整型后，拆成4部分，最高1位记为a，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数据的方法
-
向“或/new3_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。或/new3_newestFb.action?username=用户名&password=md5加密过的密码&id=899001,899050,430017,430047&num=60，
返回899001,899050,430017,430047这4个品种最近60条tick。
获取即时行情数据的方法
向“或/new3_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个列。 |
或/new3_curr.action?username=用户名&password=md5加密过的密码&id=899001,899050,430017,430047”
表示取品种899001,899050,430017,430047的价格
示例：“
或/new3_curr.action?username=用户名&password=md5加密过的密码&id=899001,899050,430017,430047&column=high,mafs”
表示取品种899001,899050,430017,430047的价格，带2个列：最高价、分时均价。
获取增强版即时行情数据的方法
向“或/new3_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”。。 |
| zs | 返回指数 | 否 | 值为0时不返回指数，为1时返回指数。zs参数和id参数不能同时有值。 |
| column | 列 | 否 | 可选的列列表，多个指标用“,”分隔，最多20个列。 |
或/new3_currPlus.action?username=用户名&password=md5加密过的密码&id=899001,899050,430017,430047”
表示取品种899001,899050,430017,430047的价格
示例：“
或/new3_currPlus.action?username=用户名&password=md5加密过的密码&id=899001,899050,430017,430047&column=high,mafs”
表示取品种899001,899050,430017,430047的价格，带2个列：最高价、分时均价。