IPO Subscription Status API - Live Bidding Multiples
Tracks intraday bidding demand across day 1, 2, and 3 of the bidding window. Returns subscription multiples for Retail, QIB, NII, and employee tranches.
Endpoint Overview & Architecture
The Live Subscription & Bidding Rates API delivers real-time updates on cumulative bidding demand during the official three-day book-building window on NSE and BSE. As investors place bids through ASBA and UPI 2.0, our engine reconciles live exchange order books every few minutes.
The response provides granular subscription multiples (e.g. 5.42x, 18.2x) broken down across each regulatory investor category: Retail Individual Investors (RII), Non-Institutional Investors (NII - sNII & bNII), Qualified Institutional Buyers (QIB), and Employees, along with cumulative total subscription.
Subscription rates directly correlate with listing-day demand and Grey Market Premium movement. Financial applications use this data to trigger push notifications when an IPO crosses full subscription (1.00x) or achieves blockbuster status (>50x).
Request Authentication Headers
| Header Name | Type | Required | Description |
|---|---|---|---|
| ApiKey | string | Required | Your secret API access key provided upon subscription registration. |
| ApiSecret | string | Required | Your secret API client secret used to sign and authenticate requests. |
Request Parameters
| Parameter | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| ipoId | path | integer | Required | - | Target IPO ID. |
Code Examples
curl -X GET "https://api.ipoapipro.in/api/ipo/subscription-rates/257" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Sample JSON Response
{
"isSuccess": true,
"message": "Successfully.",
"data": {
"retailSubscription": 3.74,
"niiSubscription": 18.01,
"bniiSubscription": 19.19,
"sniiSubscription": 15.65,
"qibSubscription": 4.49,
"employeeSubscription": null,
"totalSubscription": 7.01,
"lastUpdate": "2026-09-30T13:00:00.000Z"
}
}Response Attributes Schema
| Attribute | Type | Description |
|---|---|---|
| data.retailSubscription | number | Retail quota subscription multiple (e.g. 8.42x). |
| data.totalSubscription | number | Cumulative total subscription multiple across all bids. |
| data.lastUpdate | string (ISO) | Timestamp of exchange bid sync. |
HTTP Status & Error Codes
| HTTP Code | Title | Condition & Resolution |
|---|---|---|
| 400 | Bad Request | Missing mandatory query parameters, invalid types, or unsupported filter combinations. |
| 401 | Unauthorized | The request lacked valid authentication credentials (ApiKey or ApiSecret). |
| 403 | Forbidden | The subscription plan has expired or this specific endpoint is not included in the plan. |
| 429 | Too Many Requests | Rate limit exceeded. Standard tier permits 60 req/min, Professional tier permits 300 req/min. |
| 500 | Internal Server Error | Downstream exchange connection glitch or upstream registrar network timeout. |
Rate Limits & Edge Caching SLA
Default Rate Limit: 60 requests/minute (Standard) | 300 requests/minute (Pro). Requests are served through Cloudflare edge points of presence across Mumbai, Delhi, Bengaluru, and Chennai with sub-15ms cached latency.
Related IPO API Endpoints
Live breakdown of total application counts, bidding applications per category, and subscription multiples.
Master subscription feed combining share bids, application counts, lottery winner odds (PeopleBase), and narrative AI summaries.
Consolidated real-time table of current GMP rates across all currently active and upcoming IPOs.