排序（sort）
根据某个字段值对产品代码进行排序
网关地址
| 沙箱环境调用地址： | https://sandbox.hscloud.cn |
| 数据核查类生产调用地址： | https://api.hscloud.cn |
| 其余生产调用地址： | https://open.hscloud.cn |
URL
| https://sandbox.hscloud.cn/quote/v1/sort |
|---|
是否需要业务登录
| 否 |
|---|
HTTP请求方式
| GET |
|---|
支持格式
| JSON |
|---|
请求参数
| 参数名 | 类型 | 必填 | 最大长度 | 默认值 | 中文名 | 描述 |
|---|---|---|---|---|---|---|
| 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 | 0 | 排序方式 |
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 港股-熊证
|
返回参数
| 参数名 | 类型 | 最大长度 | 默认值 | 中文名 | 描述 |
|---|---|---|---|---|---|
| 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":{"CADHKD.HKM":[602.7,0,0,602.7],"03087.HKM":[276.2,277.4,271.8,275.4],"AUDHKD.HKM":[577.3,0,0,577.3],"03007.HKM":[328.8,0,0,328.8],"02848.HKM":[637.5,0,0,637.5],"00700.HKM":[408.8,415,408,412],"03020.HKM":[571.5,571.5,569.5,569.5],"03036.HKM":[227,0,0,227],"00388.HKM":[262,265.2,258.8,260],"SGDHKD.HKM":[575.95,0,0,575.95],"fields":["last_px","high_px","low_px","open_px"]}}}
