板块成份股排序(block/sort) 在线调试

板块成份股排序

网关地址

沙箱环境调用地址: https://sandbox.hscloud.cn
数据核查类生产调用地址: https://api.hscloud.cn
仿真业务接口生产调用地址: https://vopen.hscloud.cn
其余生产调用地址: https://open.hscloud.cn

URL

https://sandbox.hscloud.cn/quote/v1/block/sort

是否需要业务登录

HTTP请求方式

GET

请求参数

参数名 类型 必填 最大长度 默认值 中文名 描述
prod_code String 32 产品代码
有且仅能有1个代码代码包含交易所代码做后缀,作为该代码的唯一标识。如:DY1152.XBHS(沪深板块中的甘肃板块)
sort_field_name String 100 排序字段名称
按照该字段进行排序,请参考行情列字段,在列表中选择一个
sort_type String 1 0 排序方式
0:表示升序; 1:表示降序(默认)
fields String 255 字段集合
不输表示返回所有支持的字段即出现在应答里的行情字段,字段请参考行情列字段,在列表中选择一个或多个(使用逗号分割)
start_pos Integer 10 0 起始位置
默认表示从位置 0 开始
data_count Integer 10 数据个数
取值范围[1, 10000] 如果不输入该字段,则默认返回100个;如果输入值大于10000,则按实际数最多返回10000个,小于1的值或其它非数值按默认值处理
special_marker String 特殊标志
mark_type String 1 0 标记类型
0:符合所有的特殊标记 1:只需要符合特殊标记的其中一个 2:对特殊标记取反

数据字典(24)

返回参数

参数名 类型 最大长度 默认值 中文名 描述
sort Object 排序对象

请求示例

/quote/v1/block/sort?prod_code=051000.XBHK&sort_field_name=px_change_rate&fields=px_change_rate,last_px

正确返回示例

{"data":{"sort":{"fields":["last_px","px_change_rate"],"08028.HKG":[0.077,4.05],"00663.HKM":[0.154,2.67],"03788.HKM":[1.09,1.87],"00815.HKM":[1.62,0.62],"01818.HKM":[6.04,0.5],"00246.HKM":[8.81,0],"00335.HKM":[1.08,0],"00621.HKM":[0.042,0],"01194.HKM":[0.021,0],"03330.HKM":[1.75,0],"08162.HKG":[0.4,0],"08299.HKG":[0.014,0],"02303.HKM":[9.93,-0.6],"02899.HKM":[3.52,-0.85],"02099.HKM":[16.4,-0.97],"00274.HKM":[0.02,-4.76]}}}

关于排序接口special_marker的使用说明:
入参:可以根据数据字典将多个字符串枚举值按逗号分隔作为入参 或者 将多个数值枚举值按位或作为入参
出参:special_marker的出参一定是10进制数据,使用时需要根据如下所列的特殊标记含义按位与判断是否符合特定的特殊标记
数值型special_marker枚举值列举如下:
0x01             退市警示标的
0x02             风险警示标的
0x04             融资标的
0x08             融券标的
0x10             沪股通标的(可买可卖)
0x20             港股通标的(可买可卖)
0x40             沪股通标的(只可卖)
0x80             港股通标的(只可卖)
0x100            H股标的
0x200            B股标的
0x400            A股标的
0x800            港股-认购, 复用于沪深定向可转债
0x1000           港股-认沽, 复用于科创板可转债
0x2000           港股-牛证
0x4000           港股-熊证
0x100000         港股通标的(可买可卖
0x200000         港股通标的(只可卖)
0x400000         港股通零股(可买可卖)
0x800000         港股通零股(只可卖)
0x1000000        深股通标的(可买可卖)
0x2000000        深股通标的(只可卖)
0x4000000        未发行
0x8000000        当日申购
0x10000000       已发行-未上市
0x20000000       包括公众投资者、合格投资者在内的所有投资者都可以认购和交易
0x40000000       仅合格投资者可以认购和交易
0x80000000       仅合格投资者中的机构投资者可以认购和交易
0x100000000ULL   期货主力合约标记 //深圳市场借用此标记表示:是否涨跌幅限制为20% 的基金代码
0x200000000ULL   期货夜盘合约标记
0x400000000ULL   板块市场父板块标记
0x800000000ULL   正常涨停标记
0x1000000000ULL  正常跌停标记
0x2000000000ULL  触板涨停标记
0x4000000000ULL  触板跌停标记
0x8000000000ULL  沪港通零股(可买可卖)
0x10000000000ULL 沪港通零股(只可卖)