排序(sort) 在线调试
根据某个字段值对产品代码进行排序
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=SS.esa&sort_field_name=last_px&data_count=10&start_pos=5&fields=last_px,open_px,high_px,low_px
正确返回示例
{
"data": {
"sort": {
"fields": [
"open_px",
"last_px",
"high_px",
"low_px"
],
"603018.SS": [
61.97,
60.47,
62.89,
60.28
],
"600990.SS": [
62.8,
59.99,
62.88,
59.36
],
"600570.SS": [
61.39,
58.57,
61.98,
58
],
"603019.SS": [
58,
53.9,
58.2,
53.8
],
"603017.SS": [
54.48,
53.15,
54.5,
52.82
],
"600562.SS": [
54.38,
51.79,
54.66,
51.71
]
}
}
}
