IG
IPO Guruji

Quickstart Guide

Get up and running with the IPO Guruji API in under 5 minutes.

This guide walks you through creating an account, obtaining an API key, and making your first API request. By the end, you will have successfully retrieved live IPO data from the IPO Guruji API.

Step 1: Create an Account

Visit the registration page and sign up with your email address. You will receive a verification email to confirm your account.

The Free plan gives you 10 requests per minute and 100 requests per day. No credit card required.

Step 2: Get Your API Key

After logging in, navigate to the API Keys section of your dashboard. Click Generate New Key to create a live API key.

Your API key will look like this:

API Key Format
ipg_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a7b8c9d0

Important: Your API key is shown only once when generated. Copy and store it securely. If you lose it, you will need to generate a new one.

Step 3: Make Your First Request

Pass your API key using the X-API-Key header. Let us start by listing open IPOs:

List Open IPOs
bash
curl -X GET "https://api.ipoguruji.com/v1/ipos?status=open&limit=5" \  -H "X-API-Key: ipg_live_your_api_key_here" \  -H "Content-Type: application/json"

Step 4: Understand the Response

A successful API response includes the requested data, pagination metadata, navigation links, a disclaimer, and a unique request ID:

Success Response200
{
  "success": true,
  "data": [
    {
      "id": "ipo_abc123def456",
      "slug": "nexus-select-trust-reit",
      "name": "Nexus Select Trust REIT IPO",
      "company": "Nexus Select Trust",
      "exchange": "NSE BSE",
      "type": "MAINBOARD",
      "status": "OPEN",
      "issuePrice": {
        "min": 95,
        "max": 100
      },
      "lotSize": 150,
      "issueSize": "3200.00 Cr",
      "dates": {
        "openDate": "2026-02-10T00:00:00.000Z",
        "closeDate": "2026-02-12T00:00:00.000Z",
        "allotmentDate": "2026-02-15T00:00:00.000Z",
        "listingDate": "2026-02-18T00:00:00.000Z"
      },
      "subscription": {
        "retailTimes": 1.25,
        "niiTimes": 0.85,
        "qibTimes": 2.10,
        "totalTimes": 1.45
      },
      "listing": null,
      "registrar": "KFin Technologies Limited",
      "leadManager": "ICICI Securities, Axis Capital",
      "sector": "Real Estate"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 3,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false
  },
  "links": {
    "self": "/v1/ipos?status=open&limit=5&page=1",
    "next": null,
    "prev": null
  },
  "disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
  "timestamp": "2026-02-09T14:30:00.000Z",
  "requestId": "req_f7k2m9p1x4"
}

Next Steps

Authentication

Learn about API key types, security best practices, and rate limits.

API Endpoints

Explore all available endpoints for IPOs, GMP, NFO, SGB, and more.

Pagination

Learn how to paginate through large result sets efficiently.

Error Handling

Understand error codes and how to handle errors gracefully.

NextIntroduction