GMP Endpoints
Access Grey Market Premium data aggregated from multiple sources.
Plan Requirement: Pro or higher
GMP endpoints require a Pro plan or higher. Requests from Free or Basic plan users will receive a 403 response with error code PLAN_001.
Grey Market Premium (GMP) reflects the unofficial premium at which IPO shares trade before listing. IPO Guruji aggregates GMP data from multiple sources and provides median and mean values to reduce outlier impact. GMP data is updated approximately every 2 hours.
GET
/v1/gmpPro+Retrieve current GMP data for all active IPOs.
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | Optional | 1 | Page number for pagination |
limit | number | Optional | 10 | Number of results per page (max 100) |
Example Request
curl -X GET "https://api.ipoguruji.com/v1/gmp?limit=5" \ -H "X-API-Key: ipg_live_your_api_key_here"Success Response200
{
"success": true,
"data": [
{
"id": "gmp_r3c0rd001",
"ipoSlug": "nexus-select-trust-reit",
"ipoName": "Nexus Select Trust REIT IPO",
"issuePrice": 100,
"gmpValue": 45,
"estimatedListingPrice": 145,
"estimatedListingGain": 45.0,
"sources": [
{ "name": "Source A", "value": 42 },
{ "name": "Source B", "value": 48 },
{ "name": "Source C", "value": 45 }
],
"aggregation": {
"median": 45,
"mean": 45,
"min": 42,
"max": 48
},
"lastUpdated": "2026-02-09T14:00:00.000Z"
},
{
"id": "gmp_r3c0rd002",
"ipoSlug": "green-energy-ltd",
"ipoName": "Green Energy Limited IPO",
"issuePrice": 250,
"gmpValue": 80,
"estimatedListingPrice": 330,
"estimatedListingGain": 32.0,
"sources": [
{ "name": "Source A", "value": 75 },
{ "name": "Source B", "value": 85 },
{ "name": "Source C", "value": 80 }
],
"aggregation": {
"median": 80,
"mean": 80,
"min": 75,
"max": 85
},
"lastUpdated": "2026-02-09T14:00:00.000Z"
}
],
"meta": {
"page": 1,
"limit": 5,
"total": 2,
"totalPages": 1,
"hasNextPage": false,
"hasPrevPage": false
},
"links": {
"self": "/v1/gmp?limit=5&page=1",
"next": null,
"prev": null
},
"disclaimer": "GMP data is unofficial and for informational purposes only. Not investment advice.",
"timestamp": "2026-02-09T14:30:00.000Z",
"requestId": "req_g7m8p9q0r1"
}GET
/v1/gmp/:ipoSlugPro+Retrieve the latest GMP data for a specific IPO.
Path Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ipoSlug | string | Required | - | The slug of the IPO (e.g., nexus-select-trust-reit) |
Example Request
curl -X GET "https://api.ipoguruji.com/v1/gmp/nexus-select-trust-reit" \ -H "X-API-Key: ipg_live_your_api_key_here"Success Response200
{
"success": true,
"data": {
"id": "gmp_r3c0rd001",
"ipoSlug": "nexus-select-trust-reit",
"ipoName": "Nexus Select Trust REIT IPO",
"issuePrice": 100,
"gmpValue": 45,
"estimatedListingPrice": 145,
"estimatedListingGain": 45.0,
"sources": [
{ "name": "Source A", "value": 42 },
{ "name": "Source B", "value": 48 },
{ "name": "Source C", "value": 45 }
],
"aggregation": {
"median": 45,
"mean": 45,
"min": 42,
"max": 48
},
"lastUpdated": "2026-02-09T14:00:00.000Z"
},
"disclaimer": "GMP data is unofficial and for informational purposes only. Not investment advice.",
"timestamp": "2026-02-09T14:30:00.000Z",
"requestId": "req_s1n6l3g4m5"
}GET
/v1/gmp/:ipoSlug/historyPro+Retrieve historical GMP data for a specific IPO over time.
Path Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ipoSlug | string | Required | - | The slug of the IPO |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
days | number | Optional | 30 | Number of days of history to retrieve (max 90) |
page | number | Optional | 1 | Page number for pagination |
limit | number | Optional | 10 | Number of results per page (max 100) |
Example Request
curl -X GET "https://api.ipoguruji.com/v1/gmp/nexus-select-trust-reit/history?days=7" \ -H "X-API-Key: ipg_live_your_api_key_here"Success Response200
{
"success": true,
"data": [
{
"date": "2026-02-09T14:00:00.000Z",
"gmpValue": 45,
"estimatedListingPrice": 145,
"estimatedListingGain": 45.0,
"aggregation": { "median": 45, "mean": 45, "min": 42, "max": 48 }
},
{
"date": "2026-02-08T14:00:00.000Z",
"gmpValue": 40,
"estimatedListingPrice": 140,
"estimatedListingGain": 40.0,
"aggregation": { "median": 40, "mean": 41, "min": 38, "max": 45 }
},
{
"date": "2026-02-07T14:00:00.000Z",
"gmpValue": 35,
"estimatedListingPrice": 135,
"estimatedListingGain": 35.0,
"aggregation": { "median": 35, "mean": 36, "min": 32, "max": 40 }
},
{
"date": "2026-02-06T14:00:00.000Z",
"gmpValue": 30,
"estimatedListingPrice": 130,
"estimatedListingGain": 30.0,
"aggregation": { "median": 30, "mean": 31, "min": 28, "max": 35 }
}
],
"meta": {
"page": 1,
"limit": 10,
"total": 4,
"totalPages": 1,
"hasNextPage": false,
"hasPrevPage": false
},
"links": {
"self": "/v1/gmp/nexus-select-trust-reit/history?days=7&page=1",
"next": null,
"prev": null
},
"disclaimer": "GMP data is unofficial and for informational purposes only. Not investment advice.",
"timestamp": "2026-02-09T14:30:00.000Z",
"requestId": "req_h1s7t8r9y0"
}Plan Requirement Error
If your subscription plan does not include GMP access, you will receive the following error:
Plan Required403
{
"success": false,
"error": {
"code": "PLAN_001",
"message": "Your current plan does not include access to GMP data. Please upgrade to Pro or higher.",
"documentation": "https://docs.ipoguruji.com/errors/PLAN_001"
},
"disclaimer": "Data aggregated from publicly accessible sources. Not investment advice.",
"timestamp": "2026-02-09T14:30:00.000Z",
"requestId": "req_p1l4n5r6q7"
}