获取印度股票的分析师预测与已公布实际值,可按 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 对同一条 EPS 指标比较 Current 预期与 NinetyDaysAgo 预期,追踪预期漂移,并标出预期变动最大的股票。
- 对同一只股票、指标和期间类型分别以 Actuals 与 Estimates 各调用一次,构建实际值与预期值的超预期对比表。
- 为收益型筛选加入股息展望:对自选列表中的每只股票请求 DPS 指标。
- 按预测 ROE 对自选股票排序,让质量筛选在滞后比率之外多一个前瞻性输入。
- 根据各财务期间的 ActualReportDate 绘制公司财报披露节奏,用于准备财报季日历。
常见问题
各参数可以取哪些值?
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 当作正常的无数据结果处理,因为并非每只股票都有每一项指标。
这些预测可以用于交易决策吗?
请将其视为用于研究、看板和筛选的资讯性分析师数据。预期值和超预期数据只是可能被修订的快照,在据此行动之前,请对照公司公告或持牌数据源核实重要数字。