IPO Guru
GMP
Gohil Angel Ad
IPO Guru

IPO GMP & Details API for Developers

Welcome to the IPO Guru Developer API — the ultimate toolkit for accessing real-time Indian IPO market data. Designed for fintech developers, investment platforms, and market analysts, our API provides instant access to comprehensive details on both Mainboard and SME IPOs. From live Grey Market Premium (GMP) updates to crucial Issue Dates and Pricing, we deliver the structured data you need to build powerful financial applications.

Our robust, JSON-based infrastructure ensures seamless integration into your existing workflows. Whether you're developing a mobile app, a trading algorithm, or a customized dashboard, the IPO Guru API handles the heavy lifting of data aggregation and verification. Start building today with our free, high-performance endpoints and give your users the competitive edge in the primary market.

Get Your Free API Key

To prevent abuse and ensure quality of service, API access is currently by request.

Email your request to: [email protected] Contact Us Page

Please include your Name, App/Company Name, and Intended Use Case.

API Documentation

Version 1.0

Base URL

https://www.ipoguru.in/api/v1

Authentication

All API requests must be authenticated using your unique API Key. You can pass the key either as a standard HTTP header (recommended) or as a query parameter.

Method 1: Header (Recommended)

Best for backend applications.

X-API-KEY: your_api_key_here

Method 2: Query Parameter

Easier for quick browser testing.

?api_key=your_api_key_here

Endpoints

GET /ipos

Retrieves a list of IPOs. By default, it returns all active IPOs (Open, Upcoming, or recently listed). Use query parameters to filter the results.

Query Parameters

Parameter Type Required Description
type string Optional Filter by IPO category.
Values: mainboard, sme
status string Optional Filter by current status.
Values: open, upcoming, closed

Response Schema

The API returns a JSON object containing a `success` flag, a `count` of total results, and a `data` array of IPO objects.

{
  "success": true,
  "count": 1,
  "data": [
    {
      "name": "Tata Technologies Ltd",
      "type": "Mainboard",
      "open_date": "2023-11-22",
      "close_date": "2023-11-24",
      "listing_date": "2023-11-30",
      "issue_size": "3042.51 Cr",
      "issue_price": "500.00",
      "status": "Closed",
      "gmp": {
        "price": "350",
        "percentage": "70.00",
        "updated_at": "2023-11-24 10:30:00"
      }
    }
  ]
}

Code Examples

curl -X GET "https://www.ipoguru.in/api/v1/ipos?type=mainboard" \ -H "X-API-KEY: your_api_key_here"
import requests url = "https://www.ipoguru.in/api/v1/ipos" headers = { "X-API-KEY": "your_api_key_here" } params = { "type": "mainboard", "status": "open" } response = requests.get(url, headers=headers, params=params) data = response.json() print(data)
$curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://www.ipoguru.in/api/v1/ipos?type=mainboard", CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "X-API-KEY: your_api_key_here" ], ]); $response = curl_exec($curl); $data = json_decode($response, true); curl_close($curl); print_r($data);
const url = "https://www.ipoguru.in/api/v1/ipos?type=mainboard"; const headers = { "X-API-KEY": "your_api_key_here" }; fetch(url, { method: "GET", headers: headers }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error("Error:", error));
package main import ( "fmt" "io/ioutil" "net/http" ) func main() { url := "https://www.ipoguru.in/api/v1/ipos?type=mainboard" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-API-KEY", "your_api_key_here") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(string(body)) }

Frequently Asked Questions

Is the API completely free?

Yes, the IPO Guru API is currently free for developers, students, and startups. We aim to support the financial tech ecosystem. However, we do enforce fair usage limits to ensure stability for everyone.

How often is the data updated?

The data is updated in near real-time. GMP (Grey Market Premium) values are updated multiple times a day based on market movements. Subscription data is updated as per exchange releases.

Can I use this for commercial projects?

Yes, you can use the API for commercial applications. We just ask that you attribute detailed IPO data to IPO Guru where appropriate.

What happens if I exceed the rate limit?

If you send too many requests in a short period, the API will return a 429 Too Many Requests status code. Please implement exponential backoff in your application to handle this gracefully.