India Market Breadth Analyzer

Purpose

Market breadth measures how broadly a rally or decline is distributed across the market. A healthy market has broad participation — many stocks and sectors moving in the same direction. A narrow market, where only a few large-cap stocks are driving the index, is fragile and prone to reversal.

This skill provides a systematic framework to assess NSE/BSE breadth health, score it on a 0-100 composite scale, and translate it into actionable equity exposure recommendations.

Data Sources

Primary Sources

WebSearch

WebSearch

WebSearch

fetch_market_movers_and_trending_stocks_funds

YEARLY_HIGH

fetch_market_movers_and_trending_stocks_funds

YEARLY_LOW

get_ltp

get_ltp

fetch_market_movers_and_trending_stocks_funds

TOP_GAINERS

TOP_LOSERS

Broker MCP Tools Used

Use whichever broker MCP is connected (Groww or Zerodha Kite):

Groww MCP (if connected):

1. fetch_market_movers_and_trending_stocks_funds

   — Core tool for yearly highs/lows counts, top gainers/losers, volume data

2. get_ltp

   — Get live prices for Nifty, Bank Nifty, sector indices

3. fetch_historical_candle_data

   — Historical data for trend analysis

4. get_historical_technical_indicators

   — Calculate moving averages for breadth assessment

5. fetch_technical_screener

   — Screen for stocks by technical criteria (RSI, MACD, etc.)

6. fetch_fundamentals_screener

   — Natural language screening for market-cap based analysis

Zerodha Kite MCP (if connected):

1. get_ltp

   — Live prices for Nifty, Bank Nifty, sector indices

2. get_quotes

   — Real-time quotes with market depth

3. get_ohlc

   — OHLC data for indices and stocks

4. get_historical_data

   — Historical candle data for trend analysis

5. search_instruments

   — Search for instruments by name

Workflow

Step 1: Fetch NSE Advance/Decline Data

Use web search to get NSE advance/decline data:

WebSearch: "NSE advance decline ratio today"
WebSearch: "NSE market breadth today advances declines"

Key data points needed:

• Number of advances (stocks that closed higher)
• Number of declines (stocks that closed lower)
• Number of unchanged
• Total traded stocks

Step 2: Calculate Breadth Indicators

A/D Ratio

A/D Ratio = Number of Advances / Number of Declines

Interpretation:
  > 2.0:  Strong breadth (broad rally)
  1.5-2.0: Healthy breadth
  1.0-1.5: Neutral
  0.7-1.0: Weak breadth
  < 0.7:  Very weak (broad selling)

A/D Line (Cumulative)

A/D Line = Previous A/D Line + (Advances - Declines)

Rising A/D Line + Rising Nifty = Confirmed uptrend
Falling A/D Line + Rising Nifty = DIVERGENCE (warning)
Rising A/D Line + Falling Nifty = Accumulation (bullish)
Falling A/D Line + Falling Nifty = Confirmed downtrend

McClellan Oscillator Concept

A/D Difference = Advances - Declines
19-day EMA of A/D Difference (fast)
39-day EMA of A/D Difference (slow)
McClellan Oscillator = 19-day EMA - 39-day EMA

> 0:  Bullish breadth momentum
< 0:  Bearish breadth momentum
> +50: Overbought breadth
< -50: Oversold breadth

Step 3: Assess % of Stocks Above 200 DMA and 50 DMA

Use web search or screener tools:

WebSearch: "percentage of NSE stocks above 200 day moving average"

Or use Groww MCP technical screener to estimate:

fetch_technical_screener with various SMA/EMA filters

Key Thresholds

Step 4: Count New 52-Week Highs vs Lows (via Groww MCP)

Use Groww MCP tools:

# Fetch stocks hitting yearly highs
fetch_market_movers_and_trending_stocks_funds(
    discovery_filter_types=["YEARLY_HIGH"],
    size=20
)

# Fetch stocks hitting yearly lows
fetch_market_movers_and_trending_stocks_funds(
    discovery_filter_types=["YEARLY_LOW"],
    size=20
)

Interpretation

Step 5: Score Breadth Health (0-100 Composite)

The composite score is calculated from 5 components:

Component 1: Advance/Decline Ratio Score (0-25)

Also consider the 5-day and 20-day trend of A/D ratio:

