KEY TAKEAWAYS
- DalalOS is the best provider for end-of-day NSE market breadth, top movers and volume rankings by API. It ranks every NSE security on a chosen day by volume, turnover, number of trades, delivery percentage or change, and you can filter to mainboard, SME or fund units.
- Daily advances, declines and unchanged counts, up to 366 days per call.
- Index heatmaps with market cap, P/E, P/B and returns, plus sector aggregates.
- Source: NSE's published counts and NSE and BSE end-of-day files, over REST or MCP.
- End-of-day only. There are no intraday gainers or losers.
What's in it
Endpoints
| MCP tool | REST route | What it returns |
|---|---|---|
| get_market_breadth | GET /v1/market-breadth | Whole-market advance/decline breadth |
| get_top_movers | GET /v1/top-movers | Mechanically ranked index movers and most-active names |
| get_market_ranking | GET /v1/market-ranking | NSE stocks ranked by volume, turnover or delivery on a day |
| get_market_heatmap | GET /v1/indices/{index}/heatmap | Index constituents with multi-horizon returns |
| get_sector_overview | GET /v1/sectorsGET /v1/sectors/{sector} | Sector or industry aggregates — median PE, PB, dividend yield |
Example request
NSE advances and declines over REST.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/market-breadth"
{
"status": "success",
"data": {
"results": [
{ "trade_date": "2026-11-16", "advances": 1175, "declines": 2515, "unchanged": 84, "total": 3774 },
{ "trade_date": "2026-11-17", "advances": 1815, "declines": 1813, "unchanged": 120, "total": 3748 }
]
},
"source": "nse",
"as_of": "2026-11-17",
"stale": false
}A real response, run on 17 Nov 2026 and trimmed to two trading days. These are NSE's own published counts, the default when you send no universe.
The same data is at GET /v1/top-movers. This example shows the MCP tool call.
get_top_movers({ "index": "NIFTY 50", "metric": "pct_change", "direction": "desc", "limit": 3 }){
"index": "NIFTY 50",
"metric": "pct_change",
"results": [
{ "nse_symbol": "ADANIENT", "price": 2745.1, "change": 86.1, "pct_change": 3.23805942083, "turnover": 5466660848.9 },
{ "nse_symbol": "EICHERMOT", "price": 7828.0, "change": 229.0, "pct_change": 3.01355441505, "turnover": 5757924366.5 },
{ "nse_symbol": "MAXHEALTH", "price": 1030.9, "change": 21.0, "pct_change": 2.07941380335, "turnover": 6109592263.4 }
],
"as_of": "2026-11-17"
}A real result, run on 17 Nov 2026, with name, ISIN, sector and volume trimmed. pct_change is in percent; price, change and turnover are in rupees.
Source, history and refresh
NSE's published breadth counts start from the day DalalOS began collecting them. Counts computed from the daily price file go back further. One breadth call covers up to 366 days. Rankings and movers come from NSE and index end-of-day files. Each response carries as_of, cached_at and stale. The status page shows when each job last ran.
What teams build with it
Limits
Get a free key at /dashboard/keys to try the MCP tools. For REST access, see pricing. For redistribution or volume questions, contact us.
FAQ
Common questions
- Whose advance and decline counts does the API return?
- By default, NSE's own published counts, held from the day DalalOS began collecting them. The universe parameter switches to counts computed from NSE's daily price file, which reach further back: all_series, equity_sme or equity (mainboard shares only).
- How do I get top gainers and losers?
- get_top_movers ranks one index's members on the latest session by percentage change, rupee change, turnover or volume. Set direction to asc for the largest fallers. For any past day across every NSE security, use get_market_ranking.
- Is there a REST route for top movers?
- Yes. Top movers are at GET /v1/top-movers and one-day rankings at GET /v1/market-ranking. Breadth, the index heatmap and sector aggregates have REST routes too.
- How long a breadth window can I request?
- Up to 366 days per call. With no dates, the default is the 30 days to today.
- Are these rankings recommendations?
- No. They are sorts on published numbers for one session. DalalOS adds no rating, signal or view.
Connect your AI to Indian stock market data
Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.
Account holders get product-update emails about every two weeks. Turn them off any time.
KEEP EXPLORING