Bhala-Srinivash/nse-trading-skills

# Fibonacci Trading

Fibonacci levels identify high-probability zones where price tends to react — for entries on pullbacks and targets on extensions.

## Prerequisites

No dependencies required. Just provide a swing high and swing low price — Claude calculates all Fib levels instantly. Enhanced with Groww MCP (auto-identifies swings from candles) or yfinance.

## Data Needed

1. **Swing high and swing low**: From `fetch_historical_candle_data` or user-provided prices
2. **Current price**: `get_quotes_and_depth` from Groww, or user-provided
3. For precise calculation, you can compute in Python:
   ```python

# Multi-Timeframe Analysis

Higher timeframes set the direction. Lower timeframes refine the entry. Never trade against the higher timeframe trend unless you have very strong reasons.

## The 3-Screen Method

| Screen | Timeframe | Purpose | What to Look For |
|--------|-----------|---------|-----------------|
| Screen 1 | **Weekly** | Trend bias | Primary trend, major S/R, 200-week MA |
| Screen 2 | **Daily** | Setup | Pattern formation, indicator signals, entry zone |
| Screen 3 | **4H / 1H** | Entry timing | Precise entry price, tight stop placement |

### How to use it:
1. **Weekly decides direction** — only take trades in the weekly trend's direction

# NSE Trading Toolkit — Orchestrator

This is the master workflow that coordinates 8 specialized trading framework skills for Indian NSE/BSE equities.

## Prerequisites

All skills work standalone with zero dependencies — they're prompt-based frameworks that Claude applies during analysis. Connecting data sources makes them more powerful:

| Data Source | Required? | What It Adds | Setup |
|------------|-----------|-------------|-------|
| **Groww MCP** | Optional | Live quotes, portfolio, technical indicators, candle data, order placement | Add to `.mcp.json` (see README) |
| **yfinance** | Optional | Historical OHLCV (>6 months), backtesting | `pip install yfinance` |
| **TradingView MCP** | Optional | Crypto screening, volume scanners | See [tradingview-mcp](https://github.com/pab-s/tradingview-mcp) |

# Position Sizing

Position sizing is how you survive. The goal: risk a small, consistent percentage of capital per trade so that no single loss can cripple your account.

## Prerequisites

No dependencies required. Works with manually provided prices. Enhanced with Groww MCP (live price, ATR, portfolio) or yfinance (`pip install yfinance`).

## Data Needed

1. **Account size**: Total trading capital (ask user if not known)
2. **Current price**: `get_quotes_and_depth` from Groww, or user-provided
3. **ATR(14)**: `get_historical_technical_indicators` from Groww, or calculate from candle data
4. **Existing positions**: `get_equity_portfolio_holdings` to check concentration (optional)

# Risk-Reward Ratio

If the math doesn't work, don't take the trade. R:R is the simplest filter that separates good setups from bad ones.

## Prerequisites

No dependencies required. Pure math — provide entry, stop, and target prices. No data tools needed.

## Calculation

```
Risk = Entry price - Stop-loss price
Reward = Target price - Entry price
R:R = Reward ÷ Risk

# RSI Divergence

Divergences signal that momentum is fading — price is moving one way but the engine (RSI) is losing steam. They're early warnings, not guarantees.

## Prerequisites

No dependencies required. Describe price and RSI patterns verbally and Claude identifies divergences. Enhanced with Groww MCP (RSI values, candles) or yfinance (`pip install yfinance`).

## Data Needed

1. **Daily candles**: `fetch_historical_candle_data` (last 90-120 days) or user-provided
2. **RSI(14) values**: `get_historical_technical_indicators` from Groww
3. For manual calculation via yfinance if needed:
   ```python

# Stop-Loss Strategies

A stop-loss is not optional. Every position needs one before entry. The purpose is to cap your maximum loss — not to predict where price will go.

## Prerequisites

No dependencies required. Provide entry price and key levels manually. Enhanced with Groww MCP (candles, ATR, MAs) or yfinance (`pip install yfinance`).

## Data Needed

1. **Entry price**: Known or planned
2. **Recent candles**: `fetch_historical_candle_data` (daily, last 60 days) or user-provided levels
3. **ATR(14)**: `get_historical_technical_indicators` from Groww, or calculate manually
4. **Key S/R levels**: From technical-analysis skill or swing highs/lows

# Technical Analysis

Read the chart systematically — don't cherry-pick indicators that confirm a bias.

## Prerequisites

No hard dependencies. Works best with Groww MCP or yfinance for live data, but can analyze any stock if you provide prices manually.

## Data Collection

When data tools are available, fetch in this order:

1. **Resolve symbol**: `search_stock_and_others_symbol` on Groww
2. **Live quote**: `get_quotes_and_depth` for current price, volume, day range

# Trailing Stops

Once a trade is profitable, trailing stops protect your gains while letting winners run.

## Prerequisites

No dependencies required. Provide entry, current price, and ATR manually. Enhanced with Groww MCP (live ATR, candles, MAs) or yfinance.

## Data Needed

1. **Entry price and current price**: Known or from `get_quotes_and_depth`
2. **ATR(14)**: `get_historical_technical_indicators` from Groww, or user-provided
3. **Recent swing lows/highs**: `fetch_historical_candle_data` (daily)
4. **Moving averages**: SMA20, EMA50 from indicators