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
Endpoints
| MCP tool | REST route | What it returns |
|---|---|---|
| get_ipos | GET /v1/ipos | Upcoming 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 -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/ipos?limit=3"
{
"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
Limits
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