Get GMP Trends

The GMP Trends endpoint is currently available in free preview until September, 2026.

Endpoint

GET /ipos/{identifier}/gmp

This endpoint returns historical GMP timeseries data. For the latest GMP snapshot on an IPO object, use includeGmp=true on Get All IPOs or Get One IPO instead.

Parameters

Parameter	Required	Description	Examples
`identifier`	Yes	(`string`) IPO ID, symbol, or slug	`2023552877`, `MILKYMIST`, `milky-mist`
`interval`	No	(`string`) Time bucket for the series. Defaults to `daily`. Allowed: `5m`, `10m`, `15m`, `30m`, `hourly`, `daily`, `weekly`	`5m`, `hourly`, `daily`
`field`	No	(`string`) Aggregation field to chart. Defaults to `mean`. Allowed: `mean`, `median`, `min`, `max`, `mode`	`mean`, `max`
`from`	No	(`string`) Start of the date range. Defaults to 30 days before `to`	`2026-06-01`
`to`	No	(`string`) End of the date range. Defaults to now. When provided, includes the full calendar day	`2026-06-30`

When both from and to are omitted, the API returns the last 30 days of data ending at the current time.

Each series point is the average of the chosen field within that interval bucket, rounded to 2 decimal places. The field values correspond to the same multi-source aggregations described in the GMP Aggregations Structure.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
     "https://api.ipoalerts.in/ipos/MILKYMIST/gmp?interval=5m&field=mean&from=2026-07-01&to=2026-08-12"

Example Response

{
  "ipoId": "ipo-123",
  "symbol": "MILKYMIST",
  "interval": "5m",
  "field": "mean",
  "series": [
    {
      "timestamp": "2026-06-01T10:00:00.000Z",
      "price": 10
    },
    {
      "timestamp": "2026-06-01T14:00:00.000Z",
      "price": 20
    }
  ],
  "meta": {
    "from": "2026-07-01T00:00:00.000Z",
    "to": "2026-08-12T23:59:59.999Z",
    "count": 2
  }
}

Response Fields

Field	Type	Description
`ipoId`	string	Canonical IPO ID
`symbol`	string	Stock symbol / ticker
`interval`	string	Interval used for the series
`field`	string	Aggregation field used for the series
`series`	array	Ordered list of timeseries points
`series[].timestamp`	string	Bucket start time (ISO 8601)
`series[].price`	number \| null	Aggregated GMP value for the bucket, rounded to 2 decimal places
`meta.from`	string	Effective start of the queried range
`meta.to`	string	Effective end of the queried range
`meta.count`	number	Number of points in `series`

If the IPO exists but has no GMP data in the requested range, the API returns 200 with an empty series and meta.count of 0.

Errors

Status	When
`400`	Invalid `from`/`to`, or unsupported `interval` / `field`
`401`	Missing or invalid API key
`404`	No IPO found for the given `identifier`
`429`	GMP rate limit exceeded — see Rate Limits