hdfcsec.com APIhdfcsec.com ↗
Access real-time NSE/BSE equity data via the HDFC Securities API: top gainers, losers, 52-week highs/lows, index overviews, stock quotes, and more.
curl -X GET 'https://api.parse.bot/scraper/b58bc736-5f89-43ac-b79d-9cc4508f29fb/get_most_active_nse_stocks?index=20559&period=I&exchange=NSE' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the most active stocks for a given exchange and index. Returns stocks sorted by trading volume.
| Param | Type | Description |
|---|---|---|
| index | string | Index code (e.g., 20559 for Nifty 50, 20558 for Sensex) |
| period | string | Time period: I (Intra Day), W (Week), M (Month) |
| exchange | string | Exchange: NSE or BSE |
{
"type": "object",
"fields": {
"data": "array of stock objects with stock_name, symbol, ltp, change, percent_change, day_low, day_high, volume, co_code, isin"
},
"sample": {
"data": [
{
"ltp": "796.05",
"isin": "INE040A01034",
"change": "-0.50",
"symbol": "",
"volume": "46137553",
"co_code": "4987",
"day_low": "788.55",
"day_high": "801.55",
"stock_name": "HDFC Bank Ltd",
"percent_change": "-0.06"
}
],
"status": "success"
}
}About the hdfcsec.com API
The HDFC Securities API exposes 8 endpoints covering Indian equity market data from hdfcsec.com, including intraday and weekly price movements across NSE and BSE. You can pull most active stocks by volume, rank gainers and losers by percent change, retrieve 52-week high/low breakouts, or call get_stock_quote to get a single stock's market cap, open, previous close, and 52-week range in one response.
Endpoints and Coverage
The API covers eight distinct market data endpoints. get_most_active_nse_stocks, get_top_gainers_nse, and get_top_losers_nse all share the same core response shape — arrays of stock objects including stock_name, symbol, ltp (last traded price), change, percent_change, day_low, day_high, volume, co_code, and isin. All three accept an exchange parameter (NSE or BSE), an index parameter using numeric codes (e.g., 20559 for Nifty 50, 20558 for Sensex), a period parameter (I for intraday, W for week, M for month), and a limit parameter on the gainers/losers endpoints.
Stock Quotes and Search
get_stock_quote accepts a symbol string (e.g., INFY, RELIANCE, TCS) and returns a detailed object that adds open, prev_close, market_cap, fifty_two_wk_high, fifty_two_wk_low, and sector information on top of the standard price fields. search_stock accepts a free-text query for name or symbol lookup and returns matching stocks with stock_name, co_code, ltp, change, percent_change, isin, and exchange — useful for resolving a company name to its trading symbol before calling the quote endpoint.
52-Week Extremes and Index Overview
get_52_week_high_stocks and get_52_week_low_stocks return stocks currently at their highest or lowest price over the trailing year. Both accept optional index and exchange filters. The response includes prev_day_high or prev_day_low alongside the standard price and volume fields, letting you compare the current print against the prior session's extreme. get_equity_market_overview returns an array of all available indices for a given exchange, with index_name, index_code, ltp, change, and percent_change — a quick way to snapshot overall market direction before drilling into individual stocks.
- Screen for momentum stocks by calling get_top_gainers_nse with period=I to find intraday leaders on Nifty 50
- Build a 52-week breakout watchlist using get_52_week_high_stocks filtered to a specific index
- Display a market dashboard using get_equity_market_overview to show all NSE/BSE index levels and changes
- Look up a stock's ISIN and co_code via search_stock before cross-referencing with other financial data sources
- Monitor unusual volume activity by sorting get_most_active_nse_stocks results by the volume field
- Populate a stock detail page with get_stock_quote to show market cap, 52-week range, and sector alongside live price
- Identify oversold candidates by filtering get_top_losers_nse over a weekly period across BSE
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.