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' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace investorgain-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: InvestorGain IPO GMP SDK — bounded, re-runnable; every call capped."""
from parse_apis.InvestorGain_IPO_GMP_API import InvestorGain, ParseError
client = InvestorGain()
# List all live IPO GMP rows, capped at 5
for ipo in client.ipos.list(limit=5):
print(ipo.name, ipo.gmp_percent, ipo.gmp_price, ipo.status, ipo.price)
# Filter to upcoming/open IPOs with GMP >= 10%
for ipo in client.ipos.upcoming_or_open(min_gmp=10, limit=3):
print(ipo.name, ipo.badge, ipo.gmp_percent, ipo.lot_size)
# Get IPOs with future close dates
ipo = client.ipos.by_close_date(min_gmp=0, limit=1).first()
if ipo:
try:
print(ipo.name, ipo.close_date, ipo.estimated_listing_gain)
except ParseError as e:
print(f"error: {e}")
print("exercised: ipos.list / ipos.upcoming_or_open / ipos.by_close_date")
Returns IPOs with badge 'U' (Upcoming) or 'O' (Open), optionally filtered by minimum GMP percentage, sorted by GMP descending. Returns an empty 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. |
{
"type": "object",
"fields": {
"items": "array of IPO objects with badge U or O, each containing name, gmp_percent, badge, close_date, open_date, price, lot_size, ipo_size_cr"
},
"sample": {
"data": {
"items": [
{
"name": "Horizon Reclaim (India)",
"badge": "U",
"price": "103",
"lot_size": "1200",
"open_date": "2026-06-12",
"close_date": "2026-06-16",
"gmp_percent": 40.78,
"ipo_size_cr": ""
}
]
},
"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.