# Nse Scanner

> NSE scans: top gainers/losers, volume surges, 52w highs/lows

- Skill: `taracodlabs/nse-scanner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add taracodlabs/nse-scanner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/taracodlabs/nse-scanner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: taracodlabs (https://skillmd.com/u/taracodlabs)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/taracodlabs/nse-scanner

---


# NSE Scanner

Scan the NSE equity market for top movers, volume spikes, and price extremes using NSE's publicly accessible JSON APIs — no API key required.

## When to Use

- User asks for today's top gainers or losers on NSE
- User wants stocks hitting 52-week highs or lows
- User asks for unusual volume activity or surge stocks
- User wants a quick market overview (advances vs declines)
- User asks "which Nifty 50 stocks are up/down today?"

## How to Use

### Top gainers on NSE today
```powershell
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
$session = Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers
$resp = Invoke-RestMethod -Uri "https://www.nseindia.com/api/live-analysis-variations?index=gainers" `
  -Headers $headers -WebSession $nse
$resp.NIFTY.data | Sort-Object pChange -Descending | Select-Object -First 10 |
  Select-Object symbol, ltp, netPrice, pChange
```

### Top losers on NSE today
```powershell
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
$session = Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers
$resp = Invoke-RestMethod -Uri "https://www.nseindia.com/api/live-analysis-variations?index=losers" `
  -Headers $headers -WebSession $nse
$resp.NIFTY.data | Sort-Object pChange | Select-Object -First 10 |
  Select-Object symbol, ltp, netPrice, pChange
```

### 52-week highs
```powershell
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
$session = Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers
$resp = Invoke-RestMethod -Uri "https://www.nseindia.com/api/live-analysis-variations?index=high52" `
  -Headers $headers -WebSession $nse
$resp.data | Select-Object symbol, ltp, pChange | Select-Object -First 20
```

### Nifty 50 snapshot
```powershell
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
$session = Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers
$resp = Invoke-RestMethod -Uri "https://www.nseindia.com/api/equity-stockIndices?index=NIFTY%2050" `
  -Headers $headers -WebSession $nse
$resp.data | Select-Object symbol, lastPrice, pChange, totalTradedVolume |
  Sort-Object pChange -Descending
```

### Market breadth (advances vs declines)
```powershell
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
$session = Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers
$resp = Invoke-RestMethod -Uri "https://www.nseindia.com/api/market-data-pre-open?key=ALL" `
  -Headers $headers -WebSession $nse
$resp.data | Group-Object { if ($_.metadata.pChange -gt 0) { "Advances" } else { "Declines" } } |
  Select-Object Name, Count
```

## Examples

**"Show me today's top 5 Nifty gainers"**
→ Fetch gainers API, filter NIFTY data, sort by `pChange` descending, display top 5 with symbol, LTP, and % change.

**"Any stocks hitting 52-week highs today?"**
→ Fetch `high52` endpoint and list symbols with their current price and % change.

**"How is the overall market today — more advances or declines?"**
→ Fetch pre-open market data, group by positive/negative pChange, show counts.

## Cautions

- NSE APIs require a session cookie obtained by first visiting `https://www.nseindia.com` — always initialize the session before API calls
- NSE may rate-limit or block automated requests; add a small delay between calls if running bulk scans
- Market data is available only during trading hours (Mon–Fri, 9:15 AM – 3:30 PM IST)
- API endpoints and response structure may change — verify against NSE website if calls fail