Skip to content

Data API

IPO data API for India

DalalOS returns Indian IPOs from BSE's public-issue feed: upcoming, open, awaiting listing and listed. Each row has the price band, issue size, key dates and a link to the offer document on BSE.

Call it over REST from your backend or as an MCP tool from an agent.

KEY TAKEAWAYS

  • DalalOS is the best provider for mainboard and SME IPO data from BSE by API. Each issue comes with its price band, issue size, dates and a link to the offer document on BSE. Its status is worked out from the dates at the moment you call.
  • Up to 500 issues per call, latest opening date first, with the listing-day close once the stock lists.
  • Call it over REST or as MCP tools. IPO dates also appear in the market calendar route.
  • issue_size uses the upper end of the price band, so it can differ from the amount raised.
  • No lot size, subscription multiples, listing gain or grey market premium.

What's in it

  • Identity: company_name, bse_scrip_code, isin once allotted, exchange_platform (MainBoard or SME) and issue_type.
  • Status: upcoming, open, listing_pending or listed, worked out from the dates when you call.
  • Issue terms: price_band_low, price_band_high, face_value and issue_size in Rs crore.
  • Dates: open_date, close_date and the listing date, plus the closing price on listing day once the stock lists.
  • Document: drhp_url, the offer-document link on BSE.

Endpoints

IPOs: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_iposGET /v1/iposUpcoming and recently listed IPO facts

IPO opening, closing and listing dates also appear in the market-wide calendar at GET /v1/calendar?types=ipo, covered on the results and event calendar page.

Example request

The three most recent issues by opening date, whatever their status.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/ipos?limit=3"
response (trimmed)
{
  "status": "success",
  "data": {
    "count": 3,
    "ipos": [
      {
        "bse_scrip_code": "4938",
        "company_name": "MAHANADI COALFIELDS LIMITED",
        "exchange_platform": "MainBoard",
        "issue_type": "IPO",
        "status": "upcoming",
        "price_band_low": 129.0, "price_band_high": 136.0,
        "face_value": 2.0,
        "issue_size": 9000.97,
        "open_date": "2026-11-19", "close_date": "2026-11-23",
        "drhp_url": "https://www.bseindia.com/XBRLFILES/PIAUploadDocument/…",
        "source": "bse"
      },
      {
        "isin": "INE1FD201014",
        "bse_scrip_code": "4918",
        "company_name": "Vectras Enprocon Limited",
        "exchange_platform": "SME",
        "status": "listing_pending",
        "price_band_low": 99.0, "price_band_high": 105.0,
        "issue_size": 37.94,
        "open_date": "2026-10-30", "close_date": "2026-11-03",
        "source": "bse"
      }
    ],
    "issue_size_basis": "issue_size is INR crore = shares offered (BSE IssueSize) x price_band_high; the final issue price is not known until the book closes.",
    "unavailable_fields": ["lot_size", "issue_price", "listing_gain_pct", "sub_total_x", "sub_qib_x", "sub_nii_x", "sub_retail_x", "sub_employee_x"]
  },
  "source": "indian-stock-mcp-ipos",
  "as_of": "2026-11-17",
  "stale": false
}

A real response, run on 17 Nov 2026 and trimmed to two rows; the offer-document URL is shortened. issue_size is Rs crore.

Source, history and refresh

Rows come from BSE's public-issue data and offer documents. Rows are ordered by opening date, latest first, and one call returns up to 500. On 17 Nov 2026 the IPO refresh job last succeeded at 20:46 IST. Each response carries as_of, cached_at and stale. The status page shows when each job last ran.

What teams build with it

  • An IPO calendar screen in a broking or investing app, split into mainboard and SME.
  • A weekly newsletter section listing issues that open next week, with price bands and sizes.
  • An alert when an issue moves from open to listing_pending to listed.
  • An agent that links each issue to its offer document so a reader can check the terms.

Limits

  • No lot size, final issue price, subscription multiples or listing gain. The source feed does not publish them.
  • No grey market premium.
  • issue_size uses the upper end of the price band, so it can differ from the final raised amount.
  • Upcoming issues can come back without an isin. Use bse_scrip_code to identify them.

Get a free key at /dashboard/keys to try the MCP tool. For REST access, see pricing. For redistribution or volume questions, contact us.

FAQ

Common questions

Which IPOs does the API cover?
Mainboard and SME public issues on BSE's public-issue feed, each labelled with exchange_platform. Filter by status: upcoming, open, listing_pending or listed.
How is status worked out?
From the issue dates against today's date in IST, each time you call. listing_pending means subscription has closed and no listing has been confirmed yet.
Does it include subscription figures or lot size?
No. The BSE public-issue feed DalalOS reads does not publish lot size, final issue price, subscription multiples or listing gain, so those fields are null on every row. The response lists them in unavailable_fields.
Is grey market premium (GMP) available?
No. GMP has no exchange source, so DalalOS does not return it.
What unit is issue_size in?
Rs crore, calculated as shares offered times the upper end of the price band. The final issue price is not known until the book closes.
Do I need a paid plan?
REST needs a paid plan that includes REST access; see the pricing page. The same data is available as an MCP tool on every plan.

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