Indian IPO Tracker — API & MCP server

A fast read API and MCP server for Indian IPO data — mainboard & SME, from DRHP filing to listing. It serves a canonical Postgres store that's kept fresh by the Indian IPO Tracker batch actor, so responses are sub-second instead of a full live scrape.

Covers: SEBI DRHP filings, grey-market premium (GMP), live subscription multiples, lifecycle status, calendar dates (open / close / listing), full issue terms (price band, lot size, min investment, fresh-issue vs OFS), basis-of-allotment + anchor book, listing prices, and parsed prospectus financials (revenue / EBITDA / PAT, use of proceeds, lead managers).

Two ways to call it:

• Run-based (recommended for AI agents via the Apify MCP): call the Actor with an action input (e.g. { "action": "live_upcoming_listed" }); results are written to the run's dataset. This is the zero-setup path for anyone who already has the Apify MCP configured.
• Standby (always-on HTTP): call the REST endpoints directly, or connect to its /mcp server.

Pricing

Pay-per-event. You're charged per successful data request:

Event	When
api-list-request	listing/searching IPOs (GET /api/ipos, MCP list_ipos)
api-detail-request	one IPO + prospectus (GET /api/ipos/:id, MCP get_ipo)
api-timeline-request	subscription/state timeline (MCP get_ipo_timeline)
api-refresh-request	force-refresh an IPO (premium; rate-limited)

Health/meta calls (/healthz, /api/freshness, get_freshness) and 304 Not Modified responses are free.

REST API

Base URL: https://contented-academy--indian-ipo-tracker-api.apify.actor Authenticate with your Apify token (?token=<APIFY_TOKEN> or Authorization: Bearer <APIFY_TOKEN>).

Method & path	Description
GET /api/ipos	List/search IPOs (returns ALL matching rows, no pagination). Query: view (live_upcoming | live_upcoming_listed, default), category (mainboard|sme), q (name search), gmp_min, listing_date_gte, listing_date_lte.
GET /api/ipos/:id	Full record for one IPO incl. prospectus, basis-of-allotment, anchors, and latest GMP.
GET /api/ipos/:id/timeline	Subscription-bidding timeline + lifecycle state history.
POST /api/ipos/:id/refresh	Bump an IPO to the front of the refresh queue (premium, rate-limited).
GET /api/events	Recent lifecycle state-change events (paginated).
GET /api/freshness	Pipeline health snapshot (free).
GET /healthz	Liveness (free).

Responses are cached (60 s) and carry strong ETags — send If-None-Match to get a free 304.

Example

$curl "https://contented-academy--indian-ipo-tracker-api.apify.actor/api/ipos?status=SUBSCRIPTION_OPEN&category=sme&token=$APIFY_TOKEN"

MCP server

Endpoint: /mcp (Streamable HTTP). Discoverable + callable through the Apify hosted MCP at https://mcp.apify.com, or connect directly to the standby URL …/mcp.

Tool	Arguments	Returns
list_ipos	view? (live_upcoming|live_upcoming_listed), category?, q?, gmp_min?, listing_date_gte?, listing_date_lte?	IPO summaries (GMP, subscription, dates, lot size) + count
get_ipo	ipo_id	Full IPO record incl. prospectus financials, basis-of-allotment, anchors, latest GMP
get_ipo_timeline	ipo_id	Subscription timeline + state history
get_freshness	—	Pipeline health snapshot (free)
refresh_ipo	ipo_id	Force-refresh (premium, rate-limited)

Typical agent flow: list_ipos to find an ipo_id, then get_ipo for full detail.

Run-based (call-actor)

If you call the Actor through the Apify MCP's generic call-actor (or the Apify API / Console), pass an action and read the run's dataset:

{ "action": "live_upcoming_listed", "gmp_min": 30 }

action values: live_upcoming, live_upcoming_listed (default), get (needs ipo_id), timeline (needs ipo_id), freshness. List actions return ALL matching IPOs (no pagination), ordered by lifecycle relevance (live → upcoming → listed).

Notes

• Data is sourced from public sources (SEBI, BSE, NSE, GMP aggregators) and parsed prospectus PDFs. Figures are best-effort and should be verified against the official filing before any financial decision.
• Freshness depends on the batch tracker's worker cadence; GET /api/freshness reports the most recent update timestamps.