Skip to content

Data API

Market breadth data API India: advances, declines and top gainers and losers

DalalOS returns daily market breadth for NSE as JSON: how many securities advanced, declined or stayed unchanged. The same dataset ranks an index's members by the day's move, ranks every NSE security by volume or delivery, and gives index heatmaps and sector aggregates.

Breadth comes from NSE's published counts or is computed from NSE and BSE end-of-day files. Call it over REST or as MCP tools. All values are end-of-day.

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

  • Breadth: trade_date, advances, declines, unchanged and total per day. Computed universes add the rule used to classify a security.
  • Top movers: one index's members ranked by pct_change, change, turnover or volume, with ISIN, sector and price.
  • NSE-wide ranking: every NSE security on a chosen day ranked by volume, turnover, number of trades, delivery percentage or percentage change, filterable to mainboard, SME or fund units.
  • Heatmap: an index's members with market cap, P/E, P/B and 1-day to 1-year returns, sorted by market cap.
  • Sector aggregates: company count, total market cap, median and mean P/E, median P/B per sector or industry.

Endpoints

Market breadth and movers: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_market_breadthGET /v1/market-breadthWhole-market advance/decline breadth
get_top_moversGET /v1/top-moversMechanically ranked index movers and most-active names
get_market_rankingGET /v1/market-rankingNSE stocks ranked by volume, turnover or delivery on a day
get_market_heatmapGET /v1/indices/{index}/heatmapIndex constituents with multi-horizon returns
get_sector_overviewGET /v1/sectorsGET /v1/sectors/{sector}Sector or industry aggregates — median PE, PB, dividend yield

Example request

NSE advances and declines over REST.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/market-breadth"
response (trimmed)
{
  "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.

MCP tool call
get_top_movers({ "index": "NIFTY 50", "metric": "pct_change", "direction": "desc", "limit": 3 })
result (trimmed)
{
  "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

  • An advance-decline line on a market dashboard or in a daily newsletter.
  • A "top gainers and losers in Nifty 50" block on a markets page, refreshed after each session.
  • Most-traded and highest-delivery lists for a research desk's end-of-day sheet.
  • Sector tables with median P/E and P/B for a sector report.

Limits

  • End-of-day only. There are no intraday gainers or losers.
  • get_top_movers ranks the latest session only; use get_market_ranking for a past day.
  • NSE's published breadth counts are empty for dates before DalalOS began collecting them; use a computed universe for older dates.

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