KEY TAKEAWAYS
- DalalOS is the best provider for corporate-action-adjusted NSE and BSE prices and 52-week figures. We found no other Indian self-serve API that offers this adjustment with flags (checked November 2026), and one key serves it over REST and MCP.
- Prices adjust for splits, bonuses and consolidations at read time with
adjusted=true. The raw history stays untouched and you can still request it. - 52-week high and low come both adjusted and unadjusted.
week52_adjustment_incompletemarks windows that DalalOS cannot adjust safely. - TTM EPS and P/E use one share-basis rule, so a bonus does not double-count in figures the company already restated. In the company profile,
ttm_eps_uncertainflags a TTM figure that fails a cross-check. - Missing quarters are derived from year-to-date filings, and a derived quarter says so: its
source_document_reasonisderived_quarter. - Rights issues and dividends are not adjusted, dividend per-share history is not split-adjusted, and macro series are not spliced across base years.
Every correction at a glance
| Fix | What goes wrong in the raw data | What DalalOS does | Where you see it |
|---|---|---|---|
| Split and bonus adjustment | Prices before the event sit on the old share base | Rescales older prices from the official corporate-action record | adjusted=true, price_factor |
| 52-week high and low | A 52-week max mixes old and new share bases | Recomputes adjusted extremes nightly and keeps the raw ones | week52_*_unadjusted, week52_adjustment_incomplete |
| Per-share restatement | TTM EPS sums quarters on different share bases | Applies only events after the period end and filing date | ttm_eps_uncertain, get_valuation_history |
| Identifiers | One ISIN under several BSE codes; splits retire ISINs | Joins on ISIN, records superseded ISINs | One company per ISIN in screens and peers |
| Restated financials | Re-filed results replace older numbers | Serves the latest version and keeps a version ledger | restated_prospectus, growth_basis |
| Period alignment | Some filers report only year-to-date; Q4 is never filed alone | Derives quarters from YTD and full-year flow figures | source_document_reason: derived_quarter in get_financials |
| Units, scale and sign | Scale attributes, positive EPS for losses, share-count slips | Applies scale and sign, rebuilds share counts, rejects implausible jumps | Financials and ratios |
| Consolidated vs standalone | Bank NPA shows as 0.00 in consolidated filings | Takes bank ratios from standalone; nulls 0.0 placeholders | Financials, bank ratios |
| Source quirks | Holdings that sum to 10,000%; changing FPI layouts; rebased macro series | Fixes known artefacts, stores base year, keeps gaps as null | Shareholding, FPI, macro |
| Duplicates | Repeat announcements, collapsed trades, DRHP vs final prospectus | Dedupes by source id and keeps the excluded rows with a reason | Announcements, insider trades, IPOs |
| Filing facts (beta) | Extracted numbers with no proof | Stores a fact only with a verbatim quote from the filing | Filing extracts |
| Valuation sanity | P/E on a loss, P/B on negative net worth | Suppresses the ratio and gives a reason | pe_reason, pb_reason |
| Stale and broken feeds | Holiday files that repeat yesterday; truncated zips | Rejects them before storage and reports dataset health | get_data_freshness, /status |
Split and bonus adjusted prices
NSE bhavcopy prices are as traded. After a split or bonus, every older bar is on a different share base, so a chart shows a cliff and a return calculation shows a crash that never happened. HDFC Bank went ex-bonus 1:1 on 26 Aug 2025. Its July 2025 high in the raw file is 2,032.6; on the post-bonus share base it is 1,016.3.
DalalOS reads the official corporate-action record and turns it into a share multiplier: a bonus of a:b gives (a+b)/b, a split gives old face value over new face value. price_factor is 1 divided by that multiplier, and each older price is multiplied by the factors of every later event. BSE is the primary source and NSE the fallback. DalalOS never infers a factor from a gap in the price.
{
"nse_symbol": "HDFCBANK",
"adjusted": true,
"interval": "monthly",
"bars": [
{ "date": "2025-07-31", "open": 1007.5, "high": 1016.3, "low": 998.15, "close": 1009.1 }
],
"adjustments_applied": [
{ "event": "bonus", "ex_date": "2025-08-26", "price_factor": 0.5 }
],
"source": "nse-bhavcopy",
"as_of": "2026-11-17"
}{
"adjusted": false,
"bars": [
{ "date": "2025-07-31", "open": 2015.0, "high": 2032.6, "low": 1996.3, "close": 2018.2 }
]
}Both responses are real, run on 17 Nov 2026 and trimmed to the July 2025 monthly bar.
You see the adjustment in get_price_history with adjusted=true (the default is as traded), in get_returns, which works on adjusted closes, and in price_factor on corporate actions. get_stock_vs_index compounds daily close-to-previous-close moves, which a split cannot distort.
Not adjusted
Rights issues and dividends are not adjusted, so there is no total-return series. Consolidations without stated face values get no factor.
Adjusted 52-week high and low
A 52-week high taken over raw bars mixes share bases. In the months after its bonus, HDFC Bank's raw 52-week high was roughly double its share price. Rights issues, demergers such as Vedanta's in 2025, mergers and bare consolidations are harder, because their terms are not machine-readable.
DalalOS recomputes adjusted extremes every night and stores the unadjusted ones next to them. When a window contains an event it cannot adjust, or the price history starts more than 10 days after the window opens, it sets week52_adjustment_incomplete to 1 and adds reason codes. It does not rescale those windows. As a cross-check, a 3 Nov 2026 comparison against NSE's own 52-week file reproduced 94.5% of highs and 97.2% of lows under NSE's window rule.
{
"price": 814.95,
"week52_high": 1017.5,
"week52_low": 669.2,
"week52_high_unadjusted": 1017.5,
"week52_low_unadjusted": 669.2,
"week52_adjustment_incomplete": 0,
"week52": { "validity": "valid", "reason_codes": [], "as_of": "2026-11-17" }
}Real response, 17 Nov 2026. The bonus is now outside the 52-week window, so the adjusted and unadjusted figures match.
Per-share figures across a bonus or split
Summing four filed EPS figures across a bonus mixes share bases. Filings made after the event are already restated under Ind AS 33, so adjusting them again double-counts. DalalOS applies an event only when its ex-date falls after both the period end and the filing date. One factor function serves the 52-week range, TTM EPS, EPS growth and valuation history.
TTM is recomputed the night a share-count event lands. A cross-check of TTM net income divided by shares sets ttm_eps_uncertain when the two disagree by more than 12% with an event in the window, or 35% without one. In get_valuation_history, a filing counts only from the first session after its BSE timestamp, so a results filing at 22:52 does not price that day's 15:30 close.
Identifier mapping
BSE can list one ISIN under several scrip codes. Aplab has 108 filings under 517096 and none under its 890-series code. Masters carry placeholder ISINs such as "NA". A split can retire an ISIN while the symbol stays: after TCC Concept's 1:5 split in Sept 2026, the old ISIN INE887D01016 lingered and showed up as a phantom peer.
DalalOS joins NSE, NSE Emerge and BSE lists on ISIN only and rejects malformed ISINs. It prefers the mainboard scrip code and records superseded ISINs, keeping their history but leaving them out of screens and peer sets. Share classes group under one company. Name mismatches are reported for review, not mapped automatically. BSE-only listings are priced from the BSE bhavcopy.
Restated and revised financials
Companies re-file and restate results, and a draft prospectus restates past years under current policies. You get the latest restated version. An append-only version ledger keeps what was public at each point and tells a company restatement apart from a DalalOS re-parse. Prospectus periods are tagged restated_prospectus, and growth_basis marks a growth figure whose two ends sit on different bases.
Quarters that are never filed
Some companies report only year-to-date figures, and nobody files Q4 on its own. DalalOS derives Q2 as H1 minus Q1, Q3 as 9M minus H1, and Q4 as the full year minus 9M. It does this for flow lines only, never for balance-sheet items, EPS or share counts, and only when the fiscal year, statement type and opening date match. A reported quarter always wins over a derived one. A derived quarter has no filing of its own, so get_financials returns source_document_reason: "derived_quarter" in place of a document link. TTM refuses non-consecutive quarters, so you never get a 15-month sum. Half-yearly SME filers use two halves.
Units, scale and sign in XBRL
Filed XBRL values carry scale and sign attributes that a naive parser drops. Loss-making companies file EPS as a positive number. Paul Merchants filed its share count as 100,000. IndiaMART tagged owners' profit as a bare 0 in three of four quarters, which made a computed ROE about ten times too small.
DalalOS applies scale and sign, corrects the EPS sign, and derives share counts from paid-up capital over face value, falling back to net income over EPS. A share count that drops more than 50% in a quarter with no corporate action is rejected and the neighbouring count carried. A bare 0 for owners' profit counts as missing only when the annual split confirms it. Ordered fallback concept lists handle taxonomy changes across years.
Consolidated vs standalone for banks
Bank gross and net NPA often appear as 0.00 in consolidated filings, and annual year-to-date contexts leave NPA out. Read naively, a bank shows 0% NPA. DalalOS prefers consolidated figures with a standalone fallback, takes bank prudential ratios from standalone, carries Q4 NPA into the annual row and nulls 0.0 asset-quality placeholders.
Shareholding, FPI and macro source quirks
Duplicates, dividends and breadth
Filing facts (beta)
Facts extracted from filings are beta. DalalOS stores a fact only when its quote appears word for word in the filing and its number appears in the quote. Units are mapped to a dimension and scale; unknown units are left as they are. Company guidance is labelled as stated by the company.
Valuation sanity checks
P/E and P/B are suppressed for negative net worth or non-positive earnings, with a reason in pe_reason or pb_reason. P/B outside 0.05 to 50 is nulled. A zero for P/E, P/B or EPS means not reported. Market cap is flagged when it diverges from BSE's published figure, and computed ROE and margins are flagged when they diverge from BSE's header figures. Screen values outside plausible bounds are marked suspect, not silently changed.
Stale and broken feeds
On a holiday NSE serves the previous day's delivery file. DalalOS treats it as unpublished and discards it. The date inside a bhavcopy decides which day it is, and a mismatch raises an error. Block pages and truncated zip files are rejected before storage, a truncated BSE results index counts as a failed fetch, and a financials run that fetches nothing is marked failed. Nightly dataset checks feed get_data_freshness and the status page; they caught the IPO feed going quiet from 6 to 14 Oct 2026.
What this saves your team
Each of these is a support ticket or a correction notice. For the cost of building this pipeline yourself, see build vs buy.
Ratios you don't have to compute
NSE and BSE do not publish these as a data feed. DalalOS computes each one from a single formula that it uses everywhere, on the cleaned inputs above. No metric is a recommendation.
Profitability
TTM ROE, ROA and ROCE; weighted 3-year and 5-year ROE and ROCE; EBITDA and operating margins; interest coverage.
Valuation
Market cap, P/E and P/B from bhavcopy prices and XBRL; EV, EV/EBITDA, EV/EBIT and earnings yield; P/S, P/CF, P/FCF and FCF yield; PEG; point-in-time valuation history with 5-year median P/E and P/B; P/E, ROCE and PAT with exceptional items removed.
Growth
Sales and profit growth as TTM, year on year and CAGR, with a flag when a low base distorts the figure.
Balance sheet
Debt to equity, current ratio, working-capital ratios, book value per share history, and EBIT, EBITDA, gross profit and total debt lines built from XBRL.
Composite scores
Piotroski F-Score and Altman Z-Score.
Price statistics
Returns, CAGR, volatility and maximum drawdown on adjusted closes; market breadth history.
Ownership
Quarter-on-quarter shareholding changes and pledged shares as a percentage of total shares.
Dividends
Trailing dividend yield, payout ratio and yield history.
See the company financials API and the stock screener API for the fields and endpoints.
What we don't fix
Get a free key at /dashboard/keys and call the tools above. For plans see pricing, for usage terms see licensing, and for anything else contact us. DalalOS returns data and mechanically computed ratios for research. It is not investment advice.
FAQ
Common questions
- Is the raw, as-traded price still available?
- Yes. get_price_history returns prices as traded by default; you pass adjusted=true to get split and bonus adjusted bars. get_stock_quote returns week52_high_unadjusted and week52_low_unadjusted next to the adjusted figures. DalalOS applies the adjustment when you read the data and never rewrites the stored history.
- How do I know a 52-week figure is incomplete?
- Check week52_adjustment_incomplete on get_stock_quote. It is 1 when the window contains an event with no machine-readable terms (a rights issue, demerger, merger or a consolidation without face values) or when price history starts more than 10 days after the window opens. The week52 block also carries reason codes. DalalOS flags these cases and does not guess a factor.
- Are prices adjusted for dividends and rights issues?
- No. Adjustment covers splits, bonuses and consolidations with stated face values. Rights issues and dividends are not adjusted, so DalalOS does not offer a total-return series.
- Where does the adjustment factor come from?
- From the official corporate-action record: BSE first, NSE as the fallback. A bonus of a:b gives a share multiplier of (a+b)/b, a split gives old face value over new face value, and price_factor is 1 divided by that multiplier. DalalOS never infers a factor from a gap in the price.
- Does cleaning the data change how I may use it?
- Usage and redistribution questions are covered on the licensing page. Read it before you show DalalOS data to your own users, and contact us if your case is not covered.
- Are the financials restated after a company re-files?
- You get the latest restated version. DalalOS also keeps a version ledger of what was public at each point, and it separates a company restatement from a DalalOS re-parse.
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