List market alerts

GET /v1/alerts

Returns alerts filtered by symbol, scrip code, alert type, date range, curated importance flag, and pagination.

When to use it

Use this endpoint for notifications, alert dashboards, watchlist monitors, and live operations queues.

Known public alert types:

52w_high — 52-week high milestone
52w_low — 52-week low milestone
earnings — Earnings or results release
high_growth_concalls — High-growth conference call commentary
price_alert — Intraday price move
rvol_alert — Relative volume spike
volume_alert — Unusual volume

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: 5 credits / page. Bills 5 credits per page when results are returned. Empty pages are not charged.
See pricing for plan allowances and full billing details.

Request

This endpoint does not require a request body.

Field	Location	Required	Notes
`symbols`	query	No	Optional comma-separated values such as `RELIANCE,TCS` or repeated query parameters. Maximum 20 symbols.
`scrip_codes`	query	No	Optional comma-separated values such as `500325,532540` or repeated query parameters. Maximum 20 scrip codes.
`type`	query	No	Optional alert-type filter. Accepts comma-separated values or repeated query parameters. Maximum 10 types. Known public types: `52w_high`, `52w_low`, `earnings`, `high_growth_concalls`, `price_alert`, `rvol_alert`, `volume_alert`. Filter aliases `52w_high_60` and `52w_low_60` are also accepted.
`from`	query	No	Optional ISO date or datetime lower bound.
`to`	query	No	Optional ISO date or datetime upper bound.
`important`	query	No	Set `true` to return only higher-signal alerts from the curated feed.
`page`	query	No	Page number. Defaults to `1`.
`limit`	query	No	Page size. Defaults to `20`, maximum `50`.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns data as alert records and has_next for pagination. Each alert includes a canonical UTC timestamp for the alert creation time, public type, and meta.primary_drivers; price alerts also include delayed price.value, signed price.change_percent, and price.as_of for the price observation time.

Show Schema

Successful Responseapplication/json

{
  "data": [
    {
      "id": "6a016065e1eff9fbc809fe3e",
      "symbol": "SUNPHARMA",
      "type": "52w_high",
      "reason": "The stock reached a new 52-week high following a favorable trademark ruling, reaffirmed AAA ratings, and continuity in board governance.",
      "timestamp": "2026-05-11T10:21:49.078000+00:00",
      "meta": {
        "primary_drivers": [
          "Bharat Forge: Signs Agreement With Andhra Pradesh Government For India's First Private Marine Gas Turbine Facility In Visakhapatnam"
        ]
      }
    },
    {
      "id": "6a01605de1eff9fbc809fe3c",
      "symbol": "EMMVEE",
      "type": "price_alert",
      "reason": "Guidance pointed to FY27 EBITDA of Rs 2200 to 2400 crore, but the current move lacks a contemporaneous catalyst.",
      "timestamp": "2026-05-11T10:21:41.337000+00:00",
      "price": {
        "value": 177.6,
        "change_percent": 4.01,
        "as_of": "2026-05-11T10:06:41.337000+00:00"
      },
      "meta": {
        "primary_drivers": []
      }
    }
  ],
  "has_next": true
}

Request pattern

curl -G "https://developers.manasija.in/v1/alerts" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "symbols=INFY" \
  --data-urlencode "important=true" \
  --data-urlencode "limit=25"

JavaScript / TypeScript SDK

const alerts = await client.getAlerts({
  symbols: ["INFY"],
  important: true,
  limit: 25,
})

Python SDK

alerts = client.get_alerts(
    symbols=["INFY"],
    important=True,
    limit=25,
)

Interactive reference

Use the Scalar API client for executable requests, schemas, and the full OpenAPI contract.