获取单只印度股票的分析师目标价与买入至卖出评级共识,附带一周至 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在自选股列表里加一列平均目标价,再用另一个接口取得的最新报价去除,算出隐含上涨空间的百分比。
- 搭建评级漂移追踪器,把当前 Mean 评级与 OneWeekAgo、ThirtyDaysAgo 快照对比,标出分析师情绪正在好转或转弱的股票。
- 当持仓股票的共识 Mean 从跑赢大盘区间滑向持有区间时发送提醒,通过保存上一次读数来识别这次跨档。
- 在发布前核对 AI 撰写的投资笔记,把其中声称的分析师观点与 NumberOfRecommendations、Statistics 和 Mean 进行比对。
- 用 StandardDeviation 除以 Mean 衡量目标价离散度并给股票排序,找出分析师对合理估值分歧最大的公司。
常见问题
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 数据块。