Get the current top gaining and top losing Indian stocks with price, percent change, circuit limits, trend labels and 52-week range.

View all Indian Stock Exchange API endpoints →

Returns a snapshot of the top gaining and top losing Indian stocks as one JSON object. The request takes no parameters, and no exchange, count or sector filter is documented. The body has a single trending_stocks container with two arrays, top_gainers and top_losers. Observed in a live probe (HTTP 200): each array held 10 rows, every value inside a row was a string, and the rows in a list shared the same keys: ticker_id, company_name, price, percent_change, net_change, open, high, low, close, bid, ask, bid_size, ask_size, volume, low_circuit_limit, up_circuit_limit, year_low, year_high, date, time, lot_size, exchange_type, ric, overall_rating, short_term_trends, long_term_trends and total_share_outstanding. In that probe every row had exchange_type NSI and a ric ending in .NS, top_gainers started with the largest positive percent_change, top_losers started with the most negative one, and the trend fields carried labels such as Bullish, Moderately Bullish, Neutral, Moderately Bearish and Bearish. The documentation differs from the probe in three ways that should be treated as unverified: it says each list has the top 3 stocks, its sample rows are BSE rows with ric values ending in .BO, and it lists the extra fields average_price, average_volume, deviation, actual_deviation and no_of_days_for_average, which did not appear in the probed rows. The documentation also says null values are removed from the response, so optional fields may be absent. The data is an informational market snapshot, not an execution or licensed tick feed.

API Features

Gainers and losers in one call A single request returns trending_stocks.top_gainers and trending_stocks.top_losers together, so a market-mood widget gets both sides of the day without calling two routes.
Ranked by percent change In the probe the gainers list began with the largest positive percent_change and the losers list with the most negative, so the first row of each array is the biggest mover without extra sorting.
Zero parameters to manage The endpoint takes no query or path inputs, which keeps scheduled jobs, spreadsheet refreshes and bot commands trivial because there is nothing to validate or encode.
Upper and lower circuit limits Each row carries low_circuit_limit and up_circuit_limit next to price, so you can see how much room a mover has before it hits its exchange price band.
Overall, short-term and long-term trend labels overall_rating, short_term_trends and long_term_trends hold text labels from Bullish to Bearish on every row, which lets a screen show whether a big move agrees with the wider trend.
Intraday quote and book fields per row Rows include open, high, low, close, bid, ask, bid_size, ask_size, volume, date and time, giving enough quote context to render a mover card without a follow-up lookup.
Identifiers for joining other data ticker_id, ric, company_name and lot_size on each row, together with year_low and year_high, let you match movers to your own watchlist or to other endpoints in the catalog.

Live API Demo

GET /api/project/indian-stock-exchange-api/get-trending-stocks

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/get-trending-stocks?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 this endpoint accept any parameters?

No. The request is a plain GET to /trending with no query parameters, and the documentation does not describe any exchange, sector or result-count filter. If you need one exchange or a different ranking, use a dedicated endpoint such as the BSE or NSE most active lists or the price shockers list instead.

How many stocks are in each list?

The documentation says the top 3 gainers and top 3 losers, but the probe returned 10 rows in top_gainers and 10 in top_losers. Treat the length as variable and loop over whatever the arrays contain instead of hard-coding a count.

Are the movers from BSE or NSE?

The documentation sample shows BSE rows with ric values ending in .BO, while the probe returned rows with exchange_type NSI and ric values ending in .NS. The exchange is not selectable, so read exchange_type and the ric suffix on each row instead of assuming one exchange.

Why are all the numbers returned as strings?

In the probe every value in every row, including price, percent_change, volume and the circuit limits, was a string. Convert them to numbers in your client before sorting or calculating. The documentation also states that null values are removed, so a field you expect may be missing from some rows.

Why do average_price and deviation not appear in my response?

The documentation lists average_price, average_volume, deviation, actual_deviation and no_of_days_for_average, but the probed rows did not include them. They appear to be optional, so check that a key exists before reading it. The probed rows did include total_share_outstanding, which the documentation does not list.

How are top_gainers and top_losers ordered?

The documentation says the lists are ranked by percent change. In the probe, top_gainers began with the largest positive percent_change and top_losers began with the most negative value, so the first element of each array was the strongest move. If your logic depends on this, sort on percent_change yourself as a safeguard.

How fresh is the data and can I trade on it?

Each row has date and time fields so you can see when the quote was stamped, but no refresh interval is documented. Use the response as an informational market snapshot for dashboards, bots and research, not as an execution feed or a licensed tick source.

How is this different from the most active and price shockers endpoints?

This endpoint ranks stocks by percent change and returns only gainers and losers. The most active endpoints rank by trading volume, and the price shockers endpoint focuses on stocks whose price deviates sharply from a recent average, so each answers a different screening question.

Related operations

Guides

View Subscription Plans →