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

GET /v1/ipos?status=open200
{
  "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,
    …
  }]
}
Sample response, abridged. Every field is documented below.

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.

IPO GMP Grey market premium in rupees and as a percentage of the issue price, with when the source last updated it.
IPO subscription status QIB, NII, retail and total subscription as multiples of the shares on offer, through the bidding days.
IPO calendar Open and close dates, issue price, lot size and listing price for upcoming, open, closed and listed issues.

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:

QueryValues
typemainboard, sme, sse
statusupcoming, 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.

FieldTypeMeaning
idstringStable slug of the name; the key for /v1/ipos/{id}
namestringCompany name as the schedule source writes it
symbolstring | nullExchange symbol, when known
typetag | nullSee Tags
statustag | nullSee Tags
issue_pricenumber | null₹ per share — the top of the price band
lot_sizeinteger | nullShares per lot
open_datedate | nullSubscription opens (YYYY-MM-DD, India)
close_datedate | nullSubscription closes
listing_pricenumber | null₹ per share at listing, once a source publishes it
gmpnumber | nullGrey market premium, ₹ per share. Unofficial
gmp_percentnumber | nullGMP as a percentage of the issue price
gmp_updated_atdatetime | nullWhen the GMP source last updated it
qibnumber | nullQualified institutional bids, as a multiple of the shares on offer
niinumber | nullNon-institutional bids, the same way
retailnumber | nullRetail bids, the same way
total_subscriptionnumber | nullOverall subscription multiple
subscription_updated_atdatetime | nullWhen 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.

TagValues
typemainboard, sme, sse (Social Stock Exchange)
statusupcoming, 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

LimitValue
Requests per key per day200, resetting at 00:00 UTC (05:30 IST)
Rate per key2 requests a second, burst 2
Key lifetime6 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": "…"}.

StatuserrorWhen
400bad_requestA filter value outside its set, or a malformed id
403forbiddenNo key; or a key that is not active — unknown, awaiting approval, revoked or expired; or the API is paused
404not_foundNo IPO with that id in the latest data, or no such path or method
429rate_limitedOver 2 requests a second; a retry after a short pause succeeds
429quota_exceededOver 200 requests today. Resets at 00:00 UTC
503unavailableThe data could not be read; usually temporary

Keys

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

IPO Radar facts API — terms of use What the API serves Publicly available facts about Indian IPOs as IPO Radar last collected them: schedule, issue price, lot size, grey market premium (GMP) and subscription figures. It serves no score, no colour and no other derived figure. Nothing it returns is investment advice, a recommendation, a research report, or an offer or solicitation to buy or subscribe to any security. The operator is not registered with SEBI as an Investment Adviser or as a Research Analyst. About the data GMP is an informal, unofficial and unregulated indicator. It is not an official price and is not verified by any exchange or regulator. All figures come from third-party public sources and may be inaccurate, stale, incomplete or missing. A null value means a figure has not been published; it does not mean zero. Every response carries the time the data was collected. Where the data is shown Wherever this data is shown to other people, the notice "GMP is unofficial, unverified third-party data." is shown with it, and it is not presented as advice or as a recommendation. The key A key belongs to the one application it was issued for and is not shared, published, sold or embedded in code that runs in a browser or an app. It is limited to 200 requests a day and 2 requests a second. It expires six months after it is issued and may be renewed on request. A key may be disabled at any time — for example for sharing, for resale of the data, or for traffic that looks like abuse — and the whole API may be paused without notice. No guarantees The API is provided free and as-is, with no warranty of any kind and no promise of availability. The operator is not liable for any loss arising from its use or from any decision made with its data.

Get a key

What happens after submitting:

  1. A verification email arrives. Its link verifies the address.
  2. 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.
  3. The application is submitted for approval and read by a person — within 24 hours.
  4. 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.

Approval within 24 hours. The key works from then on.

GMP is unofficial, unverified third-party data. Nothing served by this API is investment advice.

← IPO Radar, the digest