# IPO API PRO - Indian Stock Market IPO Intelligence Engine

> High-speed REST API delivering real-time Mainboard & SME IPO data, live Grey Market Premium (GMP) quotes, live bidding subscription multiples, investor quota reservations, and historical basis of allotment records across NSE and BSE.

## Core Capabilities & Performance SLA
- Real-time Mainboard IPO listings with live GMP quotes and exchange listing prices (NSE & BSE)
- BSE SME & NSE Emerge IPO coverage with mandatory lot sizing and market makers
- Automated qualitative company strengths and business risks powered by Bajaj Broking
- Comprehensive valuation KPIs including P/E (Pre/Post), RoNW, ROCE, EPS, and Debt/Equity
- Sub-15ms query response time via global edge CDN caching
- Live exchange bidding subscription multiples (QIB, sNII, bNII, Retail, Employee)
- Application-wise bidding counts & mathematical lottery odds (PeopleBase)
- Historical Basis of Allotment (BoA) registrar records & certified PDF archive
- Multi-language SDK examples (cURL, JavaScript/Node.js, Python, PHP, C#)

## Primary Client-Facing Endpoints (11 Clean Canonical Routes)
- [Mainboard IPOs](https://www.ipoapipro.in/docs/mainboard-ipo-api): GET /api/ipo/mainboard - Active, upcoming, and past NSE/BSE Mainboard issues with live GMP.
- [SME IPOs](https://www.ipoapipro.in/docs/sme-ipo-api): GET /api/ipo/sme - BSE SME and NSE Emerge IPO issues, lot sizes, and market makers.
- [Unified IPO Feed](https://www.ipoapipro.in/docs/all-ipos-api): GET /api/ipo/all - Consolidated single payload of all Mainboard and SME IPOs.
- [Comprehensive IPO Details](https://www.ipoapipro.in/docs/ipo-details-api): GET /api/ipo/details/:ipoId - Company financials, lead managers, registrar, DRHP links.
- [Quota Reservation](https://www.ipoapipro.in/docs/quota-reservation-api): GET /api/ipo/quota-reservation/:ipoId - Complete quota breakdown across QIB, NII, Retail, and Employee allocations.
- [Live Subscription Rates](https://www.ipoapipro.in/docs/subscription-rates-api): GET /api/ipo/subscription-rates/:ipoId - Real-time subscription multiples updated continuously during market sessions.
- [Application-Wise Subscription](https://www.ipoapipro.in/docs/appwise-subscription-api): GET /api/ipo/appwise-subscription/:ipoId - Breakdown of applicant numbers, bids, and lottery odds by investor category.
- [Combined Subscription & Lottery Odds](https://www.ipoapipro.in/docs/subscription-with-appwise-api): GET /api/ipo/subscription-with-appwise/:ipoId - Consolidated share subscriptions, applicant counts, 1-in-X lottery allotment odds (PeopleBase), and narrative summaries.
- [Historical GMP Tracker](https://www.ipoapipro.in/docs/ipo-gmp-tracker-api): GET /api/gmp/tracker/:ipoId - Day-by-day historical grey market premium trends and Kostak rates.
- [Live Market GMP Rates](https://www.ipoapipro.in/docs/live-gmp-rates-api): GET /api/gmp/live-rates - Real-time streaming quotes of active IPO GMP rates.
- [Basis of Allotment Records](https://www.ipoapipro.in/docs/basis-of-allotment-api): GET /api/allotment/basis-records/:year/:ipoType - Deep historical repository of allotment ratios and lottery odds.

## Developer Integration Tutorials
- [Build an IPO GMP Tracker with Node.js & Telegram Alerts](https://www.ipoapipro.in/tutorials/build-ipo-gmp-tracker-nodejs)
- [How to Fetch Live IPO Allotment Status & Lottery Odds in Python](https://www.ipoapipro.in/tutorials/fetch-live-ipo-allotment-status-api)
- [Import Real-Time IPO & GMP Data into Google Sheets with Apps Script](https://www.ipoapipro.in/tutorials/ipo-data-google-sheets)
- [Build an IPO Dashboard with Next.js 16 and Tailwind CSS](https://www.ipoapipro.in/tutorials/nextjs-ipo-dashboard)
- [Best IPO API for India: Free vs Pro & Alternatives Guide](https://www.ipoapipro.in/compare/best-ipo-api-india)

## Authentication
Every HTTP request requires two client authentication headers:
- ApiKey: Your unique client API key
- ApiSecret: Your client secret

## Base URL
https://api.ipoapipro.in

## Machine-Readable Specifications
- [Full LLM Specification](https://www.ipoapipro.in/llms-full.txt): Complete schemas, parameter tables, and multi-language snippets.
- [OpenAPI 3.0 Specification](https://www.ipoapipro.in/openapi.json): Standard OpenAPI JSON definition for AI agent tool calling.