板块估值成分股
GET/v1/quote/f10/valuation-plate-stocks获取板块估值相关的成分股列表,支持按估值类型、排序字段和方向分页查询。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 查询 | 是 | 行业板块代码,如 HK.LIST1003。 |
valuation_type | int | 查询 | 否 | 估值类型。默认 1。1=PE,2=PB,3=PS。 |
next_key | string | 查询 | 否 | 翻页游标,首页留空。 |
limit | int | 查询 | 否 | 每页数量。默认 10,最大 50。 |
sort_type | string | 查询 | 否 | 排序方向。默认 asc。asc=升序,desc=降序。 |
sort_id | string | 查询 | 否 | 排序字段。默认 market_cap。可选:market_cap / valuation / forward_valuation / historical_percentile。 |
请求示例
bash
curl "$ip/v1/quote/f10/valuation-plate-stocks?symbol=HK.LIST1003&limit=2&valuation_type=1&sort_id=market_cap&sort_type=desc" | jq响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
pagination.total | int | 板块成分股总数。 |
pagination.has_more | bool | 是否还有下一页。 |
pagination.next_key | string | 下一页游标;无下一页为 "-1"。 |
stock_list[].symbol | string | 股票代码。 |
stock_list[].name | string | 股票名称。 |
stock_list[].valuation_val | float | 估值值(倍数)。 |
stock_list[].forward_value | float | 前瞻估值(倍数)。 |
stock_list[].valuation_percentile | float | 历史估值分位(0-100)。 |
stock_list[].market_cap | float | 总市值(按标的所属市场币种)。 |
限制范围
- 市场:HK / US / SH(含深市 A 股)。
- 品类:仅支持行业板块。概念板块、普通股、指数等返回 no_data。
- 条数:单次最多 50 条,更多数据请通过 next_key 翻页。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功 | — |
| -3 | invalid_parameter | 缺 symbol / 枚举非法 / limit 超出 1-50 | 按 ret_msg 提示修正参数 |
| -7 | invalid_symbol | 板块代码格式合法但不存在 | 核对板块代码 |
| -10 | no_data | 合法请求但无成分股估值数据 | 确认传入的是行业板块代码 |
| -2 / -5 | internal_error | 网关或后端内部错误 | 稍后重试;持续失败联系支持 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"stock_list": [
{
"forward_value": 5.792,
"market_cap": 1006241665662.15,
"name": "中国平安",
"symbol": "HK.02318",
"valuation_percentile": 18.8452285,
"valuation_val": 6.691
},
{
"forward_value": 5.539,
"market_cap": 791977034100,
"name": "中国人寿",
"symbol": "HK.02628",
"valuation_percentile": 23.5765838,
"valuation_val": 4.83
}
]
},
"pagination": { "has_more": true, "next_key": "2", "total": 19 }
}