Point in time Ratings by Analyst分析师时点评级

Q: 工程团队在封装 /stable/tipranks-pit-analyst（分析师时点评级）客户端时，应采用怎样的拉取逻辑？

标准流程是直接请求无参端点 /stable/tipranks-pit-analyst 拉取全表快照并缓存；在拿到 分析师时点评级 的 expertUID 与 analystName 后，及时释放内存中的原始文本流。

该接口按指定历史截面日期汇总单名卖方分析师对其所覆盖全部股票的最新有效评级与目标价快照，同时返回该分析师在各只标的上的个股推荐胜率、历史平均回报率与全市场排名，专为无未来函数的时点截面回测与明星分析师跟单策略设计。

GEThttps://quote-fmp.com/stable/tipranks-pit-analyst

数据更新周期

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

接口说明

分析师观点簿：以组合视角呈现该分析师当前覆盖的每个标的，其最近一次观点按 symbol 折叠为一行。
目标价与文章：每只代码最新发布的目标价，以及触发该评级的文章和来源网站，基于 Point-in-Time 时点快照还原华尔街投行与明星分析师的历史评级轨迹。
表现背景：每行都附带 analystRank、stockSuccessRate 和 stockAvgReturn，可与观点一同展示。
上下游关联接口：Analyst Directory Lookup（分析师档案查询） · Analyst Ratings Search（分析师评级搜索） · Price Target Consensus（目标价共识） · Ratings Snapshot（评级快照）

调用代码示例

Python 关键代码

分析师时点评级路径为 /stable/tipranks-pit-analyst（仅 apikey），响应 JSON 展开 expertUID（分析师唯一标识）、analystName（分析师姓名）、stockSuccessRate（荐股成功率）共 16 列。

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/tipranks-pit-analyst",
    params={"apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 stockSuccessRate（荐股成功率）
df["stockSuccessRate"] = pd.to_numeric(df["stockSuccessRate"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

参数使用和避坑

3 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景	Query 参数组合示例	返回数据特征与用途
一次性拉取全量分析师时点评级初始化本地主表	`GET /stable/tipranks-pit-analyst（免参数）`	该接口不吃 Query 条件：请求 /stable/tipranks-pit-analyst 直接下发全表 16 列，expertUID、analystName、stockSuccessRate 全在其中。
按条件取子集走个股时点评级，全表取数走本接口	`/stable/tipranks-pit-symbol?symbol=AAPL / /stable/tipranks-pit-analyst`	需要按 symbol 过滤取子集时用 /stable/tipranks-pit-symbol（可传参）；需要完整截面时用 /stable/tipranks-pit-analyst 免参数全表。两者字段重叠度高，可互为对账基准。
落库后自检：symbol 唯一性与 expertUID 空值率	`GET /stable/tipranks-pit-analyst → count(distinct symbol) / null_ratio(expertUID)`	本表共 16 列。落库后先比对 count(distinct symbol) 与总行数确认无重复；再统计 expertUID（样本 3c6eb8cf1347a4e5757e628f…）的空值比例，判断该批次是否拉到完整截面。

时序与查询边界调用 /stable/tipranks-pit-analyst：空列表防守与 expertUID（分析师唯一标识）提取

调用 /stable/tipranks-pit-analyst 拉取分析师时点评级（免业务参数）时，若条件未命中会返回 []；读取 expertUID（3c6eb8cf1347a4e5757e628f…）与 analystName 前须先判断 not df.empty。

落库主键与口径对接 /stable/tipranks-pit-analyst：以 (symbol, date) 防重并提取 stockSuccessRate（荐股成功率）

/stable/tipranks-pit-analyst 的首条样本含 stockSuccessRate=0；日常增量任务按 (symbol, date) 合并即可保持本地库与上游一致。

返回数据

16 个字段

本接口示例响应共包含 16 个字段（数值型 1 个，文本/日期/布尔型 15 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段	类型	示例值	说明
`symbol`	string	`"0J3K.L"`	证券代码
`date`	string	`"2026-05-21T13:40:11.370Z"`	日期
`expertUID`	string	`"3c6eb8cf1347a4e5757e628fccb684…"`	分析师唯一标识
`analystName`	string	`"Keegan Cox"`	分析师姓名
`stockSuccessRate`	number	`0`	荐股成功率
`firmName`	string	`"D.A. Davidson"`	机构名称
`lastRecommendation`	string	`"Hold"`	最近一次投资建议
`lastRecommendationDate`	string	`"2026-05-21"`	最近一次投资建议日期
`articleTitle`	string	`"Analysts Offer Insights on Con…"`	文章标题
`articleSite`	string	`"TipRanks Contributor"`	文章来源站
`priceTarget`	null	`null`	目标价
`priceTargetCurrency`	null	`null`	目标价计价币种
`url`	string	`"https://www.tipranks.com/news/…"`	链接地址
`lastAnalystAction`	string	`"maintained"`	最近一次分析师评级动作
`stockReturn`	null	`null`	股票回报率
`beatTarget`	null	`null`	是否超出预期目标

查看响应数据示例（原始 JSON）

[
{
"symbol": "0J3K.L",
"date": "2026-05-21T13:40:11.370Z",
"expertUID": "3c6eb8cf1347a4e5757e628fccb684a93abee587",
"analystName": "Keegan Cox",
"stockSuccessRate": 0,
"firmName": "D.A. Davidson",
"lastRecommendation": "Hold",
"lastRecommendationDate": "2026-05-21",
"articleTitle": "Analysts Offer Insights on Consumer Cyclical Companies: Hasbro (NASDAQ: HAS) and Burlington Stores (NYSE: BURL)",
"articleSite": "TipRanks Contributor",
"priceTarget": null,
"priceTargetCurrency": null,
"url": "https://www.tipranks.com/news/blurbs/analysts-offer-insights-on-consumer-cyclical-companies-hasbro-has-and-burlington-stores-burl-blurbs-news",
"lastAnalystAction": "maintained",
"stockReturn": null,
"beatTarget": null
}
]

常见问题解答（FAQ）

2 个问题

分析师时点评级（/stable/tipranks-pit-analyst）产出的 expertUID 等字段，与个股时点评级的返回内容有何侧重？

分析师时点评级（端点 /stable/tipranks-pit-analyst，免业务参数）返回 expertUID（分析师唯一标识）及 analystName（Keegan Cox）共 16 列；若业务需要 Point in time Ratings by Symbol（个股时点评级），可改调 /stable/tipranks-pit-symbol（必填 symbol）。

工程团队在封装 /stable/tipranks-pit-analyst（分析师时点评级）客户端时，应采用怎样的拉取逻辑？

标准流程是直接请求无参端点 /stable/tipranks-pit-analyst 拉取全表快照并缓存；在拿到分析师时点评级的 expertUID 与 analystName 后，及时释放内存中的原始文本流。

同模块相关接口对比

TipRanks PIT Latest

本接口路径 /stable/tipranks-pit-analyst，无必填参数。同一模块「TipRanks PIT Latest」下共 2 个接口，下表列出其余 1 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
个股时点评级Point in time Ratings by Symbol	`/stable/tipranks-pit-symbol`	按股票代码与历史查询日期窗口返回华尔街卖方分析师的时点评级明细

Partners（合作方数据）全部接口目录 →

需要稳定访问分析师时点评级数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月