How shrewdlemon/holdermap-dashboard works
holdermap is a static dashboard for exploring share ownership, holders, price performance and company financials across NSE-listed companies. The user workflow starts with the searchable universe, opens a company page, then explores ownership trends, holder details, buyers and sellers, earnings, valuation and returns; evidence checks expose data-quality issues. The repository also contains a quarterly and daily data-preparation pipeline that supplies company and universe data to the app. The README documents several capabilities beyond the sampled UI excerpt, so those are represented at the feature level; unsampled implementation details and uncertain wiring are omitted.
Main entry points: co Company data · app.js Company pages · company.py Company data builder · export.py Data export
Components 20
Dashboard
- Company universe
src/app.js - Company pages
src/app.js - Ownership views
src/app.js - Holder flows
src/app.js - Evidence checks
src/app.js
Ownership Data
- Company data
src/co - Universe data
src/univ.json - Company data builder
pipeline/company.py - Holder source files
pipeline/inputs - Data export
pipeline/export.py
Market Data
- Price refresh
pipeline/live.py - Price inputs
pipeline/inputs - Index history
pipeline/index_hist.py
Financial Data
- Results collection
pipeline/results.py - Filing parsers
pipeline/nseresults - Quarterly results
pipeline/inputs/results
Other components
- Dashboard user
- Exchange filings and prices
- Fund disclosures
- Nifty history source
Connections 25
- Dashboard user → Company universe: searches
- Company universe → Company pages: opens company
- Company pages → Ownership views: shows ownership
- Company pages → Holder flows: shows activity
- Company pages → Evidence checks: shows checks
- Company data → Company pages: loads company data
- Universe data → Company universe: loads listings
- Ownership views → Company data: reads holdings
- Holder flows → Company data: reads holder changes
- Evidence checks → Company data: reads review flags
- Company data builder → Holder source files: reads inputs
- Company data builder → Company data: writes company data
- Company data builder → Universe data: writes universe
- Holder source files → Exchange filings and prices: includes filings
- Holder source files → Fund disclosures: includes disclosures
- Results collection → Exchange filings and prices: fetches results
- Results collection → Filing parsers: parses filings
- Results collection → Quarterly results: writes results
- Price refresh → Exchange filings and prices: fetches closes
- Price refresh → Price inputs: writes price inputs
- Index history → Nifty history source: fetches history
- Index history → Price inputs: writes index data
- Data export → Company data: writes app data
- Data export → Quarterly results: reads results
- Data export → Price inputs: reads prices