分析师一致预期
GET/v1/quote/{symbol}/f10/analyst-consensus获取股票的分析师一致预期评级与目标价(综合评级、覆盖分析师数、各档评级占比、目标价区间)。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 股票代码,如 HK.00700。 |
请求示例
bash
curl "$ip/v1/quote/HK.00700/f10/analyst-consensus" | jq响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
rating | int | 综合评级。1=Sell,2=Underperform,3=Hold,4=Buy,5=Strong Buy。 |
total | int | 覆盖该股票的分析师总数。 |
strong_buy | float | 强烈买入占比(%)。 |
buy | float | 买入占比(%)。仅 HK/CN/SG/MY/AU/JP 返回。 |
hold | float | 持有占比(%)。 |
underperform | float | 跑输大盘占比(%)。仅 HK/CN/SG/MY/AU/JP 返回。 |
sell | float | 卖出占比(%)。 |
average | float | 平均目标价(报告币种)。 |
highest | float | 最高目标价。 |
lowest | float | 最低目标价。 |
num_of_target_analysts | int | 给出目标价预测的分析师人数。 |
update_time | int | 评级数据更新时间,秒级时间戳。 |
update_time_str | string | 评级数据更新日期(yyyy-MM-dd)。 |
限制范围
- 市场:HK / US / CN(沪/深/北)/ SG / CA / AU / JP / MY / KR。
- 品类:正股(有分析师覆盖)。
- 评级档位差异:HK / CN / SG / MY / AU / JP 返回 5 档;US / CA / KR 仅返回 3 档(strong_buy / hold / sell)。
- 合法但无分析师覆盖的标的返回 ret_code=0 且 data 为空对象 {}。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| -3 | invalid_parameter | symbol 格式非法 | 修正股票代码格式后重试 |
| -7 | invalid_symbol | symbol 格式合法但证券库查不到 | 通过 search 接口确认代码合法性 |
| -2 / -4 / -6 | internal_error | 网关内部错误 | 稍后重试,持续失败联系支持 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"average": 686.71,
"buy": 22.727,
"highest": 794.73,
"hold": 0,
"lowest": 560,
"num_of_target_analysts": 44,
"rating": 5,
"sell": 0,
"strong_buy": 77.273,
"total": 44,
"underperform": 0,
"update_time": 1780729098,
"update_time_str": "2026-06-06"
}
}