Get quarterly results, yearly results, balance sheet, cash flow, ratios and shareholding history for an Indian stock by company name
View all Indian Stock Exchange API endpoints →Returns historical financial statistics for one Indian listed company, looked up by company name. stock_name is required (for example TCS, or TATAMOTORS as in the endpoint documentation). stats is optional and names the statistic groups to return; its documented default is the comma-separated list quarter_results, yoy_results, balancesheet, cashflow, ratios, shareholding_pattern_quarterly and shareholding_pattern_yearly, while the documentation's example request uses a single value, quarter_results. No probe call was made for this endpoint, so every response detail below comes from an unverified source example: a JSON object keyed by line item (Sales, Expenses, Operating Profit, OPM %, Other Income, Interest, Depreciation, Profit before tax, Tax %, Net Profit and EPS in Rs), where each item maps period labels such as Jun 2021, Sep 2021 and Mar 2024 to numbers. That example holds 13 quarterly periods per line item and resembles the quarter_results group; the labels appear in alphabetical rather than chronological order, and no currency units are stated beyond the EPS in Rs and percentage labels. The response layouts of the other six groups, how several groups are combined in one response and the behavior for an unknown company name are not verified. The figures are informational and not audited filings or investment advice.
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/historical-stats API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/historical-stats?key=<API_KEY>&stats=quarter_results%2Cyoy_results%2Cbalancesheet%2Ccashflow%2Cratios%2Cshareholding_pattern_quarterly%2Cshareholding_pattern_yearly&stock_name=TCS'
Query Result
Use Cases
- An earnings-season dashboard that compares each quarter with the same quarter a year earlier for every company on a watchlist.
- A revenue-growth screener that loops a list of company names and ranks them by the change in trailing quarterly Sales.
- A prompt-context builder that hands an LLM the quarterly results table instead of a scraped web page.
- A shareholding-trend chart for promoter and institutional holding, built from the shareholding_pattern groups where they return data.
- A spreadsheet or n8n workflow that refreshes a margin and EPS table for each company after a results announcement.
Frequently asked questions
What does the Historical Stats endpoint return?
A JSON object of financial statistics for the requested company. In the supplied source example (not a probe) each key is a line item such as Sales, Expenses, Operating Profit, OPM %, Net Profit or EPS in Rs, and each value maps period labels like Jun 2021 to a number. That example shows 13 quarters and resembles the quarter_results group.
What does the stats parameter accept?
A comma-separated list of group names: quarter_results, yoy_results, balancesheet, cashflow, ratios, shareholding_pattern_quarterly and shareholding_pattern_yearly. The documented default requests all seven, and the documentation's example request passes only quarter_results.
Is stats required or optional?
The written endpoint notes call stats required, but the declared parameter is optional with a default of all seven groups. stock_name is the only parameter that is always required. Sending stats explicitly keeps the response predictable.
Has this endpoint been tested with a live call?
No probe call was made for Historical Stats. The response description comes from a source example, so the layouts of yoy_results, balancesheet, cashflow, ratios and the shareholding groups, and the shape of a multi-group response, are unverified.
In what order do the period columns come back?
In the source example the period labels appear alphabetically (Dec 2021, Dec 2022, Dec 2023, Jun 2021 and so on), not chronologically. Parse each label into a date and sort in your own code before charting or comparing quarters.
Which units do the figures use?
The example does not state units except for the EPS in Rs label and the OPM % and Tax % percentage rows. Check the monetary scale against the company's own filings before using the numbers in a model.
Do I need an NSE ticker or BSE scrip code?
stock_name is described as a company name, and the examples use TCS and TATAMOTORS. How the lookup treats partial or misspelled names is unverified, so resolve ambiguous names first with the Industry Search endpoint, which returns NSE and BSE codes.