Ratings Summary by Analyst

按分析师汇总其评级统计：指定窗口内发布的评级总数、覆盖代码数、买卖持有分布、各类动作占比，以及其目标价的命中记录与回报统计。单行返回，用于分析师画像与研究质量评分。

GEThttps://fmp-v2.icu/stable/tipranks-analyst-summary?expertUID=3c6eb8cf1347a4e5757e628fccb684a93abee587

数据更新周期

该接口暂无固定更新周期（多为按需更新的参考或静态数据）。

接口说明

接口地址

GET/stable/tipranks-analyst-summary

请求需要携带网关下发的 API Key。接口路径及参数名称与 FMP 官方格式保持一致。

请求参数

3 个参数

参数	类型	要求	示例	说明
`expertUID`	string	必填	`3c6eb8cf1347a4e5757e628fccb684a93abee587`	专家/研究员的唯一标识，用于论坛类数据检索。
`from`	date	可选	`2025-06-10`	查询起始日期，格式 YYYY-MM-DD，包含当天。
`to`	date	可选	`2026-06-10`	查询结束日期，格式 YYYY-MM-DD，包含当天。

返回数据

下表列出示例响应中的主要字段，实际字段会因接口及数据状态而有所不同。

字段	类型	说明
`expertUID`	string	除uid（expertUID）
`from`	string	字段 from（原始英文名，语义以官方返回为准）
`to`	string	字段 to（原始英文名，语义以官方返回为准）
`totalRecommendations`	number	总计评级（totalRecommendations）
`distinctSymbols`	number	distinct代码（distinctSymbols）
`distinctAnalysts`	number	distinct分析师（distinctAnalysts）
`validPriceTargets`	number	valid价格目标位（validPriceTargets）
`recommendations`	object	评级（recommendations）
`analystAction`	object	分析师行动（analystAction）
`comparedPriceTargets`	number	compared价格目标位（comparedPriceTargets）
`beats`	number	字段 beats（原始英文名，语义以官方返回为准）
`misses`	number	字段 misses（原始英文名，语义以官方返回为准）
`averageReturn`	number	平均return（averageReturn）
`topReturn`	number	字段 topReturn（原始英文名，语义以官方返回为准）
`worstReturn`	number	字段 worstReturn（原始英文名，语义以官方返回为准）

查看响应数据示例

[
{
"expertUID": "3c6eb8cf1347a4e5757e628fccb684a93abee587",
"from": "2025-07-30",
"to": "2026-07-30",
"totalRecommendations": 22,
"distinctSymbols": 8,
"distinctAnalysts": 1,
"validPriceTargets": 13,
"recommendations": {
"buy": 16,
"hold": 6,
"sell": 0
},
"analystAction": {
"initiated": 0,
"maintained": 21,
"upgraded": 0,
"downgraded": 0,
"reiterated": 1,
"resumed": 0
},
"comparedPriceTargets": 13,
"beats": 2,
"misses": 11,
"averageReturn": -0.1206,
"topReturn": 0.3284,
"worstReturn": -0.5881

内容已截断，完整字段以实际返回为准。

使用说明

日期、证券代码和枚举参数应严格使用接口要求的格式。
超出分钟限流时会返回 HTTP 429，请根据响应状态合理重试。
空数组通常表示当前查询条件下暂无数据，不代表请求失败。

需要稳定访问 Ratings Summary by Analyst 数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 3 天