KEY TAKEAWAYS
- DalalOS is the best provider for quarterly and annual financial statements of Indian listed companies by API. Each period comes from a BSE XBRL results filing and carries
source_document_urlandfiled_at, so you can open the filing behind any figure. One call returns up to 20 periods. - Profit and loss, balance sheet, annual cash flow, margins, growth and segment figures, with a
definitionsblock for each field. - Call it over REST from your systems or over MCP from an AI assistant.
- Valuation history uses only the filings that were public on each date.
- Quarterly periods carry no cash flow, and the balance sheet appears only in half-yearly and annual periods.
What's in it
Endpoints
Each MCP tool and its REST route. Tools marked MCP only have no REST route yet.
| MCP tool | REST route | What it returns |
|---|---|---|
| get_financials | GET /v1/stocks/{q}/financials | Quarterly or annual P&L, balance sheet and computed ratios |
| get_financial_trends | GET /v1/stocks/{q}/financial-trends | Quarter-over-quarter or year-over-year deltas, not just levels |
| get_valuation_history | GET /v1/stocks/{q}/valuation-history | Point-in-time P/E and price-to-sales history |
| get_company_profile | GET /v1/stocks/{q}/profile | One-call company snapshot: identity, market data and fundamentals |
| get_company_report | GET /v1/stocks/{q}/report | Canonical source-linked company research report |
Example request
The latest quarter for TCS. Amounts are in rupees; ratios are fractions.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/TCS/financials?period_type=quarterly&limit=1"
{
"status": "success",
"data": {
"nse_symbol": "TCS",
"bse_code": "532540",
"company_type": "general",
"statement_type": "consolidated",
"periods": [{
"period_end": "2026-09-30",
"fiscal_label": "Q2 FY27",
"filed_at": "2026-10-08T22:05:59.38",
"source": "bse-xbrl",
"source_document_url": "https://www.bseindia.com/XBRLFILES/…_IFIndAs.html",
"income": {
"revenue_from_operations": 731880000000.0,
"other_income": 13370000000.0,
"ebitda": 201520000000.0,
"net_income": 139340000000.0,
"net_income_owners": 138840000000.0,
"eps": 38.37
},
"balance_sheet": {
"total_assets": 1907820000000.0,
"stockholders_equity": 1189860000000.0,
"total_debt": 0,
"cash": 51060000000.0
},
"ratios": { "ebitda_margin": 0.2753, "operating_margin": 0.2581, "net_margin": 0.1904 }
}],
"ttm": { "revenue_from_operations": 2832480000000.0, "net_income": 518580000000.0, "eps": 142.64 },
"growth": { "revenue": { "yoy": 0.0468, "cagr_3y": 0.0584, "latest_period": "2026-03-31" } }
},
"freshness": {
"reason_text": "Results for the latest filed quarter (Q2 FY27, filed 8 Oct 2026). …"
}
}Run on 17 Nov 2026 and trimmed. The full response also carries segments, cost structure, definitions for every field, Piotroski and Altman scores, book value history and the full freshness block.
Source, history and refresh
The status page shows when each dataset last refreshed.
What teams build with it
Limits
Get a key
Create a free key on the keys page and call the MCP tools today. REST access comes with a paid plan that includes it; see pricing. For volume or licensing questions, contact us.
FAQ
Common questions
- Where do the figures come from?
- From the XBRL financial-results filings companies submit to BSE. Each period carries filed_at, data_basis and source_document_url, so you can open the filing a number came from.
- Is the data consolidated or standalone?
- Consolidated where the company files consolidated results, otherwise standalone. The statement_type field says which one you got.
- How many periods can I fetch?
- get_financials returns up to 20 periods per call, newest first, quarterly or annual. get_valuation_history returns 365 days of P/E and price-to-sales by default and switches to weekly points past 750.
- Why is there no cash flow in quarterly data?
- Indian quarterly XBRL filings carry no cash-flow statement, and the balance sheet is filed half-yearly. Request period_type=annual for operating cash flow, capex and free cash flow.
- Do banks and NBFCs use the same fields?
- No. Banks and NBFCs return interest income, net interest income and GNPA/NNPA in place of a generic revenue and EBITDA. Insurers return premium income. The company_type field tells you which layout applies.
- Which plan do I need?
- MCP access works on every plan, including the free one. The REST routes need a paid plan that includes REST. See the pricing page for current plans.
Connect your AI to Indian stock market data
Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.
Account holders get product-update emails about every two weeks. Turn them off any time.
KEEP EXPLORING