Ratings Summary by Analyst分析师评级汇总
该接口按滚动十二个月或自定义日期窗口汇总单名卖方分析师的全部评级表现，单行输出其推荐总次数、覆盖标的数量、买入与持有及卖出评级分布、上下调动作计数，以及目标价命中次数与平均收益率、最高及最低收益率，用于量化评估分析师研究质量。
https://quote-fmp.com/stable/tipranks-analyst-summary?expertUID=3c6eb8cf1347a4e5757e628fccb684a93abee587数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 评级分布：统计该分析师在窗口内发布的各评级（买入、持有、卖出）数量，反映其观点偏多还是偏空，传入
expertUID后可拿到expertUID（分析师唯一标识）、from（统计起始日期）与to（统计结束日期） 等明细项，便于在 Python 或 SQL 中直接聚合。 - 动作画像：分析师动作的分布——首评、维持、上调、下调等，体现其改变观点的频率，基于 Point-in-Time 时点快照还原华尔街投行与明星分析师的历史评级轨迹。
- 活跃数量：totalRecommendations 计数，量化窗口内的覆盖活跃度，研究端可将本接口与「个股评级汇总」组合编排，覆盖从概览快照到历史序列的需求。
- 跨模块关联接口：Analyst Directory Lookup（分析师档案查询） · Analyst Ratings Search（分析师评级搜索） · Stock Price and Volume Data（日线完整行情） · Financial Estimates（分析师预期查询）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
expertUID | string | 必填 | 3c6eb8cf1347a4e5757e628fccb684a93abee587 | 专家/研究员的唯一标识，用于论坛类数据检索。 |
from | date | 可选 | 2025-06-10 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-06-10 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码分析师评级汇总由 /stable/tipranks-analyst-summary 提供（必填 expertUID），明细涵盖 expertUID（分析师唯一标识）、from（统计起始日期）、to（统计结束日期） 等 15 列。
resp = requests.get(
"https://quote-fmp.com/stable/tipranks-analyst-summary",
params={"expertUID": "3c6eb8cf1347a4e5757e628fccb684a93abee587", "from": "2025-06-10", "to": "2026-06-10", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 totalRecommendations（评级总数）
df["totalRecommendations"] = pd.to_numeric(df["totalRecommendations"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 2025 一季度区间（from/to）查询分析师评级汇总 | expertUID=3c6eb8cf1347a4e5757e628fccb684a93abee587&from=2025-01-01&to=2025-03-31 | 设定 2025Q1 起止日期调用 /stable/tipranks-analyst-summary，返回窗口内全部 expertUID、from、to 共 15 列事件记录。 |
| 回溯 2024H2 日期区间（from/to）归档分析师评级汇总 | expertUID=3c6eb8cf1347a4e5757e628fccb684a93abee587&from=2024-07-01&to=2024-12-31 | 将日期窗口移至 2024 下半年调用 /stable/tipranks-analyst-summary，批量回填历史截面的 expertUID、from、to（样本 3c6eb8cf1347a4e5757e628f…）。 |
解析 /stable/tipranks-analyst-summary 产出的分析师评级汇总（必填 expertUID）时，注意 expertUID（如 3c6eb8cf1347a4e5757e628f…）在部分标的上可能为 null 或空串，下游关联前需做空值过滤。
本地维护分析师评级汇总底表（源自 /stable/tipranks-analyst-summary）时，主键定为 (expertUID)；读取 totalRecommendations（评级总数，样本 22）做横截面标准化前先剔除 NaN。
返回数据
15 个字段本接口示例响应共包含 15 个字段（数值型 10 个，文本/日期/布尔型 5 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
expertUID | string | "3c6eb8cf1347a4e5757e628fccb684…" | 分析师唯一标识 |
from | string | "2025-07-30" | 统计起始日期 |
to | string | "2026-07-30" | 统计结束日期 |
totalRecommendations | number | 22 | 评级总数 |
distinctSymbols | number | 8 | 去重证券代码数 |
distinctAnalysts | number | 1 | 去重分析师人数 |
validPriceTargets | number | 13 | 有效目标价数量 |
recommendations | object | {…} | 投资建议明细 |
analystAction | object | {…} | 分析师评级动作（上调/下调/维持） |
comparedPriceTargets | number | 13 | 参与比较的目标价数量 |
beats | number | 2 | 超预期次数 |
misses | number | 11 | 低于预期次数 |
averageReturn | number | -0.1206 | 平均回报率 |
topReturn | number | 0.3284 | 最佳回报率 |
worstReturn | number | -0.5881 | 最差回报率 |
查看响应数据示例（原始 JSON）
[
{
"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内容已截断，完整字段以实际返回为准。
常见问题解答（FAQ）
2 个问题在实际量化建模中，分析师评级汇总与 个股评级汇总（/stable/tipranks-symbol-summary）是如何互补联动的？
向 /stable/tipranks-analyst-summary 请求分析师评级汇总需遵循必填 expertUID，返回 expertUID（分析师唯一标识，样本 3c6eb8cf1347a4e5757e628f…）等 15 项；而 Ratings Summary by Symbol（个股评级汇总）遵循必填 symbol并返回 15 项。
回测需要多期或多标的分析师评级汇总，调用 /stable/tipranks-analyst-summary 应该如何组织请求？
您可以指定起止日期 from/to 分段同步 /stable/tipranks-analyst-summary；在落盘 分析师评级汇总 的 expertUID 与 from 时，建议将原始响应分批转换为列式存储。
同模块相关接口对比
TipRanks Summary本接口路径 /stable/tipranks-analyst-summary，必填参数 expertUID。 同一模块「TipRanks Summary」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。