# InvestorGain India IPO API

> Indian IPOs (mainboard and SME): open and upcoming issues, grey market premium, broker ratings

- Vendor: `investorgainindiaipoapi` · version 1.0 · category Finance · tags india ipo api, ipo gmp api, grey market premium api, nse ipo api, bse sme ipo api, upcoming ipo api, stock broker api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/investorgainindiaipoapi
- This document: https://apiclay.com/docs/investorgainindiaipoapi.md
- OpenAPI 3.1: https://apiclay.com/api/investorgainindiaipoapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `investorgainindiaipoapi`
- Updated: 2026-11-18

## About

## InvestorGain India IPO API

Track Indian IPOs on the NSE and BSE (mainboard and SME): issues opening and closing, issue size and listing exchange, the grey market premium (GMP) each one trades at, and InvestorGain's comparison of Indian stock brokers.

Data comes from **investorgain.com** (https://www.investorgain.com). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://www.investorgain.com) and returns it unchanged.

Typical flow: `/ipos` for the current calendar, `/gmp` for premiums.

### Routes

#### GET `/ipos` - Current and upcoming IPOs
No parameters.

Returns: `ipoList[]` with `company_short_name`, `issue_size`, `issue_open_dt`, `issue_end_dt`, `ipo_listing_at`.

#### GET `/gmp` - Grey market premium
No parameters.

Returns: `gmpList[]` with `company_short_name`, the GMP and estimated listing price fields (some values are HTML snippets).

#### GET `/brokers` - Stock brokers
No parameters.

Returns: `brokers[]` with `company_short_name`, `account_type`, ratings and charges.

### Caveats

- GMP is an unofficial grey-market indicator, not exchange data.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by investorgain.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /ipos — Current and upcoming IPOs
- Gateway: `GET https://api.apiclay.com/v1/api/investorgainindiaipoapi/ipos`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /gmp — Grey market premium (GMP)
- Gateway: `GET https://api.apiclay.com/v1/api/investorgainindiaipoapi/gmp`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /brokers — Stock brokers
- Gateway: `GET https://api.apiclay.com/v1/api/investorgainindiaipoapi/brokers`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/investorgainindiaipoapi/ipos" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
