获取印度股票的分析师预测与已公布实际值,可按 EPS 等指标、期间类型、数据类型和数据时效筛选。

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

返回单只印度股票在某一项财务指标上的预测数据。五个查询参数均为必填:stock_id(股票标识符,目录默认值为 TCS,文档示例请求写作 tcs)、measure_code(可选 EPS、CPS、CPX、DPS、EBI、EBT、GPS、GRM、NAV、NDT、NET、PRE、ROA、ROE 或 SAL;文档只标注了 EPS 为每股收益、DPS 为每股股息)、period_type(Annual 或 Interim)、data_type(Actuals 或 Estimates)以及 age(Current、OneWeekAgo、ThirtyDaysAgo、SixtyDaysAgo 或 NinetyDaysAgo)。文档示例请求为 stock_id=tcs、measure_code=EPS、period_type=Annual、data_type=Actuals、age=ThirtyDaysAgo。文档记载的状态码有:200 返回与查询匹配的预测数据,404 表示该 stock_id 或指标代码下没有预测,500 表示意外的处理错误。已保存的示例响应(属于文档示例,本目录尚未对该接口做过实时探测)是一个 JSON 对象,含 measureCode、measureName 和 periods 数组。每个期间包含 ActualReportDate、CalendarMonth、CalendarYear、FiscalPeriod 对象(Type 和 Year)以及 RelativePeriod 对象(Number 和 Type)。在 Actuals 示例中,每个期间带有 Actuals.Actual 列表,其行包含 CurrencyCode(INR)、NumberOfEstimates、Reported、ReportedDate、Restated、RestatedDate、StandardizedUnexpectedEarnings、SurpriseMean、SurprisePercent、Surprise60DayPercent 和 PostReport30DayPriceChangePercent。data_type=Estimates 时的字段布局在现有资料中未展示,尚未得到验证。参数的预填值列出了该参数接受的全部名称,而文档中的请求每个参数只发送一个值。

API 功能

十五个可选指标代码 measure_code 可取 EPS、CPS、CPX、DPS、EBI、EBT、GPS、GRM、NAV、NDT、NET、PRE、ROA、ROE 或 SAL,同一路由即可覆盖每股收益、每股股息等十余项预测指标。
同一路由提供实际值与预期值 data_type 可在 Actuals 与 Estimates 之间切换,针对同一只股票和同一指标,用两次相同的调用就能把分析师预期与公司实际公布值配对。
年度或中期财务期间 period_type 选择 Annual 或 Interim,响应中的每个期间都带有 FiscalPeriod(Type 和 Year)、RelativePeriod(Number 和 Type)、CalendarMonth 与 CalendarYear,便于对齐各行数据。
五档数据时效便于追踪修正 age 支持 Current、OneWeekAgo、ThirtyDaysAgo、SixtyDaysAgo 和 NinetyDaysAgo,可取得同一数据较早时点的读数,从而把 Current 值与 90 天前的值对比。
已公布实际值附带超预期统计 Actuals 示例的行包含 Reported、SurpriseMean、SurprisePercent、StandardizedUnexpectedEarnings 和 NumberOfEstimates,用来说明公布数字与分析师预期相比如何。
每个期间都有披露日期和币种 每个期间带有 ActualReportDate,每条实际值行带有 ReportedDate 和 CurrencyCode(示例中为 INR),披露时间和计价单位一目了然,无需猜测。

在线 API 演示

GET /api/project/indian-stock-exchange-api/stock-forecasts

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/stock-forecasts?key=<API_KEY>&age=Current%2COneWeekAgo%2CThirtyDaysAgo%2CSixtyDaysAgo%2CNinetyDaysAgo&data_type=Actuals%2CEstimates&measure_code=EPS%2CCPS%2CCPX%2CDPS%2CEBI%2CEBT%2CGPS%2CGRM%2CNAV%2CNDT%2CNET%2CPRE%2CROA%2CROE%2CSAL&period_type=Annual%2CInterim&stock_id=TCS'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

各参数可以取哪些值?

measure_code 可取 EPS、CPS、CPX、DPS、EBI、EBT、GPS、GRM、NAV、NDT、NET、PRE、ROA、ROE 和 SAL。period_type 为 Annual 或 Interim,data_type 为 Actuals 或 Estimates,age 为 Current、OneWeekAgo、ThirtyDaysAgo、SixtyDaysAgo 或 NinetyDaysAgo。stock_id 是自由字符串,文档中的示例为 TCS。五个参数均为必填。

为什么表单里预填了一长串逗号分隔的值?

目录的预填值列出了 age、data_type、measure_code 和 period_type 各自接受的全部名称。文档中的示例请求每个参数只发送一个值,例如 EPS、Annual、Actuals 和 ThirtyDaysAgo。现有资料没有说明服务是否接受逗号分隔的列表,且该接口尚未做过实时探测,所以请把预填的列表替换为单个值。

响应长什么样?

已保存的文档示例是一个含 measureCode、measureName 和 periods 数组的对象。每个期间包含 ActualReportDate、CalendarMonth、CalendarYear、FiscalPeriod 和 RelativePeriod,Actuals 示例中还有 Actuals.Actual 列表,含 Reported、NumberOfEstimates、SurpriseMean、SurprisePercent 等字段。这些内容来自示例,而非实时探测。

示例里有 Estimates 数据吗?

没有。现有示例是 EPS 指标的 Actuals 响应。data_type=Estimates 时返回的布局在资料中没有展示,因此在编写依赖具体字段名的解析器之前,请先查看一次真实的 Estimates 响应。

age 的各个取值是什么意思?

文档只把 age 描述为要获取的数据的时效,选项为 Current 以及 1 周、30 天、60 天、90 天前。很自然的理解是同一数据较早时点的读数,可用来比较某个数字的变化,但具体的快照语义并未明确说明。

除 EPS 和 DPS 外,其他指标代码分别代表什么?

文档只标注了 EPS 为每股收益、DPS 为每股股息,其余代码都没有说明,而且在 EPS 示例中 measureName 只是重复了代码本身。依赖某个代码之前,请用你熟悉的股票核对其 measureName 和数值,确认它衡量的是什么。

可能遇到哪些错误?

文档列出:200 表示有匹配的预测数据,404 表示找不到该 stock_id 或指标代码对应的预测,500 表示意外的处理错误。请把 404 当作正常的无数据结果处理,因为并非每只股票都有每一项指标。

这些预测可以用于交易决策吗?

请将其视为用于研究、看板和筛选的资讯性分析师数据。预期值和超预期数据只是可能被修订的快照,在据此行动之前,请对照公司公告或持牌数据源核实重要数字。

相关接口

相关指南

查看订阅方案 →