Skip to content

Reference

Data sources and freshness

A market-data answer is useful when you can tell where it came from and how old it is. DalalOS is built around that: market-data tools read a maintained cache filled from official and public Indian-market sources, and each response exposes provenance and freshness rather than hiding cache age behind a single number.

AI clients, developers and researchers can use this page as the reference for reading the source and freshness fields of a DalalOS response.

KEY TAKEAWAYS

  • Stock prices and quote-style market data are end-of-day. There are no live ticks.
  • Company financials and disclosures come from exchange and public filings. DalalOS generates no estimates.
  • Tool responses expose provenance and cache-age signals, so a client can show or hold back stale data.
  • Read paths do not scrape upstream on demand. A response labels missing coverage and does not infer it.

Primary source families

Source familyWhat DalalOS uses it for
NSE archivesEnd-of-day prices, traded-market fields, index and exchange datasets where the NSE publishes an official archive or file.
BSE official interfacesSecurity-master and exchange-published company, filing, corporate-action and disclosure data used by the relevant DalalOS domains.
BSE-XBRL / SEBI-mandated filingsReported company financial statements and filing-derived line items used for financials and mechanically-computed ratios.
Official public-sector datasetsMacro and reference datasets exposed by DalalOS use the named official publisher for that domain, rather than a third-party market-data vendor.

Freshness is domain-specific

No single label such as “real-time” fits every market-data domain. End-of-day prices refresh after the exchange publishes a session. Company filings and corporate events arrive when the exchange publishes them. Ownership and other periodic disclosures update on their reporting cadence. Use the freshness metadata returned with the domain you request, and do not assume every field shares one timestamp.

How to read a DalalOS response

  • source identifies the response provenance or the DalalOS data contract that assembled it.
  • cached_at records when the relevant cached result was produced or refreshed.
  • stale tells the caller when cached data has exceeded the freshness policy for that domain.
  • coverage notes / reason codes distinguish missing, not-applicable or incomplete coverage from a valid zero.

To check freshness itself, use the get_data_freshness MCP tool. It reports the most recent successful refresh by data domain and the cache-health state a client should consider before relying on a figure.

What happens when upstream data is unavailable

The MCP read path does not fetch or scrape an exchange website during your tool call. A scheduled ingestion job collects upstream data, and tools read the maintained cache. A transient upstream problem therefore does not turn a research question into an unbounded live scrape. Depending on the domain, the response can return cached data marked stale, a no-data/not-found state, or a coverage note that says what is missing.

What DalalOS is not

  • Not a real-time tick or order-book feed.
  • Not a broker or order-routing service; market-data tools do not place trades.
  • Not an investment-advice or target-price engine.
  • Not a source of invented values when an exchange or filing does not disclose the requested fact.

Practical prompt pattern

Ask your AI client to include provenance whenever recency matters: “Use DalalOS to fetch the latest available quote and financial context for RELIANCE. Name the tools used, show the source, cached/freshness date and any stale or coverage warning. Do not substitute web search for a missing DalalOS value.”

FAQ

Common questions

Where does DalalOS get Indian stock-market data?
DalalOS uses official and public sources, including NSE archives for end-of-day market data, BSE official data interfaces and exchange filings, and SEBI-mandated BSE-XBRL filings for company financials. Some macro and reference-rate datasets come from the official Indian public-sector publisher of each dataset.
Is DalalOS real-time?
No. DalalOS is a research data layer with no live tick feed. Stock prices and quote-style market data are end-of-day, while filings, ownership, events and other domains update on their own scheduled or publication-driven cadence.
How can an AI assistant tell whether a DalalOS result is fresh?
DalalOS responses carry provenance and cache-freshness metadata. Check the returned source, cached_at timestamp and stale status. Call get_data_freshness for an overall view of cache health by data domain.
What happens when current data is unavailable?
DalalOS reads from its cache and does not scrape upstream during a tool call. A tool may return cached data marked stale, a no-data/not-found state, or a coverage note. It does not invent a value.

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.

KEEP EXPLORING