展示目标股票的 Buy / Hold / Sell 家数占比与近期大行调级动态。
Partners（合作方数据）
此类接口提供来自 TipRanks 的分析师评级信息，包括按标的、分析师或机构查询的及时点评分，以及对应的评级汇总与分析师名录。相比自建评级体系，它更适合直接作为第三方评级输入使用；更新节奏与 TipRanks 同步，个别标的可能没有覆盖。
典型使用场景
3 个场景筛选历史胜率高的分析师，监控其最新覆盖与上调评级的标的。
利用 Point-in-Time 评级序列测试评级密集上调/下调后的超额收益。
接口怎么选？
6 项选型对照合作方数据类别围绕「谁在什么时间给哪只股票打了什么评级」构建了三个正交查询维度：按股票代码（by Symbol）、按分析师个人（by Analyst）、按投行券商机构（by Firm）。
除当前评级分布汇总（Ratings Summary）外，还提供用于严谨量化回测的时点评级接口（Point-in-Time Ratings），确保在任意历史截面只看到当时已发布的评级。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 查看某只股票当前的买/中/卖评级汇总与目标价 | Ratings Summary by Symbol个股评级汇总 | 快速获取华尔街对该股的看多/看空共识比例 |
| 查询某只股票在历史各时点的分析师评级明细 | Point in time Ratings by Symbol个股时点评级 | Point-in-Time 口径，适合回测分析师评级调整事件 |
| 按分析师姓名查看其历史评级记录 | Point in time Ratings by Analyst分析师时点评级 | 跟踪特定明星分析师的覆盖标的与调级轨迹 |
| 查看某位分析师的整体评级分布与覆盖汇总 | Ratings Summary by Analyst分析师评级汇总 | 评估单个分析师的评级倾向（偏好给 Buy 还是 Hold） |
| 查看高盛、摩根士丹利等投行机构的评级汇总 | Ratings Summary by Firm券商评级汇总 | 从券商机构维度统计评级分布 |
| 检索分析师名单与所属机构档案 | Analyst Directory Lookup分析师档案查询 | 配合 Analyst Ratings Search（分析师评级搜索） 定位分析师标准名称 |
数据覆盖与参数口径
- 查询维度：按股票代码（symbol）、按分析师（analystName）、按券商（firmName）
- 回测支持：Point-in-Time 接口保留历史发布时点，避免未来信息泄露
- 互补关系：可与 Analyst 类别下的 Financial Estimates（分析师预期查询）（业绩一致预期）与 Price Target Consensus（目标价共识） 结合使用
调用示例
Python 关键代码示例场景：查询 AAPL 的合作方分析师评级汇总 · 对应接口：Ratings Summary by Symbol（个股评级汇总）
Python（核心参数与字段清洗逻辑）
resp = requests.get(
"https://quote-fmp.com/stable/tipranks-symbol-summary",
params={"symbol": "AAPL", "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")- 做历史事件回测请使用 Point in time Ratings by Symbol（个股时点评级），不要用静态汇总倒推过去。
- 分析师姓名参数可先通过 Analyst Directory Lookup（分析师档案查询） 检索确认。
数据注意事项
4 条实盘要点- 做历史事件研究或量化回测时，必须使用 Point in time Ratings by Symbol（个股时点评级） 或 Point in time Ratings by Analyst（分析师时点评级），静态汇总接口——如 Ratings Summary by Firm（券商评级汇总）——仅反映当前截面。
- 按分析师或投行券商检索前，先用 Analyst Directory Lookup（分析师档案查询） 或 Analyst Ratings Search（分析师评级搜索） 确认系统收录的标准英文姓名与机构名拼写。
- 个股当前的华尔街买/中/卖分布可直接读取 Ratings Summary by Symbol（个股评级汇总），并与 Analyst 分类下的 Price Target Consensus（目标价共识） 及 Financial Estimates（分析师预期查询） 交叉印证。
- 评估单个明星分析师或顶级投行的评级倾向（如是否长期偏乐观）时，可对比 Ratings Summary by Analyst（分析师评级汇总） 与 Ratings Summary by Firm（券商评级汇总） 的多空比例。
常见问题
2 个问题本类别（Partners）与 Analyst（分析师数据）类别有什么区别？
Analyst 类别覆盖 FMP 原生的营收/EPS 财务预测（Financial Estimates）、目标价共识与 FMP 自有评级；Partners 类别则提供第三方合作数据源细化到「具体分析师个人」与「具体投行机构」的 Point-in-Time 评级追踪。
为什么回测必须用 Point-in-Time 接口？
因为普通汇总接口反映的是当前最新截面，而 Point-in-Time 接口按历史真实发布日期记录每一次评级动作，能严格防止回测中偷看未来评级。
接口一览（7个）
4 个功能模块TipRanks Search
1 个接口TipRanks PIT Latest
2 个接口GETPoint in time Ratings by Symbol
个股时点评级该接口按股票代码与历史查询日期窗口返回华尔街卖方分析师的时点评级明细，精准还原指定历史截面日各位分析师对该标的的有效评级观点、目标价及过往推荐准确率统计，在量化事件驱动与卖方一致预期回测中严格规避未来函数。
/stable/tipranks-pit-symbolGETPoint in time Ratings by Analyst
分析师时点评级该接口按指定历史截面日期汇总单名卖方分析师对其所覆盖全部股票的最新有效评级与目标价快照，同时返回该分析师在各只标的上的个股推荐胜率、历史平均回报率与全市场排名，专为无未来函数的时点截面回测与明星分析师跟单策略设计。
/stable/tipranks-pit-analystTipRanks Summary
3 个接口GETRatings Summary by Symbol
个股评级汇总该接口按指定日期窗口汇总单只股票收到的全部卖方分析师评级分布与目标价准确度统计，单行呈现总评级次数、覆盖分析师人数、买入与持有及卖出观点占比、评级上调与下调次数以及历史目标价兑现收益表现，是衡量市场多空共识强度的核心数据源。
/stable/tipranks-symbol-summaryGETRatings Summary by Analyst
分析师评级汇总该接口按滚动十二个月或自定义日期窗口汇总单名卖方分析师的全部评级表现，单行输出其推荐总次数、覆盖标的数量、买入与持有及卖出评级分布、上下调动作计数，以及目标价命中次数与平均收益率、最高及最低收益率，用于量化评估分析师研究质量。
/stable/tipranks-analyst-summaryGETRatings Summary by Firm
券商评级汇总该接口按指定时间窗口汇总单家券商研究所旗下全体分析师的评级与目标价整体战绩，单行整合该机构的推荐总数、活跃分析师人数、覆盖股票数、多空评级分布、评级变动方向统计以及目标价命中率与平均投资回报率，适用于买方对卖方券商研究实力的横向考核。
/stable/tipranks-firm-summaryTipranks Analysts
1 个接口准备好接入合作方数据相关接口了吗？接口路径与 FMP 保持兼容，替换域名和 API Key 即可开始。
领取 1 个月试用 Key