IPO GMP API - Real-Time Grey Market Premium Quotes
Aggregates the latest recorded GMP prices, expected listing gains, and Kostak/Sauda rates across all active IPOs in a single fast query.
Endpoint Overview & Architecture
The Live GMP Rates API is the premier endpoint for financial websites, trading apps, and Telegram bots delivering real-time Grey Market Premium updates to Indian retail investors. Instead of scraping disjointed blogs or message boards, this endpoint aggregates verified quotes polled continuously across major OTC dealer networks in Mumbai, Ahmedabad, and Rajkot.
The output returns an indexed array of all currently active and upcoming Mainboard and SME public offerings alongside their latest GMP in Rupees, issue cap price, calculated estimated listing price, and projected percentage gain or discount.
Because market sentiment fluctuates rapidly throughout trading hours, our engine updates quotes every few minutes with low latency caching, ensuring your users always view fresh, trustworthy premium numbers.
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 |
|---|---|---|---|---|---|
| pageNumber | query | integer | Optional | 1 | Page index. |
| perPageRow | query | integer | Optional | 20 | Rows per page. |
Code Examples
curl -X GET "https://api.ipoapipro.in/api/gmp/live-rates" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Sample JSON Response
{
"isSuccess": true,
"message": "Successfully.",
"data": [
{
"ipoId": 257,
"companyName": "Shah Investor's Home Ltd",
"type": "MAINBOARD",
"ipoPrice": 167,
"gmpPrice": 15,
"estimatedListingPrice": 182,
"estimatedListingPercentage": 8.98,
"sub2SaudaRate": "1000",
"gmpDate": "2026-09-30"
}
]
}Response Attributes Schema
| Attribute | Type | Description |
|---|---|---|
| data[].gmpPrice | number | Latest current GMP rate. |
| data[].estimatedListingPercentage | number | Projected percentage listing premium. |
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
Retrieve paginated listings of Mainboard IPOs with price bands, issue size, timeline, and exchange data.
Up-to-the-minute subscription multiples (times subscribed) per investor category and total bids.
Full historical timeline of Grey Market Premium (GMP) rates, Kostak rates, and estimated listing gains.