期货实际合约持仓龙虎榜排名(fut_holding_heroes) 在线调试
提供正在交易的期货合约龙虎榜详情,统计期货会员排名的持仓信息,包含多空增减值,指标数量,其中合约代码contract_code取自期货合约详情接口fut_contract
网关地址
沙箱环境调用地址: | https://sandbox.hscloud.cn |
数据核查类生产调用地址: | https://api.hscloud.cn |
仿真业务接口生产调用地址: | https://vopen.hscloud.cn |
其余生产调用地址: | https://open.hscloud.cn |
URL
https://sandbox.hscloud.cn/info/v3/fut_holding_heroes |
---|
是否需要业务登录
否 |
---|
HTTP请求方式
GET |
---|
请求参数
参数名 | 类型 | 必填 | 最大长度 | 默认值 | 中文名 | 描述 |
---|---|---|---|---|---|---|
contract_code | String | 否 | 30 | 合约代码 |
在fut_contract列表中返回的合约代码字段,如IF1609
|
|
indicator_code | String | 否 | 1 | 统计类型 |
1-成交量统计,3-持买仓量统计,4-持卖仓量统计若不送默认查询全部
|
|
contract_type | String | 否 | 1 | 合同代码类别 | ||
rank_num | String | 否 | 1 | 10 | 自定义活跃营业部关联股票个数 |
若不送默认为取前10会员排名,自定义可输入任意数字排名
|
page_no | Integer | 否 | 10 | 1 | 页面编号 |
若不送,默认为1
|
page_count | Integer | 否 | 8 | 10 | 页内记录数 |
若不送,默认为10,最大一次查询200条
|
date_type | String | 否 | 1 | 1 | 日期类型 |
日期类型可设定start_date开始和end_date结束日期的值,若用户输入了开始日期start_date和结束日期end_date,此日期类型date_type字段输入任何值无效。 date_type=1表示获取最近一个有数据的交易日, date_type=2表示获取近一个月, date_type=3表示获取近三个月, date_type=4表示获取近半年, date_type=5表示查询近1年,如果不送date_type默认值为1
|
start_date | String | 否 | 开始日期 |
格式"2015-12-12"或者"20151212" 查询开始日期,如果开始日期输入,截止日期不送,默认截止日为当日,并且限定最多只能支持1年范围内的查询
|
||
end_date | String | 否 | 截止日期 |
格式"2015-12-12"或者"20151212" 查询截止日期,如果开始日期不送,截止日期送,默认开始日期为1年前,并且限定最多只能支持1年范围内的查询
|
||
fields | String | 否 | 200 | 输出字段集合 |
支持多参数,各个参数之间以逗号相隔,如有重复,重复参数将被去除 说明:该输入字段可以指定输出字段 不送默认输出全部字段,特别提示:接口最多只能支持过滤到第二级对象的字段
|
返回参数
参数名 | 类型 | 最大长度 | 默认值 | 中文名 | 描述 |
---|---|---|---|---|---|
contract_code | String | 30 | 合约代码 |
合约代码
|
|
trade_date | Integer | 8 | 交易日期 |
交易日期
|
|
contract_type | String | 1 | 合同代码类别 |
合约类型 1-商品期货 2-货币期货 3-利率期货 4-股指期货
|
|
rank_number | String | 10 | 排名名次 |
排名名次
|
|
member_abbr | String | 200 | 会员简称 |
会员简称
|
|
indicator_vol | Integer | 10 | 指标数量 |
指标数量(单位:手),当统计类型为1时,字段表示'成交量';取值对象为volume_heroes_obj 当统计类型为3时,字段表示‘多头持仓量’取值对象为long_position_heroes_obj 当统计类型为4时,字段表示‘空头持仓量’取值对象为short_holding_obj
|
|
change_vol | Integer | 10 | 增减数量 |
增减数量(单位:手),当统计类型为1时,字段表示'成交量'增减数量;当统计类型为3时,字段表示‘多头持仓量’增减数量当统计类型为4时,字段表示‘空头持仓量’增减数量
|
|
total_vol | Integer | 10 | 本日合计 |
本日合计(单位:手),指标数量的rank_num总和
|
|
total_change_vol | Integer | 10 | 总增减量 |
总增减量(单位:手),增减数量的rank_num总和
|
请求示例
/info/v3/fut_holding_heroes?contract_code=AL1701
正确返回示例
{ data: [ { contract_code: "AL1701", contract_type: "1", long_position_heroes_obj: { long_position_hero_obj: [ { change_vol: 547, indicator_vol: 5701, member_abbr: "中信期货", rank_number: "1" }, { change_vol: 373, indicator_vol: 5331, member_abbr: "永安期货", rank_number: "2" }, { change_vol: -139, indicator_vol: 3697, member_abbr: "华泰期货", rank_number: "3" }, { change_vol: -120, indicator_vol: 3570, member_abbr: "国泰君安", rank_number: "4" }, { change_vol: 1087, indicator_vol: 3331, member_abbr: "五矿经易", rank_number: "5" }, { change_vol: -1959, indicator_vol: 2314, member_abbr: "方正中期", rank_number: "6" }, { change_vol: -7, indicator_vol: 2223, member_abbr: "中钢期货", rank_number: "7" }, { change_vol: -940, indicator_vol: 2221, member_abbr: "倍特期货", rank_number: "8" }, { change_vol: -70, indicator_vol: 2183, member_abbr: "国信期货", rank_number: "9" }, { change_vol: -339, indicator_vol: 1865, member_abbr: "海通期货", rank_number: "10" } ], total_change_vol: 71953, total_vol: 153830 }, short_position_heroes_obj: { short_position_hero_obj: [ { change_vol: 173, indicator_vol: 7083, member_abbr: "先融期货", rank_number: "1" }, { change_vol: 940, indicator_vol: 5596, member_abbr: "银河期货", rank_number: "2" }, { change_vol: 76, indicator_vol: 4590, member_abbr: "中国国际", rank_number: "3" }, { change_vol: -425, indicator_vol: 4222, member_abbr: "中信期货", rank_number: "4" }, { change_vol: 79, indicator_vol: 3681, member_abbr: "国信期货", rank_number: "5" }, { change_vol: -1659, indicator_vol: 3447, member_abbr: "华信万达", rank_number: "6" }, { change_vol: -16, indicator_vol: 3388, member_abbr: "光大期货", rank_number: "7" }, { change_vol: -1345, indicator_vol: 2332, member_abbr: "中粮期货", rank_number: "8" }, { change_vol: 74, indicator_vol: 2235, member_abbr: "迈科期货", rank_number: "9" }, { change_vol: -555, indicator_vol: 2070, member_abbr: "国投安信", rank_number: "10" } ], total_change_vol: 69295, total_vol: 192474 }, trade_date: "2016-10-26", volume_heroes_obj: { total_change_vol: 73520, total_vol: 121394, volume_hero_obj: [ { change_vol: 17112, indicator_vol: 27855, member_abbr: "海通期货", rank_number: "1" }, { change_vol: 14096, indicator_vol: 21976, member_abbr: "中信期货", rank_number: "2" }, { change_vol: 10877, indicator_vol: 17438, member_abbr: "中融汇信", rank_number: "3" }, { change_vol: 6610, indicator_vol: 10772, member_abbr: "东证期货", rank_number: "4" }, { change_vol: 4378, indicator_vol: 8205, member_abbr: "中辉期货", rank_number: "5" }, { change_vol: 5361, indicator_vol: 8199, member_abbr: "华安期货", rank_number: "6" }, { change_vol: 5708, indicator_vol: 7566, member_abbr: "五矿经易", rank_number: "7" }, { change_vol: 4781, indicator_vol: 6846, member_abbr: "广发期货", rank_number: "8" }, { change_vol: 1829, indicator_vol: 6534, member_abbr: "银河期货", rank_number: "9" }, { change_vol: 2768, indicator_vol: 6003, member_abbr: "方正中期", rank_number: "10" } ] } } ] }