• Improving trend: +2 bonus points
• Deteriorating trend: -2 penalty points

Component 2: Stocks Above 200 DMA Score (0-25)

Component 3: New Highs vs Lows Score (0-20)

Component 4: Sector Participation Score (0-15)

Count how many of the 13 major Nifty sectors are in an uptrend (above their 50 DMA or showing positive 1-month return):

13 Key NSE Sectors:

1. Nifty Bank
2. Nifty IT
3. Nifty Pharma
4. Nifty FMCG
5. Nifty Auto
6. Nifty Metal
7. Nifty Realty
8. Nifty Energy
9. Nifty Infrastructure
10. Nifty PSU Bank
11. Nifty Private Bank
12. Nifty Media
13. Nifty Financial Services

Component 5: Nifty Divergence Score (0-15)

This measures whether index performance aligns with underlying breadth.

Step 6: Map to Equity Exposure Recommendation

Health Zones

Exposure Adjustment Rules

1. Score improving for 5+ days: Can increase exposure by one zone level
2. Score deteriorating for 5+ days: Decrease exposure by one zone level
3. Score drops >15 points in a week: Emergency review — consider reducing exposure immediately
4. Score rises >15 points in a week: Wait for confirmation (3+ days) before increasing

Step 7: Generate Report

Use the template from

assets/breadth_report_template.md

1. Composite score and health zone
2. All 5 component scores with supporting data
3. Trend direction (improving/deteriorating)
4. Equity exposure recommendation
5. Divergence analysis
6. Historical context
7. Disclaimer

Quick Reference: NSE Sector Indices

Use these symbols with

get_ltp

Example Breadth Assessment

Date: 2025-03-10

COMPONENT SCORES:
  1. A/D Ratio: 1.8 (5-day avg: 1.5)          -> Score: 17/25
  2. Stocks above 200 DMA: ~55%                 -> Score: 17/25
  3. New Highs:Lows: 85:25 (3.4:1)             -> Score: 16/20
  4. Sectors in uptrend: 9/13                   -> Score: 12/15
  5. Nifty rising + breadth flat                -> Score: 10/15

  COMPOSITE SCORE: 72/100
  HEALTH ZONE: Healthy
  EQUITY EXPOSURE: 75-90%

RECOMMENDATION:
  Market breadth is healthy with broad participation. 9 of 13 sectors are
  in uptrend. A/D ratio has been above 1.0 for the past week. However,
  Nifty is making new highs while breadth is flat — watch for divergence.
  Maintain normal equity allocation but be ready to reduce if breadth
  starts deteriorating.

Divergence Detection — The Most Important Signal

What is Breadth Divergence?

When the Nifty 50 makes a new high but breadth indicators do not confirm, it signals that the rally is narrowing. This is the single most important breadth signal for risk management.

How to Detect

1. Nifty at 52-week high BUT advance/decline ratio < 1.5
2. Nifty at 52-week high BUT fewer new 52-week highs than at the previous Nifty high
3. Nifty at 52-week high BUT % above 200 DMA is declining
4. Nifty at 52-week high BUT fewer sectors participating than at previous high

Historical Examples (Indian Market)

Action on Divergence

India-Specific Nuances

• F&O Expiry Effects: Weekly and monthly F&O expiry Thursdays can distort breadth readings due to derivatives-related hedging and unwinding. Flag expiry-day breadth readings and consider using the non-expiry-day average for comparison.
• Budget and RBI Policy Weeks: Union Budget day and RBI monetary policy announcement days create abnormal breadth swings. Note these as event-driven rather than trend-driven.
• FII/DII Flow Correlation: Sustained FII selling often narrows breadth from the large-cap end first, while DII buying may support mid/small caps, creating a cap-tier divergence.
• SEBI Regulatory Impact: Regulations like small-cap mutual fund stress tests can cause episodic breadth disruptions in the small-cap tier — these are flow-driven, not fundamental.
• IPO Market as Breadth Proxy: A hot IPO market (high subscription rates, listing gains) often correlates with broad market risk appetite. A freeze in IPO activity can signal breadth contraction ahead.

Files in This Skill

• references/breadth_methodology.md

  — Comprehensive breadth analysis methodology for Indian markets

• assets/breadth_report_template.md

  — Structured report template for breadth analysis output