获取单只印度股票的分析师目标价与买入至卖出评级共识,附带一周至 90 天前的历史快照。

查看 印度股票交易所 API 的全部接口 →

以单个 JSON 对象返回一只印度上市股票的分析师目标价统计和评级共识。唯一的输入是必填查询参数 stock_id,目录默认值和探测值均为 TCS,文档仅将其描述为股票的唯一标识符。响应分为四个部分:priceTarget(当前共识目标价)、priceTargetSnapshots、recommendation(当前共识评级)和 recommendationSnapshots。以 stock_id=TCS 实际探测(HTTP 200)的结果为例:priceTarget 含九个成员(CurrencyCode、UnverifiedMean、PreliminaryMean、Mean、High、Low、NumberOfEstimates、Median、StandardDeviation),其中 CurrencyCode 为 INR。priceTargetSnapshots.PriceTargetSnapshot 包含四条记录,Age 分别为 OneWeekAgo、ThirtyDaysAgo、SixtyDaysAgo 和 NinetyDaysAgo,每条都带有 CurrencyCode、Mean、High、Low、NumberOfEstimates、Median 和 StandardDeviation。recommendation 含 Mean、High、Low、NumberOfRecommendations、UnverifiedMean、PreliminaryMean,以及由五行组成的 Statistics.Statistic 列表,每行把 1 到 5 的 Recommendation 代码与 NumberOfAnalysts 配对;在该次探测中,五个分析师人数之和等于 NumberOfRecommendations。recommendationSnapshots.RecommendationSnapshot 包含同样四个 Age,每个都带有 Mean、High、Low、NumberOfRecommendations 和 Statistics。文档给出的评级刻度为 1 买入、2 跑赢大盘、3 持有、4 跑输大盘、5 卖出,因此 Mean 越低越看多;High 表示最看多的代码(1),Low 表示最看空的代码(5)。文档还描述了 404 响应(正文为 Stock target price not found)和 500 响应(正文以 An error occurred 开头);探测中均未出现,并且只探测了 TCS,因此文档示例中的数值以及其他标识符的表现均未经验证。这些数据仅是信息性的市场快照,不构成投资建议,也不是持牌行情数据源。

API 功能

以印度卢比计价的共识目标价 priceTarget 返回 CurrencyCode 以及 Mean、Median、High、Low、StandardDeviation 和 NumberOfEstimates,一次调用就能同时看到分析师目标价的中心水平和各家预测的分散程度。
四个时间点的目标价历史快照 priceTargetSnapshots.PriceTargetSnapshot 列出 OneWeekAgo、ThirtyDaysAgo、SixtyDaysAgo 和 NinetyDaysAgo 四条记录,统计字段与当前目标价一致,方便用图表展示共识目标价是在上调还是下调。
1 到 5 级评级均值 recommendation.Mean 把全部分析师评级压缩成一个数字,对应文档中的买入、跑赢大盘、持有、跑输大盘、卖出刻度,数值越低越看多,High 与 Low 标出两端的极值。
每个评级档位的分析师人数 recommendation.Statistics.Statistic 为 1 到 5 的每个 Recommendation 代码给出 NumberOfAnalysts,客户端可以直接画出评级分布柱状图,而不必只依赖均值。
评级变化与对应快照对照 recommendationSnapshots.RecommendationSnapshot 针对每个 Age 重复给出 Mean、High、Low、NumberOfRecommendations 和 Statistics,可直接把当前共识与更早的读数做对比。
只需一个必填的 stock_id 请求只要求传入 stock_id(目录默认值为 TCS),四个部分一并返回,同一家公司的目标价与评级不必再发第二次请求去拼接。

在线 API 演示

GET /api/project/indian-stock-exchange-api/analyst-recommendations

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/analyst-recommendations?key=<API_KEY>&stock_id=TCS'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

stock_id 参数支持哪些取值?

stock_id 为必填。目录默认值是 TCS,探测时返回 HTTP 200,文档只把它描述为股票的唯一标识符,并没有列出是否还支持公司名称、BSE 证券代码或其他股票代码。如果要使用别的标识符,请先自行测试,再基于它开发。

怎样解读 recommendation 的 Mean 值?

文档对应关系为 1 买入、2 跑赢大盘、3 持有、4 跑输大盘、5 卖出,因此 Mean 越低,共识越看多。探测中 High 为 1、Low 为 5,说明 High 指的是最看多的评级代码,Low 指的是最看空的评级代码,而不是数值的大小。

响应里包含哪些快照?

当前共识位于 priceTarget 和 recommendation 中。探测时,priceTargetSnapshots.PriceTargetSnapshot 与 recommendationSnapshots.RecommendationSnapshot 各有四条记录,Age 分别为 OneWeekAgo、ThirtyDaysAgo、SixtyDaysAgo 和 NinetyDaysAgo。文档还提到一条当周记录,但探测结果中当前读数只出现在顶层对象里。

recommendation 里的 Statistics 列表包含什么?

Statistics.Statistic 是由五行组成的列表,每行含 1 到 5 的 Recommendation 代码,以及给出该评级的分析师人数 NumberOfAnalysts。探测中五个人数之和等于 NumberOfRecommendations,所以可以直接用这个列表计算每个评级所占的百分比。

目标价使用什么货币?数值一定是数字吗?

探测中 priceTarget 及每条快照的 CurrencyCode 都是 INR,Mean、High、Low、Median 和 StandardDeviation 均为 JSON 数字,文档示例的结构也相同。请以 CurrencyCode 为准,不要自行假定币种;由于只探测了一只股票,处理字段时也要做好缺失字段的防御。

这个接口会返回哪些错误?

文档列出了 404 响应(消息为 Stock target price not found)和 500 响应(消息以 An error occurred 开头)。探测只测试了 TCS,这两种响应都没有出现。请在客户端检查 HTTP 状态码,并把 404 理解为该标识符没有目标价数据,而不是传输故障。

这是投资建议或实时行情吗?

不是。响应只是分析师共识的信息性快照,文档也没有说明刷新频率。可以把它用于看板、研究笔记和机器人,但不要把它当作投资建议,也不要当作持牌的逐笔行情数据源。

同一家公司的 EPS 和其他分析师预测在哪里查?

本接口只覆盖目标价和评级共识。每股收益、每股股息和净资产收益率的预测值,以及对应的实际值和修正时间,由目录中的股票预测接口提供;按名称查询股票数据的接口也会返回 analystView 数据块。

相关接口

相关指南

查看订阅方案 →