{"openapi":"3.0.3","info":{"title":"Indian Stock Market IPO API","version":"2.0.0","description":"High-speed REST API providing real-time Mainboard & SME IPO data, live Grey Market Premium (GMP) quotes, live bidding subscription rates, quota reservations, and basis of allotment records.","contact":{"name":"IPO API Support","url":"https://www.ipoapipro.in","email":"support@ipoapipro.in"}},"servers":[{"url":"https://api.ipoapipro.in","description":"Production Global Edge Cluster"},{"url":"http://localhost:5173","description":"Local Development Environment"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"Client authentication API key"},"ApiSecretAuth":{"type":"apiKey","in":"header","name":"X-API-SECRET","description":"Client authentication API secret"}}},"security":[{"ApiKeyAuth":[],"ApiSecretAuth":[]}],"paths":{"/api/ipo/mainboard":{"get":{"summary":"List Mainboard IPOs","description":"Fetch active, upcoming, and past NSE and BSE Mainboard issues with real-time GMP quotes, official listing prices, and ticker symbols.","operationId":"getMainboardIpos","parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["active","upcoming","closed","all"],"default":"all"},"description":"Filter IPOs by issue status"}],"responses":{"200":{"description":"Successful response with mainboard IPO records"},"401":{"description":"Unauthorized - invalid API key"}}}},"/api/ipo/sme":{"get":{"summary":"List SME IPOs","description":"Fetch BSE SME and NSE Emerge IPO listings, lot sizes, and market makers.","operationId":"getSmeIpos","parameters":[{"name":"exchange","in":"query","schema":{"type":"string","enum":["BSE_SME","NSE_EMERGE","all"],"default":"all"}}],"responses":{"200":{"description":"Successful response with SME IPO records"}}}},"/api/ipo/all":{"get":{"summary":"Unified IPO Feed","description":"Consolidated master list of all Mainboard and SME IPOs in a single payload.","operationId":"getAllIpos","responses":{"200":{"description":"Consolidated IPO list"}}}},"/api/ipo/details/{ipoId}":{"get":{"summary":"Get IPO Comprehensive Details","description":"Fetch company financials, valuation KPIs, strengths & risks (Bajaj Broking), registrar contacts, and DRHP prospectus links.","operationId":"getIpoDetails","parameters":[{"name":"ipoId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique IPO identifier or symbol"}],"responses":{"200":{"description":"Detailed IPO profile"}}}},"/api/ipo/quota-reservation/{ipoId}":{"get":{"summary":"Get Quota Reservation Breakdown","description":"Returns investor quota reservations across QIB, NII (sNII & bNII), Retail, and Employees.","operationId":"getQuotaReservation","parameters":[{"name":"ipoId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Category quota allocation data"}}}},"/api/ipo/subscription-rates/{ipoId}":{"get":{"summary":"Get Live Subscription Rates","description":"Streaming subscription multiples during active exchange bidding hours.","operationId":"getSubscriptionRates","parameters":[{"name":"ipoId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Live subscription multiples"}}}},"/api/ipo/appwise-subscription/{ipoId}":{"get":{"summary":"Get Application-Wise Subscription","description":"Granular breakdown of application counts, quota allocation multiples, and lottery probabilities by investor category.","operationId":"getAppWiseSubscription","parameters":[{"name":"ipoId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique IPO identifier or symbol"}],"responses":{"200":{"description":"Application-level subscription statistics"}}}},"/api/ipo/subscription-with-appwise/{ipoId}":{"get":{"summary":"Get Combined Subscription with App-Wise Intelligence","description":"Master subscription feed combining share bids, applicant lottery odds (PeopleBase), maximum winner caps, and narrative AI summaries.","operationId":"getSubscriptionWithAppWise","parameters":[{"name":"ipoId","in":"path","required":true,"schema":{"type":"string"},"description":"Unique IPO identifier or symbol"}],"responses":{"200":{"description":"Consolidated subscription and application-level analytics"}}}},"/api/gmp/tracker/{ipoId}":{"get":{"summary":"Get Historical GMP Tracker","description":"Historical grey market premium day-by-day trends and Kostak rates.","operationId":"getGmpTracker","parameters":[{"name":"ipoId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Historical GMP trend records"}}}},"/api/allotment/basis-records/{year}/{ipoType}":{"get":{"summary":"Get Basis of Allotment Records","description":"Historical registrar allotment files, allotment ratios, and lottery odds.","operationId":"getBasisRecords","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string"},"example":"2024"},{"name":"ipoType","in":"path","required":true,"schema":{"type":"string","enum":["mainboard","sme"]}}],"responses":{"200":{"description":"Historical allotment records"}}}},"/api/gmp/live-rates":{"get":{"summary":"Get Live Market GMP Rates","description":"Real-time streaming quotes of GMP rates across all currently active and upcoming IPOs.","operationId":"getLiveGmpRates","responses":{"200":{"description":"Active market GMP rates"}}}}}}