Ratings Summary by Symbol

按股票代码汇总 TipRanks 评级统计：指定时间窗口（默认滚动十二个月）内的评级总数、覆盖分析师数、买入/持有/卖出分布、各类动作（首次覆盖/维持/上调/下调等）计数，以及目标价准确度统计（命中与偏差次数、平均/最好/最差回报）。单行返回，适合共识标签与选股器批量展开。

GEThttps://fmp-v2.icu/stable/tipranks-symbol-summary?symbol=AAPL

数据更新周期

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

接口说明

接口地址

GET/stable/tipranks-symbol-summary

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

请求参数

3 个参数

参数	类型	要求	示例	说明
`symbol`	string	必填	`AAPL`	证券代码，例如 AAPL 或 MSFT。
`from`	date	可选	`2025-06-10`	查询起始日期，格式 YYYY-MM-DD，包含当天。
`to`	date	可选	`2026-06-10`	查询结束日期，格式 YYYY-MM-DD，包含当天。

返回数据

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

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

查看响应数据示例

[
{
"symbol": "AAPL",
"from": "2025-07-30",
"to": "2026-07-30",
"totalRecommendations": 425,
"distinctSymbols": 1,
"distinctAnalysts": 45,
"validPriceTargets": 379,
"recommendations": {
"buy": 277,
"hold": 122,
"sell": 26
},
"analystAction": {
"initiated": 3,
"maintained": 309,
"upgraded": 16,
"downgraded": 5,
"reiterated": 92,
"resumed": 0
},
"comparedPriceTargets": 379,
"beats": 323,
"misses": 56,
"averageReturn": 0.1697,
"topReturn": 0.8466,
"worstReturn": -0.169

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

使用说明

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

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

免费试用 3 天