# FII & DII Data India — by Mr. Chartist
# https://fii-diidata.mrchartist.com

## What is this?
This is India's most comprehensive free, real-time tracker for FII (Foreign Institutional Investor) and DII (Domestic Institutional Investor) institutional money flows in the Indian equity markets. Built and maintained by @mr_chartist.

## What data does it provide?
- Daily FII/DII net buy/sell figures (Rs Crore) from NSE
- F&O (Futures & Options) derivatives positioning — index futures, calls, puts, stock futures
- Sector-wise FPI (Foreign Portfolio Investor) allocation across 24 Indian sectors (NSDL data)
- 45-day concentration heatmaps to spot buying/selling streaks
- Weekly, monthly, and annual aggregated flow matrices
- NIFTY 50 and INDIA VIX live index levels (Yahoo Finance proxy)
- Put-Call Ratio (PCR) and derived sentiment score

## Who is this for?
Indian equity traders, fund managers, retail investors, financial analysts, and market researchers who want to understand institutional money movement in the Indian stock market.

## Key Terms & Definitions
- FII / FPI: Foreign Institutional Investor / Foreign Portfolio Investor. International money managers investing in India via SEBI-regulated channels.
- DII: Domestic Institutional Investor. Indian mutual funds (AMCs), insurance companies (LIC, HDFC Life), and public banks.
- Net Flow: Gross purchases minus gross sales in Rs Crore. Positive = net buying; Negative = net selling.
- Nifty 50: India's benchmark large-cap index of 50 stocks listed on NSE.
- F&O Open Interest: Total number of outstanding futures/options contracts held by FII/DII participants.
- PCR (Put-Call Ratio): Ratio of put open interest to call open interest. PCR > 1.2 = bearish sentiment; PCR < 0.8 = bullish.
- Sector Heatmap: Fortnightly FPI flow by sector (24 BSE sectors), sourced from NSDL depository records.
- Flow Strength Meter: Visual indicator showing the relative aggression of FII vs DII activity for the session.

## Data Sources
- NSE India (National Stock Exchange): daily cash market participant data
- NSE F&O archive: participant-wise open interest CSVs
- NSDL (National Securities Depository Limited): fortnightly sector allocation
- Yahoo Finance (proxied server-side): NIFTY 50 index and India VIX

## Update Schedule
- Cash market FII/DII flows: Daily, Mon-Fri, after 6:00 PM IST
- F&O positioning: Daily, Mon-Fri
- Sector allocation (NSDL): Fortnightly

## Technical Architecture
- Backend: Node.js + Express.js server with node-cron scheduled jobs
- Frontend: Vanilla JS single-page app with Chart.js 3.9.1
- Storage: JSON flat-file (history.json, sectors.json)
- PWA: Service Worker enabled for mobile installation

## Contact & Attribution
- Author: Mr. Chartist
- Twitter/X: https://twitter.com/mr_chartist
- Website: https://mrchartist.com
- GitHub: https://github.com/MrChartist/fii-dii-data
- Dashboard: https://fii-diidata.mrchartist.com

## License
Free for personal, research, and educational use. Data sourced from public NSE/NSDL reports.