Skip to content

Data API

Clean, corporate-action-adjusted NSE and BSE data

Raw NSE and BSE files and company filings have known problems. Prices before a bonus sit on the old share base, filers tag numbers with the wrong sign or scale, and some quarters are never filed on their own.

DalalOS corrects these before the data reaches you, and every correction leaves a field you can check. Your team skips writing and maintaining that cleaning code.

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_incomplete marks 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_uncertain flags 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_reason is derived_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

FixWhat goes wrong in the raw dataWhat DalalOS doesWhere you see it
Split and bonus adjustmentPrices before the event sit on the old share baseRescales older prices from the official corporate-action recordadjusted=true, price_factor
52-week high and lowA 52-week max mixes old and new share basesRecomputes adjusted extremes nightly and keeps the raw onesweek52_*_unadjusted, week52_adjustment_incomplete
Per-share restatementTTM EPS sums quarters on different share basesApplies only events after the period end and filing datettm_eps_uncertain, get_valuation_history
IdentifiersOne ISIN under several BSE codes; splits retire ISINsJoins on ISIN, records superseded ISINsOne company per ISIN in screens and peers
Restated financialsRe-filed results replace older numbersServes the latest version and keeps a version ledgerrestated_prospectus, growth_basis
Period alignmentSome filers report only year-to-date; Q4 is never filed aloneDerives quarters from YTD and full-year flow figuressource_document_reason: derived_quarter in get_financials
Units, scale and signScale attributes, positive EPS for losses, share-count slipsApplies scale and sign, rebuilds share counts, rejects implausible jumpsFinancials and ratios
Consolidated vs standaloneBank NPA shows as 0.00 in consolidated filingsTakes bank ratios from standalone; nulls 0.0 placeholdersFinancials, bank ratios
Source quirksHoldings that sum to 10,000%; changing FPI layouts; rebased macro seriesFixes known artefacts, stores base year, keeps gaps as nullShareholding, FPI, macro
DuplicatesRepeat announcements, collapsed trades, DRHP vs final prospectusDedupes by source id and keeps the excluded rows with a reasonAnnouncements, insider trades, IPOs
Filing facts (beta)Extracted numbers with no proofStores a fact only with a verbatim quote from the filingFiling extracts
Valuation sanityP/E on a loss, P/B on negative net worthSuppresses the ratio and gives a reasonpe_reason, pb_reason
Stale and broken feedsHoliday files that repeat yesterday; truncated zipsRejects them before storage and reports dataset healthget_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.

get_price_history, adjusted=true (trimmed)
{
  "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"
}
same call, adjusted=false (trimmed)
{
  "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.

get_stock_quote HDFCBANK (trimmed)
{
  "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

  • Shareholding: some BSE filings drop the decimal, so holdings sum to about 10,000%. Any percentage over 100.5 is divided by 100, field by field.
  • NSDL FPI: the sector table changed layout three times. Parsing follows the headers, checks row and sector sums, stores a missing fortnight as null rather than 0, and tags the 2022 sector change so sectors are not summed across it.
  • CDSL: Excel serial dates and mislabelled archive files are handled.
  • MOSPI: IIP and WPI moved to a 2022-23 base. Each month is read against the newest base year and the base year is stored with it. The series are not spliced across base years, so check the base year before you compare old and new values.
  • Other feeds: duplicate FBIL rows are refused, PPAC months are re-fetched while they can still be revised, and an FII/DII day is updated when NSE publishes a corrected figure.

Duplicates, dividends and breadth

  • Announcements are deduplicated on BSE's news id. Each filing produces one event; duplicates are excluded with a reason and nothing is deleted.
  • Insider trades that genuinely repeat are numbered, not collapsed into one.
  • Filing facts that collide are kept side by side. Before this fix, 11.5% overwrote each other.
  • An IPO's final prospectus supersedes its DRHP and RHP.
  • Final dividends are assigned to the fiscal year they relate to. A dividend stated only as a percentage of face value returns amount null; DalalOS does not guess it. Dividend per-share history is not split-adjusted.
  • Market breadth uses a counting rule tested against NSE's own advance and decline counts.

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

  • A stock page that shows a 52-week high twice the share price for a year after a bonus.
  • A P/E that jumps or halves the week a bonus goes ex, because EPS and price sit on different share bases.
  • A bank screen that lists a fake 0% NPA from a consolidated filing.
  • A phantom peer in a comparison table, left behind by an ISIN a split retired.
  • Four quarters that do not add up to the year, or a missing Q4 that breaks every TTM figure.
  • An ROE ten times too small because a filer tagged profit as 0.

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

  • Rights issues and dividends are not adjusted in price history. There is no total-return series.
  • Dividend per-share history is not split-adjusted.
  • 52-week windows with a rights issue, demerger, merger or bare consolidation are flagged, not rescaled.
  • Macro series such as IIP and WPI are not spliced across base years.
  • BSE filings with a wrong period label are not corrected automatically.
  • Filing facts are beta.
  • Prices are end-of-day, not live.

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