Ratings Summary by Firm

按机构汇总其分析师团队的评级统计：指定窗口内该机构全部评级的总数、覆盖分析师与代码数、评级分布与动作类型，以及整个研究团队的目标价准确度。firmName 需与数据完全一致（如 Morgan Stanley），适合机构间研究实力比较。

GEThttps://fmp-v2.icu/stable/tipranks-firm-summary?firmName=Morgan Stanley

数据更新周期

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

接口说明

接口地址

GET/stable/tipranks-firm-summary

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

请求参数

3 个参数

参数	类型	要求	示例	说明
`firmName`	string	必填	`Morgan Stanley`	机构名称关键词，用于按机构检索。
`from`	date	可选	`2025-06-10`	查询起始日期，格式 YYYY-MM-DD，包含当天。
`to`	date	可选	`2026-06-10`	查询结束日期，格式 YYYY-MM-DD，包含当天。

返回数据

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

字段	类型	说明
`firmName`	string	字段 firmName（原始英文名，语义以官方返回为准）
`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（原始英文名，语义以官方返回为准）

查看响应数据示例

[
{
"firmName": "Morgan Stanley",
"from": "2025-07-30",
"to": "2026-07-30",
"totalRecommendations": 14182,
"distinctSymbols": 4146,
"distinctAnalysts": 258,
"validPriceTargets": 14019,
"recommendations": {
"buy": 6156,
"hold": 6297,
"sell": 1729
},
"analystAction": {
"initiated": 300,
"maintained": 11474,
"upgraded": 373,
"downgraded": 448,
"reiterated": 1583,
"resumed": 4
},
"comparedPriceTargets": 13847,
"beats": 5133,
"misses": 8714,
"averageReturn": -0.0299,
"topReturn": 17.0036,
"worstReturn": -1

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

使用说明

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

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

免费试用 3 天