排序（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 港股-熊证
|
|
| mark_type | String | 否 | 1 | 0 | 标记类型 |
0:符合所有的特殊标记
1:只需要符合特殊标记的其中一个
2:对特殊标记取反
|
返回参数
| 参数名 | 类型 | 最大长度 | 默认值 | 中文名 | 描述 |
|---|---|---|---|---|---|
| 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 沪港通零股（只可卖）
