Point in time Ratings by Symbol个股时点评级
该接口按股票代码与历史查询日期窗口返回华尔街卖方分析师的时点评级明细，精准还原指定历史截面日各位分析师对该标的的有效评级观点、目标价及过往推荐准确率统计，在量化事件驱动与卖方一致预期回测中严格规避未来函数。
https://quote-fmp.com/stable/tipranks-pit-symbol?symbol=AAPL数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 覆盖面板：每位分析师一行，含最新评级、该观点对应的目标价，以及触发评级的文章，传入
symbol后可获取expertUID（分析师唯一标识）、analystName（分析师姓名）与stockSuccessRate（荐股成功率） 等核心要素，减少跨市场数据入库时的字段映射工作。 - 分析师质量：每行含分析师整体 analystRank、该代码的历史 stockSuccessRate 和 stockAvgReturn，便于直接衡量可信度。
- 历史快照：可选 date 参数把快照回拨，重建任一过去时点的共识面貌，基于 Point-in-Time 时点快照还原华尔街投行与明星分析师的历史评级轨迹。
- 跨模块关联接口：Ratings Summary by Analyst（分析师评级汇总） · Ratings Summary by Firm（券商评级汇总） · Ratings Snapshot（评级快照） · Stock Price and Volume Data（日线完整行情）
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码，例如 AAPL、MSFT、NVDA（仅覆盖美股及在美上市 ADR，无需附加交易所后缀）。 |
date | string | 可选 | 2026-06-10 | 单一日期，格式 YYYY-MM-DD，用于查询某一天的行情或快照。 |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
nonadjusted | boolean | 可选 | false | 是否返回未复权原始价格：true 返回未复权，false 返回复权。 |
调用代码示例
Python 关键代码采集 个股时点评级（/stable/tipranks-pit-symbol）需传必填 symbol，重点读取 expertUID（分析师唯一标识）、analystName（分析师姓名）、stockSuccessRate（荐股成功率）（样本 expertUID=d970a430f313c453df61608e…）。
resp = requests.get(
"https://quote-fmp.com/stable/tipranks-pit-symbol",
params={"symbol": "AAPL", "date": "2026-06-10", "limit": 100, "page": 0, "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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取 AAPL 标的个股时点评级（symbol=AAPL） | symbol=AAPL | 指定标的代码 symbol=AAPL 调用 /stable/tipranks-pit-symbol，直接提取 个股时点评级 的 expertUID、analystName、stockSuccessRate 数据。 |
| 批量回填 AAPL 近 100 期个股时点评级记录 | symbol=AAPL&page=0&limit=100 | 配合 limit=100 调用 /stable/tipranks-pit-symbol，单次拿齐 AAPL 更长窗口的历史 expertUID、analystName、stockSuccessRate 序列。 |
| 对比 NVDA 与 AAPL 的个股时点评级 | symbol=NVDA | 将查询标的切换为 NVDA 访问 /stable/tipranks-pit-symbol，核对同行业龙头的 expertUID、analystName、stockSuccessRate 差异。 |
对接 /stable/tipranks-pit-symbol（个股时点评级，必填 symbol）时，重点字段 expertUID（d970a430f313c453df61608e…）与 analystName（Wamsi Mohan）反映当期截面状态，跨期比较前须对齐时间粒度。
清洗个股时点评级响应时，先按 (symbol, date) 剔除重复行，再提取 stockSuccessRate（荐股成功率，样本 0.788）构造量化指标。
返回数据
16 个字段本接口示例响应共包含 16 个字段（数值型 3 个，文本/日期/布尔型 13 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-29T09:30:14.797Z" | 日期 |
expertUID | string | "d970a430f313c453df61608e96e87e…" | 分析师唯一标识 |
analystName | string | "Wamsi Mohan" | 分析师姓名 |
stockSuccessRate | number | 0.788 | 荐股成功率 |
firmName | string | "Bank of America Securities" | 机构名称 |
lastRecommendation | string | "buy" | 最近一次投资建议 |
lastRecommendationDate | string | "2026-07-28" | 最近一次投资建议日期 |
articleTitle | string | "Wall Street Analysts Are Bulli…" | 文章标题 |
articleSite | string | "TipRanks Contributor" | 文章来源站 |
priceTarget | number | 380 | 目标价 |
priceTargetCurrency | string | "USD" | 目标价计价币种 |
url | string | "https://www.tipranks.com/news/…" | 链接地址 |
lastAnalystAction | string | "reiterated" | 最近一次分析师评级动作 |
stockReturn | number | -0.1253 | 股票回报率 |
beatTarget | boolean | false | 是否超出预期目标 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"date": "2026-07-29T09:30:14.797Z",
"expertUID": "d970a430f313c453df61608e96e87edee44e3dce",
"analystName": "Wamsi Mohan",
"stockSuccessRate": 0.788,
"firmName": "Bank of America Securities",
"lastRecommendation": "buy",
"lastRecommendationDate": "2026-07-28",
"articleTitle": "Wall Street Analysts Are Bullish on Top Technology Picks",
"articleSite": "TipRanks Contributor",
"priceTarget": 380,
"priceTargetCurrency": "USD",
"url": "https://www.tipranks.com/news/blurbs/wall-street-analysts-are-bullish-on-top-technology-picks-blurbs-news-171",
"lastAnalystAction": "reiterated",
"stockReturn": -0.1253,
"beatTarget": false
}
]常见问题解答（FAQ）
2 个问题请求 /stable/tipranks-pit-symbol 获取个股时点评级时有哪些必填项？它与 分析师时点评级 的边界在哪？
个股时点评级（/stable/tipranks-pit-symbol）采用必填 symbol查询，返回首条样本如 expertUID=d970a430f313c453df61608e…（共 16 列）；同模块相邻的 Point in time Ratings by Analyst（分析师时点评级）则包含 16 列。
初次建库回填个股时点评级与日常增量拉取 /stable/tipranks-pit-symbol，在传参方式上有何技巧？
在量化管道中，应在 /stable/tipranks-pit-symbol 中固定 limit 并从 page=0 起逐页拉取；若并发拉取多组任务，请结合网关 RPM 配额控制并发协程数，稳健采集 expertUID。
同模块相关接口对比
TipRanks PIT Latest本接口路径 /stable/tipranks-pit-symbol，必填参数 symbol。 同一模块「TipRanks PIT Latest」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 分析师时点评级Point in time Ratings by Analyst | /stable/tipranks-pit-analyst | 按指定历史截面日期汇总单名卖方分析师对其所覆盖全部股票的最新有效评级与目标价快照 |