FMP行情数据API网行情数据

Point in time Ratings by Symbol

Point in time Ratings by Symbol

按股票代码查询指定日期的分析师评级时点快照:将截至该日期的全部评级折叠为每位分析师一条记录(其最新有效评级),附分析师排名(analystRank)、历史命中率(stockSuccessRate)与平均回报(stockAvgReturn)及目标价。可传入历史日期还原当时的共识面貌,适合个股页面与共识组件。

GEThttps://fmp-v2.icu/stable/tipranks-pit-symbol?symbol=AAPL

数据更新周期

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

接口说明

按股票代码查询指定日期的分析师评级时点快照:将截至该日期的全部评级折叠为每位分析师一条记录(其最新有效评级),附分析师排名(analystRank)、历史命中率(stockSuccessRate)与平均回报(stockAvgReturn)及目标价。可传入历史日期还原当时的共识面貌,适合个股页面与共识组件。

接口地址

GET/stable/tipranks-pit-symbol

请求需要携带网关下发的 API Key。接口路径及参数名称与 FMP 官方格式保持一致。

请求参数

5 个参数
参数类型要求示例说明
symbolstring必填AAPL证券代码,例如 AAPL 或 MSFT。
datestring可选2026-06-10单一日期,格式 YYYY-MM-DD,用于查询某一天的行情或快照。
limitnumber可选100返回结果条数上限,用于控制单次响应大小。
pagenumber可选0分页页码,从 0 开始,配合每页条数翻页取更多数据。
nonadjustedboolean可选false是否返回未复权原始价格:true 返回未复权,false 返回复权。

返回数据

下表列出示例响应中的主要字段,实际字段会因接口及数据状态而有所不同。

字段类型说明
symbolstring证券代码
datestring数据对应日期
expertUIDstring除uid(expertUID)
analystNamestring分析师name(analystName)
stockSuccessRatenumber股票success率(stockSuccessRate)
firmNamestring字段 firmName(原始英文名,语义以官方返回为准)
lastRecommendationstring最近一次评级(lastRecommendation)
lastRecommendationDatestring最近一次评级date(lastRecommendationDate)
articleTitlestringarticle标题(articleTitle)
articleSitestring文章来源站
priceTargetnumber价格目标位(priceTarget)
priceTargetCurrencystring价格目标位币种(priceTargetCurrency)
urlstring链接地址
lastAnalystActionstring最近一次分析师行动(lastAnalystAction)
stockReturnnumber股票return(stockReturn)
beatTargetbooleanbeat目标位(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 天