IPO Radar APIBeta
Indian IPO data.
As JSON.
Grey market premium, QIB / NII / retail subscription, price band, lot size and dates for every Indian IPO — mainboard, SME and SSE, upcoming to listed. Refreshed at 09:00 and 15:00 IST. Free, in beta.
Key shown at once · active after approval, within 24 hours · 200 requests a day
{
"as_of": "2026-09-01T15:00:12+05:30",
"check_type": "final",
"next_update": "2026-09-02T09:00:00+05:30",
"notice": "GMP is unofficial, unverified third-party data.",
"count": 1,
"ipos": [{
"id": "esds-software-solution",
"name": "ESDS Software Solution Ltd",
"type": "mainboard",
"status": "open",
"issue_price": 429.0,
"lot_size": 34,
"close_date": "2026-09-01",
"gmp": 250.0,
"gmp_percent": 58.28,
"qib": 272.19,
"nii": 201.88,
"retail": 39.63,
"total_subscription": 140.84,
"listing_price": null,
…
}]
}
Facts only. The API serves no score, no colour and nothing else
derived — none of what the digest adds. GMP is unofficial, unverified third-party data. The API is in
beta: the shape is versioned (schema_version), but limits
and availability may change while it settles.
An IPO GMP, subscription and calendar API
One endpoint answers the three questions Indian IPO data is usually fetched for, from the same twice-daily collection that feeds IPO Radar's digest.
Documentation
Quickstart
Every IPO open for subscription right now, from a shell, Python or Node.js.
Each reads the key from the IPORADAR_API_KEY environment variable.
curl -sS "https://api.iporadar.leadbybuild.ing/v1/ipos?status=open" \
-H "x-api-key: $IPORADAR_API_KEY"
import os, requests
response = requests.get(
"https://api.iporadar.leadbybuild.ing/v1/ipos",
params={"status": "open", "type": "mainboard"},
headers={"x-api-key": os.environ["IPORADAR_API_KEY"]},
timeout=10,
)
for ipo in response.json()["ipos"]:
print(ipo["name"], ipo["gmp_percent"], ipo["qib"])
const response = await fetch(
"https://api.iporadar.leadbybuild.ing/v1/ipos?status=open",
{ headers: { "x-api-key": process.env.IPORADAR_API_KEY } },
);
const { ipos, as_of } = await response.json();
Authentication
Base URL: https://api.iporadar.leadbybuild.ing/v1
Every request carries the key in the x-api-key header — never in
a query string, where it would end up in logs, histories and referrers.
Server-to-server only. Responses carry no CORS headers, so browsers refuse calls made from a web page. That is deliberate: a key in front-end code is a published key. Data shown in a web or mobile app goes through the app's own server, which holds the key.
Endpoints
Both are GET. There is no write method, no history endpoint and
no derived field in v1.
GET /v1/ipos
Every IPO in the latest data: upcoming, open, closed and listed; mainboard, SME and SSE. Two optional filters, combinable, each taking one value:
| Query | Values |
|---|---|
type | mainboard, sme, sse |
status | upcoming, open, closed, listed |
A value outside these is a 400, not an empty list. A filter
never matches a record whose tag is null.
{
"schema_version": 1,
"as_of": "2026-09-01T15:00:12+05:30",
"check_type": "final",
"next_update": "2026-09-02T09:00:00+05:30",
"notice": "GMP is unofficial, unverified third-party data.",
"count": 1,
"ipos": [
{
"id": "esds-software-solution",
"name": "ESDS Software Solution Ltd",
"symbol": "ESDS",
"type": "mainboard",
"status": "open",
"issue_price": 429.0,
"lot_size": 34,
"open_date": "2026-08-28",
"close_date": "2026-09-01",
"listing_price": null,
"gmp": 250.0,
"gmp_percent": 58.28,
"gmp_updated_at": "2026-09-01T14:30:00+05:30",
"qib": 272.19,
"nii": 201.88,
"retail": 39.63,
"total_subscription": 140.84,
"subscription_updated_at": "2026-09-01T14:45:00+05:30"
}
]
}
GET /v1/ipos/{id}
One IPO, by the id from the list. An id is lowercase letters and
digits in hyphen-separated words, at most 80 characters
(^[a-z0-9]+(-[a-z0-9]+)*$); anything else is a 400. An
id not in the latest data is a 404 — including an IPO that was
there yesterday and has since dropped out of the sources.
{
"schema_version": 1,
"as_of": "2026-09-01T15:00:12+05:30",
"check_type": "final",
"next_update": "2026-09-02T09:00:00+05:30",
"notice": "GMP is unofficial, unverified third-party data.",
"ipo": { "id": "esds-software-solution", "name": "ESDS Software Solution Ltd", … }
}
Ids are derived from the company's name with corporate suffixes removed, so
"ESDS Software Solution Ltd" and "… Limited" share one and it survives a source
rewording the name. Should two records ever reduce to the same id in one
update, the second gets -2.
The IPO record
Every field is always present. null means "not published
yet"; 0 means "published, and zero". A subscription figure of
0 is a real reading — nobody bid — and is not the same as one that
has not appeared.
| Field | Type | Meaning |
|---|---|---|
id | string | Stable slug of the name; the key for /v1/ipos/{id} |
name | string | Company name as the schedule source writes it |
symbol | string | null | Exchange symbol, when known |
type | tag | null | See Tags |
status | tag | null | See Tags |
issue_price | number | null | ₹ per share — the top of the price band |
lot_size | integer | null | Shares per lot |
open_date | date | null | Subscription opens (YYYY-MM-DD, India) |
close_date | date | null | Subscription closes |
listing_price | number | null | ₹ per share at listing, once a source publishes it |
gmp | number | null | Grey market premium, ₹ per share. Unofficial |
gmp_percent | number | null | GMP as a percentage of the issue price |
gmp_updated_at | datetime | null | When the GMP source last updated it |
qib | number | null | Qualified institutional bids, as a multiple of the shares on offer |
nii | number | null | Non-institutional bids, the same way |
retail | number | null | Retail bids, the same way |
total_subscription | number | null | Overall subscription multiple |
subscription_updated_at | datetime | null | When the subscription source last updated them |
Datetimes are ISO 8601 with the +05:30 offset. Prices are in
rupees. New fields may be added within schema_version 1; a field
is never removed or changes meaning without a new version.
Tags
Every record carries two tags, from closed sets. A source's own word that
fits none of them becomes null — it is never passed through raw.
| Tag | Values |
|---|---|
type | mainboard, sme, sse (Social Stock Exchange) |
status | upcoming, open, closed, listed |
A record's tags come from the same update as its figures.
Freshness
The data is rewritten by IPO Radar's scheduled checks at 09:00 and 15:00
IST, and nothing runs on request. Every response says when its data was
collected (as_of), which check collected it
(check_type: morning or final), and when
the next one is due (next_update). Polling more often than that
returns the same data and spends the daily quota.
If a check cannot collect the data, the previous data stays in place — and
as_of says how old it is. An as_of older than
next_update means at least one update was missed.
Limits
| Limit | Value |
|---|---|
| Requests per key per day | 200, resetting at 00:00 UTC (05:30 IST) |
| Rate per key | 2 requests a second, burst 2 |
| Key lifetime | 6 months from approval, renewable on request |
The whole API also has a shared ceiling. If traffic ever looks like a flood,
the API is paused automatically and every request gets a 403 until
it is reopened by hand.
Errors
Errors are JSON: {"error": "<code>", "message": "…"}.
| Status | error | When |
|---|---|---|
| 400 | bad_request | A filter value outside its set, or a malformed id |
| 403 | forbidden | No key; or a key that is not active — unknown, awaiting approval, revoked or expired; or the API is paused |
| 404 | not_found | No IPO with that id in the latest data, or no such path or method |
| 429 | rate_limited | Over 2 requests a second; a retry after a short pause succeeds |
| 429 | quota_exceeded | Over 200 requests today. Resets at 00:00 UTC |
| 503 | unavailable | The data could not be read; usually temporary |
Keys
- One key per application, for the organisation named in it.
- A key is shown once, on the application page the verification email links to. It is never sent in an email.
- It works from approval (within 24 hours) and an email says when. Before that,
every request with it is a
403. - It expires six months after approval. A reminder arrives two weeks before; renewal is on request from hi@leadbybuild.ing.
- A lost key can be shown once more, on a fresh link, on request.
- Usage per key is reviewed weekly. A key that is shared, resold or embedded in front-end code is disabled.
Frequently asked questions
Is there a free API for Indian IPO GMP data?
Yes. The IPO Radar facts API serves grey market premium (GMP) and GMP percentage for every Indian IPO in its sources, alongside subscription figures and the IPO schedule. It is free during the beta: a key is shown straight after applying and works once a person approves it, within 24 hours. Each key allows 200 requests a day.
Which IPOs does the API cover?
Every IPO in the latest data: mainboard, SME and SSE (Social Stock Exchange) issues, whether upcoming, open, closed or listed. Two filters, type and status, narrow the list.
Does the API include IPO subscription status — QIB, NII and retail?
Yes. Each record carries qib, nii, retail and total_subscription as multiples of the shares on offer, plus subscription_updated_at for when the source last changed them.
How often is the IPO data updated?
Twice a day, at 09:00 and 15:00 IST. Every response says when its data was collected (as_of) and when the next update is due (next_update), so there is no reason to poll more often.
Does the API serve historical IPO data?
Not in v1. It serves the latest collected data, which includes recently closed and listed IPOs with their listing price once published. There is no history endpoint.
Does the API return IPO Radar's colours or scores?
No. It is facts only: no score, colour or other derived figure. The colours exist only in the email digest.
Can the API be called from a browser or a mobile app?
Not directly. It is server-to-server: responses carry no CORS headers, because a key in front-end code is a published key. A web or mobile app calls its own server, which holds the key.
What does null mean in a response?
null means “not published yet”; 0 means “published, and zero”. A subscription figure of 0 is a real reading — nobody bid — and is not the same as one that has not appeared.
Is there an OpenAPI specification?
Yes: /api/openapi.yaml (OpenAPI 3.0). It describes both endpoints, every field, and every error.
Is the API data investment advice?
No. It is factual data collected from public sources. GMP in particular is unofficial, unverified third-party data. Nothing the API serves is a recommendation.
Terms of use
Get a key
What happens after submitting:
- A verification email arrives. Its link verifies the address.
- The key is shown once on the page that link opens, with a curl example. That page also shows the application's status from then on.
- The application is submitted for approval and read by a person — within 24 hours.
- Once approved, the key starts working and an email says so. Until
then every request with it returns
403.
Nothing here asks about finances, and nothing should be volunteered. Questions, renewals and lost keys: hi@leadbybuild.ing.
GMP is unofficial, unverified third-party data. Nothing served by this API is investment advice.