期货实际合约持仓龙虎榜排名(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-股指期货

数据字典(1126)

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"
}
]
}
}
]
}