Indian IPO API Developer Documentation
Welcome to the official developer hub for IPO API PRO. Programmatically access institutional-grade, real-time feeds covering Indian Mainboard and SME public offerings, live Grey Market Premium (GMP) quotes, intraday bidding subscription multiples, and official registrar basis of allotment records.
Quickstart in 3 Minutes
Sign up for an API key on the pricing page or contact sales for instant provisioning.
Pass ApiKey and ApiSecret in every HTTP request header.
Query any of the 11 endpoints with sub-15ms edge latency across Mumbai and Delhi.
Sample Request: Live Mainboard Feed (cURL)
curl -X GET "https://api.ipoapipro.in/api/ipo/mainboard?pageNumber=1&perPageRow=5" \ -H "ApiKey: YOUR_API_KEY" \ -H "ApiSecret: YOUR_API_SECRET"
Node.js (Axios)
import axios from "axios";
const response = await axios.get("https://api.ipoapipro.in/api/gmp/live-rates", {
headers: {
"ApiKey": process.env.IPO_API_KEY,
"ApiSecret": process.env.IPO_API_SECRET,
},
});
console.log("Active IPOs with Live GMP:", response.data);Python (Requests)
import requests
url = "https://api.ipoapipro.in/api/ipo/mainboard"
headers = {
"ApiKey": "YOUR_API_KEY",
"ApiSecret": "YOUR_API_SECRET"
}
res = requests.get(url, headers=headers)
data = res.json()
for ipo in data.get("data", []):
print(f"{ipo['companyName']} - Lot: {ipo['lotSize']} - Band: ₹{ipo['minimumPrice']}-₹{ipo['maximumPrice']}")Authentication & Base URL
All requests are executed over HTTPS against the primary production gateway:
Authentication is enforced via two HTTP request headers:
- ApiKey: Your 32-character client key
- ApiSecret: Your private signature client secret
Complete Endpoints Catalog (11 Routes)
Mainboard IPO Feed
Retrieve paginated listings of Mainboard IPOs with price bands, issue size, timeline, and exchange data.
SME IPO Feed
Stream dedicated BSE SME and NSE Emerge offerings with minimum lot quantities and issue sizes.
Combined All IPOs Feed
Consolidated stream of all Indian IPOs spanning both Mainboard and SME markets in one call.
Comprehensive IPO Details
Deep-dive company profiles, multi-year financial tables, schedule milestones, and registrar contacts.
Investor Quota Reservation
Share allocation breakdown by investor category (Retail, QIB, NII/HNI, Anchor, Employee).
Live Subscription & Bidding Rates
Up-to-the-minute subscription multiples (times subscribed) per investor category and total bids.
Application-Wise Subscription
Live breakdown of total application counts, bidding applications per category, and subscription multiples.
Combined Subscription with App-Wise Intelligence
Master subscription feed combining share bids, application counts, lottery winner odds (PeopleBase), and narrative AI summaries.
IPO GMP Tracker & History
Full historical timeline of Grey Market Premium (GMP) rates, Kostak rates, and estimated listing gains.
Live GMP Rates Master List
Consolidated real-time table of current GMP rates across all currently active and upcoming IPOs.
Developer Integration Tutorials
Ready-to-use recipes, code examples, and automation scripts for Telegram bots, Google Sheets, and Next.js dashboards.
Authoritative Indian IPO API Specifications
Structured reference data optimized for financial analysts, developers, and AI research engines.
Indian Stock Market IPO Glossary & Definitions
Authoritative definitions of core Indian IPO concepts, Grey Market trading terms, and SEBI ICDR investor categories.
Grey Market Premium (GMP)
The unofficial over-the-counter premium at which an IPO application or shares trade before official stock exchange listing, indicating anticipated listing day gain or discount.
Kostak Rate
The fixed lump-sum profit an IPO applicant earns by selling their entire IPO application to a grey market buyer before allotment, regardless of whether shares are allotted.
Subject to Sauda
A conditional grey market deal where the buyer pays the agreed profit amount to the seller only if the seller receives an actual share allotment in the IPO lottery.
Qualified Institutional Buyers (QIB)
Institutional investors such as mutual funds, foreign portfolio investors (FPIs), banks, and insurance companies, typically allocated 50% of a book-built public issue.
Non-Institutional Investors (NII)
High net-worth individuals bidding above ₹2 Lakhs, subdivided into Small NII (sNII: ₹2L to ₹10L) and Big NII (bNII: above ₹10L) under SEBI guidelines.
Retail Individual Investors (RII)
Individual retail investors applying for an aggregate value of up to ₹2 Lakhs, eligible for a minimum reserved allocation quota of 35% in standard profitability IPOs.
Basis of Allotment (BoA)
The official regulatory document published by the IPO registrar and stock exchange detailing allotment ratios, lottery odds, and category-wise share distribution.
Cut-off Price
The final issue price selected by the company and merchant bankers within the price band at which shares are issued to successful applicants.
Frequently Asked Questions
Everything you need to know about our Indian stock market IPO feeds, GMP rates, and integration.