Point in time Ratings by Symbol
Point in time Ratings by Symbol
按股票代码查询指定日期的分析师评级时点快照:将截至该日期的全部评级折叠为每位分析师一条记录(其最新有效评级),附分析师排名(analystRank)、历史命中率(stockSuccessRate)与平均回报(stockAvgReturn)及目标价。可传入历史日期还原当时的共识面貌,适合个股页面与共识组件。
GET
https://fmp-v2.icu/stable/tipranks-pit-symbol?symbol=AAPL数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
按股票代码查询指定日期的分析师评级时点快照:将截至该日期的全部评级折叠为每位分析师一条记录(其最新有效评级),附分析师排名(analystRank)、历史命中率(stockSuccessRate)与平均回报(stockAvgReturn)及目标价。可传入历史日期还原当时的共识面貌,适合个股页面与共识组件。
接口地址
GET
/stable/tipranks-pit-symbol请求需要携带网关下发的 API Key。接口路径及参数名称与 FMP 官方格式保持一致。
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT。 |
date | string | 可选 | 2026-06-10 | 单一日期,格式 YYYY-MM-DD,用于查询某一天的行情或快照。 |
limit | number | 可选 | 100 | 返回结果条数上限,用于控制单次响应大小。 |
page | number | 可选 | 0 | 分页页码,从 0 开始,配合每页条数翻页取更多数据。 |
nonadjusted | boolean | 可选 | false | 是否返回未复权原始价格:true 返回未复权,false 返回复权。 |
返回数据
下表列出示例响应中的主要字段,实际字段会因接口及数据状态而有所不同。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 证券代码 |
date | string | 数据对应日期 |
expertUID | string | 除uid(expertUID) |
analystName | string | 分析师name(analystName) |
stockSuccessRate | number | 股票success率(stockSuccessRate) |
firmName | string | 字段 firmName(原始英文名,语义以官方返回为准) |
lastRecommendation | string | 最近一次评级(lastRecommendation) |
lastRecommendationDate | string | 最近一次评级date(lastRecommendationDate) |
articleTitle | string | article标题(articleTitle) |
articleSite | string | 文章来源站 |
priceTarget | number | 价格目标位(priceTarget) |
priceTargetCurrency | string | 价格目标位币种(priceTargetCurrency) |
url | string | 链接地址 |
lastAnalystAction | string | 最近一次分析师行动(lastAnalystAction) |
stockReturn | number | 股票return(stockReturn) |
beatTarget | boolean | beat目标位(beatTarget) |
查看响应数据示例
[
{
"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
}
]使用说明
- 日期、证券代码和枚举参数应严格使用接口要求的格式。
- 超出分钟限流时会返回 HTTP 429,请根据响应状态合理重试。
- 空数组通常表示当前查询条件下暂无数据,不代表请求失败。
需要稳定访问 Point in time Ratings by Symbol 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 3 天