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
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/indian-stock-exchange-api/price-shockers No parameters required. Click Query to call the API.
API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/price-shockers?key=<API_KEY>'
Query Result
Use Cases
- Fire a Telegram alert the first time a name from your holdings appears in the price shocker list.
- Join the shocker list to open positions on a risk desk screen and sort by netChange to see which exposures moved most.
- Run a news-correlation job that searches headlines for each newly listed shocker and attaches the first match to the alert.
- Apply a real-move versus thin-trade filter that keeps shockers only when volume is also large.
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.