pp-NSE India

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/developer-tools/nse-india/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# NSE India — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `nse-india-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install nse-india --cli-only
   ```
2. Verify: `nse-india-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/developer-tools/nse-india/cmd/nse-india-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Use nse-india-pp-cli when you need Indian equity data in a script, cron job, or AI agent workflow without Python dependencies. It is the right choice for portfolio monitoring, corporate action alerts, sector rotation analysis, and any workflow that needs to join quote data across multiple symbols or time periods.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Local state that compounds
- **`delivery-spike`** — Flags stocks where today's delivery-to-traded ratio is significantly above their 20-session rolling average — early signal of institutional accumulation.

  _Use when you want to detect institutional accumulation before price follows — the delivery spike precedes moves 2-3 sessions earlier than price action alone._

  ```bash
  nse-india-pp-cli delivery-spike --threshold 2.0 --agent
  ```
- **`iep-drift`** — Tracks how accurately each stock's pre-market IEP (Indicative Equilibrium Price) predicts the actual opening price over 30 sessions.

  _Use in pre-market to know which IEP signals are reliable for that day's gap-open strategy._

  ```bash
  nse-india-pp-cli iep-drift --lookback 30 --min-gap 1.5 --agent
  ```
- **`announcement-flood`** — Surfaces companies whose filing cadence has spiked above their own historical baseline — a leading indicator of imminent corporate actions like rights issues or mergers.

  _Use when monitoring for surprise corporate actions — a flood of exchange filings reliably precedes announcements by 3-7 days._

  ```bash
  nse-india-pp-cli announcement-flood --window 7d --threshold 3 --agent
  ```
- **`portfolio pnl`** — Tracks unrealized P&L, daily delta, and drawdown for a personal holdings file against the synced quote history.

  _Use when an agent needs to report portfolio performance or trigger rebalancing alerts without a brokerage integration._

  ```bash
  nse-india-pp-cli portfolio pnl --holdings holdings.csv --agent
  ```
- **`portfolio margin-health`** — Aggregates VaR margin, extreme loss margin, and adhoc margin across a full portfolio — shows total margin-at-risk and which holdings are the biggest margin consumers.

  _Use before market open to check whether overnight VaR changes have pushed margin utilization above a safe threshold._

  ```bash
  nse-india-pp-cli portfolio margin-health --holdings holdings.csv --agent
  ```
- **`delivery-divergence`** — Detects when price is rising but delivery % is falling (distribution signal) or price falling while delivery is rising (accumulation signal) — separates smart money from retail.

  _Use when evaluating whether a trend is sustainable — delivery divergence at a peak is the single clearest distribution signal available from public data._

  ```bash
  nse-india-pp-cli delivery-divergence --lookback 10 --agent
  ```

### Agent-native plumbing
- **`sector-breadth`** — Computes advance/decline ratio, median pChange, and delivery breadth for every constituent of a named index — far richer than the index headline number.

  _Use when deciding whether an index move is broad-based or driven by one or two large caps — changes the conviction of a trade._

  ```bash
  nse-india-pp-cli sector-breadth --sector IT --agent
  ```
- **`index-driver`** — Decomposes any day's index move into per-stock point contributions — identifies the 3-5 stocks driving 80%+ of the index change.

  _Use when the index move looks misleading — tells an agent whether a rally is concentrated (single-stock risk) or genuinely broad._

  ```bash
  nse-india-pp-cli index-driver --index "NIFTY 50" --agent
  ```

## Command Reference

**corporate** — Corporate actions, filings, and financial data

- `nse-india-pp-cli corporate actions` — Corporate actions history — dividends, bonuses, splits, rights with ex-dates and record dates
- `nse-india-pp-cli corporate announcements` — Exchange filings — board meetings, results, AGM, investor meets, disclosure intimations
- `nse-india-pp-cli corporate annual_reports` — Annual reports with direct PDF download URLs, going back multiple years
- `nse-india-pp-cli corporate financial_results` — Quarterly and annual financial result filings with XBRL links
- `nse-india-pp-cli corporate insider_trading` — SEBI PIT (Prohibition of Insider Trading) disclosures — promoter/director buy/sell with quantities, values,...

**equity** — Comprehensive equity quote data for NSE-listed stocks

- `nse-india-pp-cli equity derivatives` — F&O data — futures (3 expiries with OI, volume, turnover) and options contracts (CE/PE by strike and expiry)
- `nse-india-pp-cli equity quote` — Full equity quote — last price, 52w H/L, sector PE, order book (5 bid/ask levels), delivery%, VaR margin, index...

**indices** — NSE index data and constituents

- `nse-india-pp-cli indices constituents` — Live prices for all constituent stocks in an index with 52w range, 1Y/30D% change
- `nse-india-pp-cli indices list` — List all available NSE indices with short and long names

**market** — Market status and operational information

- `nse-india-pp-cli market` — Real-time market status for all segments (Capital Market, Currency, F&O, WDM) with current NIFTY level

**movers** — Market activity rankings

- `nse-india-pp-cli movers` — Most active intraday securities ranked by volume or traded value

**symbol_lookup** — Symbol search and autocomplete

- `nse-india-pp-cli symbol_lookup` — Search symbols by company name or ticker — returns equity, MF, index matches


### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
nse-india-pp-cli which "<capability in your own words>"
```

`which` resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code `0` means at least one match; exit code `2` means no confident match — fall back to `--help` or use a narrower query.

## Recipes


### Find stocks near 52-week extremes from a synced index

```bash
nse-india-pp-cli indices constituents --index "NIFTY 50" --json --agent | jq '.results.data[] | select(.nearWKH < 5)'
```

Filters index constituents within 5% of their 52-week high using live NSE data — no extra command needed

### Dail