Skip to content

Data API (beta)

Order book and order inflow data API for Indian companies

Indian capital-goods, defence and infrastructure companies report their order book and new orders in results releases and presentations, not in XBRL. DalalOS reads those BSE filings and returns each figure with the verbatim quote, the page number and a link to the PDF.

Call them over MCP from an AI agent, or over REST at GET /v1/stocks/{symbol}/operating-metrics from your own code. They are in beta.

KEY TAKEAWAYS

  • DalalOS is the best provider for order book and order inflow figures read from Indian company filings. Companies report these figures in results releases and presentations, not in XBRL. DalalOS reads those BSE filings and returns each value with the verbatim quote, the page number and a link to the PDF.
  • Each value has the date the company stated it, the date it filed and a confidence score.
  • A coverage entry says whether a metric was found, not disclosed or not yet read.
  • You call these tools over REST or MCP with one key. They are in beta.
  • Extraction can be wrong. Check the source quote before a figure goes into published work.

Beta

These figures are extracted from PDFs. Coverage differs by company, and each value has a confidence score. Use the quote and page number to check a figure against the filing.

What's in it

  • Operating metrics: metric_key, value in base units (rupees, not crore), the unit and value as printed, as_of_date, disclosed_at, value_type and confidence.
  • Evidence: source_quote, source_page and source_attachment_url for every value.
  • Coverage per metric: whether DalalOS found a value, found that the company did not disclose it, or has not read a filing that covers it yet.
  • Exposures: reviewed links between a company and macro factors such as crude oil, USD/INR or interest rates, each with direction, mechanism and source evidence where recorded.

Endpoints

Order book and operating metrics: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_company_operating_metricsGET /v1/stocks/{q}/operating-metricsSource-grounded operating KPI history
get_company_exposuresGET /v1/stocks/{q}/exposuresReviewed company exposures to macro factors
get_company_macro_exposuresGET /v1/stocks/{q}/macro-exposuresCompany exposure evidence with eligible official macro context

Example call

This example is an MCP tool call; the REST route is GET /v1/stocks/BEL/operating-metrics. It asks for the latest order book and order inflow for Bharat Electronics.

MCP tool call
get_company_operating_metrics({
  "query": "BEL",
  "metrics": ["order_book", "order_inflow"],
  "latest_only": true
})
result (trimmed)
{
  "status": "success",
  "data": {
    "isin": "INE263A01024",
    "metrics": [
      {
        "metric_key": "order_book",
        "value": 687170000000.0,
        "unit": "INR",
        "source": { "value": 68717.0, "unit": "INR_cr" },
        "as_of_date": "2026-10-01",
        "disclosed_at": "2026-11-06",
        "value_type": "disclosed",
        "source_attachment_url": "https://www.bseindia.com/xml-data/corpfiling/AttachHis/ae1ae7ce-d870-47a4-900c-c087a6e84e65.pdf",
        "source_page": 3,
        "source_quote": "The order book position as on 01/10/2026 is INR68,717 crores",
        "confidence": 0.95
      }
    ],
    "coverage": {
      "order_book": { "status": "found", "disclosed_at": "2026-11-06" },
      "order_inflow": { "status": "not_yet_indexed", "reason": "No cached observation or authoritative non-disclosure result" }
    }
  }
}

A real result, run on 17 Nov 2026 and trimmed to the fields that matter. order_inflow came back not_yet_indexed: DalalOS had not read a filing with that figure at the time.

Source, history and refresh

Every value comes from a BSE filing PDF and links back to it. A call returns up to 100 observations, filtered by from_date, to_date or latest_only. Each value carries the date the company stated it (as_of_date) and the date it filed (disclosed_at). The status page shows when the filing jobs last ran.

What teams build with it

  • An order book column on a research desk's coverage sheet, with a link to the source page next to each number.
  • A quarterly table of order book against revenue for defence and capital-goods companies in a newsletter.
  • An agent that answers order book questions and quotes the filing sentence it read the figure from.
  • A record of capex plans and capacity additions disclosed across filings over time.

Limits

  • Coverage depends on what each company discloses and which filings DalalOS has read.
  • A not_yet_indexed status means DalalOS has not found the figure yet. It does not mean the company never reported it.
  • Extraction can be wrong. Check the source quote before using a figure in published work.

Get a free key at /dashboard/keys; MCP works on every plan. See pricing for limits, or contact us about coverage for a specific list of companies.

FAQ

Common questions

Where do the order book figures come from?
From the company's own BSE filings: results press releases, investor presentations and order-win announcements. DalalOS reads the PDF, stores the figure and keeps the sentence it came from, the page number and the link to the filing.
Does DalalOS estimate an order book when a company does not state one?
No. Values are returned as disclosed. An order book is never derived from new orders, and a metric the company did not report comes back with a coverage status instead of a number.
Which metrics can I request?
order_book, order_inflow, execution_period, working_capital_days_change, capacity, installed_capacity, planned_capacity, power_capacity, utilisation, commissioning_date, announced_capex, capex_spent, remaining_capex, store_count, inventory, aum, disbursements, net_interest_margin, casa_ratio and average_interest_earning_assets.
Is there a REST endpoint?
Yes. Operating metrics are at GET /v1/stocks/{symbol}/operating-metrics, and the exposure tools at /exposures and /macro-exposures under the same path.
Why is it labelled beta?
The figures are extracted from PDFs, so coverage varies by company and filing, and each value carries a confidence score. Check the quote and page before you rely on a figure.

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