List Indian stocks showing sudden price moves, with price, net and percent change, OHLC, volume, circuit limits, deviation from average price and trend ratings.

View all Indian Stock Exchange API endpoints →

Returns the current price shocker list for Indian equities in one call with no input parameters. The documentation shows a flat array of entries with ticker (for example BPCL.NS), company, price, percent_change, net_change, high, low, open and volume as numbers. The stored sample response has a different shape: an object with two arrays, BSE_PriceShocker and NSE_PriceShocker, where every value is a string. In that sample the BSE array is empty and the NSE array holds entries dated 2024-06-21 with ric, tickerId, displayName, exchangeType, price, netChange, percentChange, open, high, low, close, volume, bid, ask, bidSize, askSize, yhigh, ylow, upCircuitLimit, lowCircuitLimit, lotSize, averagePrice, noOfDaysForAverage, deviation, actualDeviation, shortTermTrends, longTermTrends, overallRating, priceArrow, date, time and a logo imageUrl. Because the documented and sample shapes disagree and no live probe of this endpoint has been run in this catalog, parse defensively and convert string values to numbers yourself. From the sample numbers, percentChange compares price with the previous close, while actualDeviation is the signed percent gap between price and averagePrice over noOfDaysForAverage days and deviation is its absolute value.

API Features

Separate BSE and NSE shocker lists The sample splits results into BSE_PriceShocker and NSE_PriceShocker arrays, so you can handle each exchange on its own; the BSE array was empty in the sample, which your code should treat as valid.
Deviation from the recent average price averagePrice, noOfDaysForAverage (12 in the sample), deviation and actualDeviation show how far the price sits from its recent average, with actualDeviation keeping the sign.
Quote context on every shocker Each entry carries price, netChange, percentChange, open, high, low, close, volume, bid, ask and their sizes, enough to judge a move without a second quote request.
Circuit band and yearly range per entry upCircuitLimit, lowCircuitLimit, yhigh and ylow are returned alongside the price, so you can see how close a shocker is to its price band or its yearly extremes.
Trend labels and ticker identifiers shortTermTrends, longTermTrends and overallRating (Bullish in the sample) come with a ric such as BPCL.NS and a tickerId such as S0003060 for joining to your own symbol tables.

Live API Demo

GET /api/project/indian-stock-exchange-api/price-shockers

No parameters required. Click Query to call the API.

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/price-shockers?key=<API_KEY>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Does the price shockers endpoint take any parameters?

No. It is a plain GET /price_shockers with no query, path or body parameters. Filter by exchange, ticker or volume on your side after the response arrives.

What does the response look like?

The documentation shows a flat array of entries with ticker, company, price, percent_change, net_change, high, low, open and volume. The stored sample instead returns an object with BSE_PriceShocker and NSE_PriceShocker arrays and many more fields, all as strings. No live probe has verified which shape is returned today, so handle both.

Why are the numbers strings in the sample?

In the stored sample every value, including price, percentChange and volume, is a string such as 309.15. The documented example uses numbers. Convert explicitly before sorting or comparing, and treat null values such as averageVolume as missing.

What do deviation and actualDeviation mean?

The evidence does not define them, but the sample numbers fit this reading: actualDeviation is the signed percent difference between price and averagePrice over noOfDaysForAverage days (309.15 against 611.25 gives -49.42 for BPCL.NS) and deviation is the absolute value. percentChange is a separate figure against the previous close.

Why can a stock show a large deviation but a small percentChange?

They measure different things. In the sample, BPCL.NS has percentChange -1.27 but deviation 49.42, because deviation compares the price with a 12-day average price rather than the previous close. The evidence does not explain a gap that large, so check percentChange and volume together before acting on deviation alone.

Why is BSE_PriceShocker empty?

In the stored sample the BSE array is empty while the NSE array has entries. The evidence does not say whether that means no BSE shockers at the time or missing data, so treat an empty array as a valid result rather than an error.

How fresh is the shocker list?

Each sample entry carries a date and a time, for example 2024-06-21, but the evidence does not give the time zone or the update interval. Use the date and time fields to check staleness, and note this is an informational market snapshot rather than a licensed tick feed.

Related operations

Guides

View Subscription Plans →