InvestorGain APIinvestorgain.com ↗
Access live IPO Grey Market Premium data from InvestorGain.com. Filter by badge status, close date, and minimum GMP% across 3 endpoints.
What is the InvestorGain API?
The InvestorGain GMP API exposes live IPO Grey Market Premium data across 3 endpoints, returning fields like gmp_percent, gmp_price, badge, lot_size, ipo_size, and listing performance for every currently tracked IPO. The get_live_gmp endpoint returns the full live table with no filters required, while get_gmp_badge_filtered and get_gmp_by_close_date let you narrow results to open or upcoming IPOs and those with future close dates.
curl -X GET 'https://api.parse.bot/scraper/c1d0143b-268f-4141-8b27-85b4ca0368f8/get_gmp_badge_filtered?min_gmp=0&mainboard_only=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns IPOs with badge 'U' (Upcoming) or 'O' (Open), optionally filtered by minimum GMP percentage and optionally restricted to mainboard IPOs (excluding NSE SME / BSE SME issues), sorted by GMP descending. Each item carries ipo_category, which is 'IPO' for a mainboard issue and 'SME' for an SME-platform issue. One upstream request per call; results are a single page. Returns an empty items array when no IPOs match the filter criteria.
| Param | Type | Description |
|---|---|---|
| min_gmp | number | Minimum GMP percentage to include. Default 0 returns all upcoming/open IPOs. |
| mainboard_only | boolean | When true, only mainboard IPOs (ipo_category 'IPO') are returned and SME-platform IPOs are excluded. When false or omitted, both mainboard and SME IPOs are returned. Values other than true/false are rejected. |
{
"type": "object",
"fields": {
"items": "array of IPO objects with badge U or O, each containing name, gmp_percent (number), badge, ipo_category ('IPO' = mainboard, 'SME' = SME platform), close_date, open_date, price, lot_size, ipo_size_cr"
},
"sample": {
"data": {
"items": [
{
"name": "Manika Plastech",
"badge": "U",
"price": "43",
"lot_size": "348",
"open_date": "2026-09-11",
"close_date": "2026-09-16",
"gmp_percent": 39.53,
"ipo_size_cr": "₹125.50 Cr",
"ipo_category": "IPO"
},
{
"name": "Pranav Constructions",
"badge": "O",
"price": "124",
"lot_size": "120",
"open_date": "2026-09-07",
"close_date": "2026-09-09",
"gmp_percent": 35.48,
"ipo_size_cr": "₹351.03 Cr",
"ipo_category": "IPO"
}
]
},
"status": "success"
}
}About the InvestorGain API
What the API covers
The API surfaces IPO Grey Market Premium data as tracked by InvestorGain.com. Each IPO record includes the GMP percentage (gmp_percent), absolute GMP price (gmp_price), subscription status badge, open and close dates, issue price, lot size, and IPO size. The get_live_gmp endpoint returns all currently tracked IPOs in a single response sorted by GMP percentage descending — no parameters required.
Filtering by badge and close date
get_gmp_badge_filtered targets IPOs with badge values U (Upcoming) or O (Open). The optional min_gmp parameter (a number, default 0) lets you set a GMP percentage floor — useful for surfacing only IPOs trading at a meaningful premium in the grey market. get_gmp_by_close_date applies a similar min_gmp filter but selects IPOs whose close date falls in the future, excluding any records where close_date is absent. Both endpoints return an empty array when nothing matches the specified criteria.
Response fields and behavior
All three endpoints return arrays of IPO objects. The full field set — name, gmp_percent, gmp_price, badge, status, close_date, open_date, price, lot_size, ipo_size — is present on get_live_gmp results. The filtered endpoints expose the same core fields minus gmp_price and status, which are only returned by get_live_gmp. Results across all endpoints are sorted by gmp_percent descending. There is no pagination; each call returns all matching rows as a single list.
The InvestorGain API is a managed, monitored endpoint for investorgain.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when investorgain.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official investorgain.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen upcoming and open IPOs by a minimum GMP percentage before committing to subscription
- Build a dashboard showing all live IPOs ranked by grey market premium using gmp_percent and gmp_price
- Alert on IPOs closing within a specified window by polling get_gmp_by_close_date and checking close_date
- Calculate estimated listing gain by combining gmp_price with the issue price field
- Filter to high-GMP open IPOs using get_gmp_badge_filtered with a min_gmp threshold for a watchlist
- Track IPO size and lot size together to estimate minimum investment alongside grey market sentiment
- Monitor changes in gmp_percent over time by periodically calling get_live_gmp and storing snapshots
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.