排序(sort) 在线调试

根据某个字段值对产品代码进行排序

网关地址

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

URL

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

是否需要业务登录

HTTP请求方式

GET

请求参数

参数名 类型 必填 最大长度 默认值 中文名 描述
en_hq_type_code String 500 类型代码集
可以输入一个或者多个类型代码,使用逗号(,)连接。 类型代码可以是交易所识别码或交易所识别码和金融品种分类识别码两者组合而成, 详细请参阅《恒生金融云平台_商品代码命名规范》 。 示例: SS 表示上海证券交易所的所有代码, SS.ESA 表示上海证券交易所的所有 A 股 必须输入en_hq_type_code或en_prod_code。
en_prod_code String 2000 产品代码集
可以输入一个或多个代码证券代码包含交易所代码做后缀,作为该代码的唯一标识。如:600570.SS; 必须输入en_hq_type_code或en_prod_code,但en_prod_code优先级高于 en_hq_type_code。
sort_field_name String 100 排序字段名称
按照该字段进行排序 允许的字段: 加权平均价:wavg_px 每股收益:eps 每股净资产:bps 昨收价:preclose_px 开盘价:open_px 最新价:last_px 最高价:high_px 最低价:low_px 成交金额:business_balance 成交数量:business_amount 成交笔数:business_count 国债基金净值:debt_fund_value 基金净值:iopv 涨跌额:px_change 涨跌幅:px_change_rate 振幅:amplitude 换手率:turnover_ratio 量比:vol_ratio 市盈率:pe_rate 市净率:dyn_pb_rate 市值:market_value 流通市值:circulation_value 内盘成交量:business_amount_in 外盘成交量:business_amount_out 委比:entrust_rate 委差:entrust_diff 财务季度:fin_quarter 财务截至日期:fin_end_date 总股本:total_shares 流通股本:circulation_amount 五分钟涨跌幅:min5_chgpct
sort_type String 1 1 排序方式
0:表示升序; 1:表示降序(默认)
fields String 255 字段集合
若不指定,默认返回所有字段,不同市场/不同业务品种所支持的字段可能不同。如需返回特定字段,请传字段参数名,多个参数用英文逗号隔开。
start_pos Integer 10 起始位置
对于排序结果,可指定从排序结果集的第start_pos个记录开始,返回data_count个数据 如果不输入该字段,则从排序结果集的首个记录开始,返回data_count个数据 (该字段可用作实现分页查询)
data_count Integer 10 数据个数
对于排序结果,指定返回的数据个数(排序结果集的数量,可能远大于实际需要返回的数据) 取值范围[1, 10000] 如果不输入该字段,则默认返回100个;如果输入值大于10000,则按实际数最多返回10000个,小于1的值或其它非数值按按默认值处理
special_marker String 255 特殊标志
可以指定以下标志对结果进行过滤,多个标志之间以逗号(,)分隔: DELIST_WARNING 退市警示标的 RISK_WARNING 风险警示标的 CRD_BUY 融资标的 CRD_SELL 融券标的 SH2HK 沪股通标的(可买可卖) HK2SH 港股通标的(可买可卖) SH2HK_ONLY_SELL 沪股通标的(只可卖) HK2SH_ONLY_SELL 港股通标的(只可卖) H_TARGET H股标的 B_TARGET B股标的 A_TARGET A股标的 HK_DW_C 港股-认购 HK_DW_P 港股-认沽 HK_CBBC_C 港股-牛证 HK_CBBC_P 港股-熊证

数据字典(1382)

mark_type String 1 0 标记类型
0:符合所有的特殊标记 1:只需要符合特殊标记的其中一个 2:对特殊标记取反

数据字典(24)

返回参数

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

请求示例

/quote/v1/sort?en_hq_type_code=XHKG-M&sort_field_name=last_px&data_count=10&start_pos=5&fields=last_px,open_px,high_px,low_px

正确返回示例

{"data":{"sort":{"fields":["last_px","high_px","low_px","open_px"],"02848.HKM":[637.5,0,0,637.5],"CADHKD.HKM":[602.7,0,0,602.7],"AUDHKD.HKM":[577.3,0,0,577.3],"SGDHKD.HKM":[575.95,0,0,575.95],"03020.HKM":[571.5,571.5,569.5,569.5],"00700.HKM":[408.8,415,408,412],"03007.HKM":[328.8,0,0,328.8],"03087.HKM":[276.2,277.4,271.8,275.4],"00388.HKM":[262,265.2,258.8,260],"03036.HKM":[227,0,0,227]}}}

关于排序接口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 沪港通零股(只可卖)