Get Indian stock analyst estimates and reported actuals for one measure such as EPS, filtered by period type, data type and data age.
View all Indian Stock Exchange API endpoints →Returns forecast data for one Indian stock and one financial measure. All five query parameters are required: stock_id (the stock identifier; the catalog default is TCS and the documented sample request writes it as tcs), measure_code (one of EPS, CPS, CPX, DPS, EBI, EBT, GPS, GRM, NAV, NDT, NET, PRE, ROA, ROE or SAL; the documentation labels only EPS as earnings per share and DPS as dividends per share), period_type (Annual or Interim), data_type (Actuals or Estimates) and age (Current, OneWeekAgo, ThirtyDaysAgo, SixtyDaysAgo or NinetyDaysAgo). The documented sample request is stock_id=tcs, measure_code=EPS, period_type=Annual, data_type=Actuals, age=ThirtyDaysAgo. Documented statuses are 200 with forecast data matching the query, 404 when no forecasts exist for the stock_id or measure code, and 500 for an unexpected processing error. The stored sample response (a documentation example; this endpoint has not been probed live in this catalog) is a JSON object with measureCode, measureName and a periods array. Each period has ActualReportDate, CalendarMonth, CalendarYear, a FiscalPeriod object (Type and Year) and a RelativePeriod object (Number and Type). In the Actuals sample, each period carries an Actuals.Actual list whose rows include CurrencyCode (INR), NumberOfEstimates, Reported, ReportedDate, Restated, RestatedDate, StandardizedUnexpectedEarnings, SurpriseMean, SurprisePercent, Surprise60DayPercent and PostReport30DayPriceChangePercent. The field layout for data_type=Estimates is not shown in the supplied evidence and is unverified. The prefilled parameter values list every accepted name for that parameter, whereas the documented request sends a single value per parameter.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/indian-stock-exchange-api/stock-forecasts API Response (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'
Query Result
Use Cases
- Track estimate drift by comparing the Current estimate with the NinetyDaysAgo estimate for the same EPS line and flagging stocks whose expectations moved most.
- Build an actual-versus-estimate surprise table by calling the endpoint once with Actuals and once with Estimates for the same stock, measure and period type.
- Add a dividend-per-share outlook to an income screen by requesting the DPS measure for each watchlist stock.
- Rank a watchlist by forecast ROE to give a quality screen a forward-looking input rather than only trailing ratios.
- Chart a company's earnings reporting cadence from ActualReportDate across fiscal periods to prepare an earnings-season calendar.
Frequently asked questions
Which values can each parameter take?
measure_code accepts EPS, CPS, CPX, DPS, EBI, EBT, GPS, GRM, NAV, NDT, NET, PRE, ROA, ROE and SAL. period_type is Annual or Interim, data_type is Actuals or Estimates, and age is Current, OneWeekAgo, ThirtyDaysAgo, SixtyDaysAgo or NinetyDaysAgo. stock_id is a free string whose documented example is TCS. All five parameters are required.
Why does the form prefill a long comma-separated value?
The catalog prefill lists every accepted name for age, data_type, measure_code and period_type. The documented sample request sends one value for each, for example EPS, Annual, Actuals and ThirtyDaysAgo. The evidence does not say whether the service accepts a comma-separated list, and this endpoint has not been probed live, so replace the prefilled lists with single values.
What does the response look like?
The stored documentation sample is an object with measureCode, measureName and a periods array. Each period has ActualReportDate, CalendarMonth, CalendarYear, FiscalPeriod and RelativePeriod, and in the Actuals sample an Actuals.Actual list with Reported, NumberOfEstimates, SurpriseMean, SurprisePercent and related fields. This comes from the sample, not from a live probe.
Does the sample show Estimates data?
No. The supplied sample is an Actuals response for the EPS measure. The layout returned for data_type=Estimates is not shown in the evidence, so inspect a real Estimates response before writing a parser that depends on specific field names.
What do the age values mean?
The documentation describes age only as the age of the data to be retrieved, with the options Current and one week, 30, 60 and 90 days ago. It is natural to read them as earlier readings of the same data for comparing how a figure changed, but the exact snapshot semantics are not spelled out.
What do the measure codes other than EPS and DPS stand for?
The documentation labels only EPS as earnings per share and DPS as dividends per share. The remaining codes are listed without descriptions, and in the EPS sample measureName simply repeats the code. Confirm what a code measures by checking its measureName and values for a stock you know before relying on it.
What errors can I expect?
The documentation lists 200 for matching forecast data, 404 when no forecasts can be found for the stock_id or measure code, and 500 for an unexpected processing error. Handle 404 as a normal no-data outcome, because not every stock is likely to have every measure.
Can I use these forecasts for trading decisions?
Treat them as informational analyst data for research, dashboards and screens. Estimates and surprise figures are snapshots that can be revised, so confirm important numbers with the company filings or a licensed data source before acting on them.