Data to 20 November 2026
About

Methods

Company names for NSE symbols: methods

Lists of stocks on the site (the day’s movers, the results calendar, index holdings) hold NSE symbols. The bundle markets/listed_equities gives every listed equity a company name, so a page can print “Paras Healthcare” instead of “PARASHLTH”.

Source

NSE’s two registers of securities available for trading, each one CSV overwritten in place:

Both carry symbol, registered name, series, listing date and ISIN. The bundle has symbol, company_name, isin, series, board, listed_on, one row per symbol, 3,201 on 30 Oct 2026. A symbol on both registers (a company moving from SME to the main board, for a day or so) keeps its main-board row. Current listings only: a renamed, delisted or suspended symbol is not in the bundle.

Acquisition and storage

sources/nse_equity_master.py, called first and fault-isolated by the refresh’s NSE collection stage (sources/nse_audience.py, “Collect NSE participant and client statistics”, every tier). It refetches when the last check is 20 hours old or more, so the register is read once a day whichever tier runs first. Each new content is kept raw and byte-exact, gzipped, as <board>-<IST minute first seen>-<sha12>.csv.gz under .cache/publishers/nse-equity-master/, which the R2 publishers cache persists and the build’s sealed inputs carry. An unchanged file writes nothing; refresh-status.json records each check. The names step reads the newest capture offline and publishes the bundle.

A register is rejected whole, and the last good capture kept with the error in meta.refresh_error, when a column is missing, a row lacks a symbol or name, an ISIN is malformed, a series is not the board’s (EQ/BE/BZ, SM/ST/SZ), a date does not parse, a symbol repeats, or it has fewer than 1,500 (main) or 200 (SME) rows. A capture older than seven days is marked stale.

Cleaning the names

NSE’s registered name, made readable:

  1. The legal suffix goes: “Limited”, “Ltd”, “Ltd.” and a trailing full stop (“Federal-Mogul Goetze (India) Limited.” → “Federal-Mogul Goetze (India)”). A name that is nothing but the suffix is left alone.
  2. A rights entitlement keeps its company and says what it is: “Shivam Autotech Ltd-RE” (SHIVAM-RE1) → “Shivam Autotech (rights entitlement)”.
  3. A name printed wholly in capitals, suffix included (71 of 3,201), is set in title case, word by word and around hyphens and brackets. A part stays in capitals when it is three letters or fewer (GMR, BIL, 360 ONE WAM), has no vowel (DMCC, RPSG) or holds a digit; a short list of short real words is title-cased anyway (Sky, Gem, Win, Om). “And”, “of”, “the” and the like go lower case inside the name. “BLACKBUCK LIMITED” → “Blackbuck”, “DHARAN INFRA-EPC LIMITED” → “Dharan Infra-EPC”.
  4. Any other name keeps NSE’s own casing (HDFC Bank, One MobiKwik Systems, “IFCI Limited” → “IFCI”), except that the connectives inside it go lower case (“Life Insurance Corporation Of India” → ”… of India”) and a short word with no vowel, which NSE has title-cased, is an acronym again (“Mstc Limited” → “MSTC”, “Rbm Infracon” → “RBM Infracon”; titles and abbreviations such as “Mrs.” and “Mfg” excepted).

The heuristic can’t know an in-word capital in a name NSE prints in capitals (“CREDITACCESS GRAMEEN” → “Creditaccess Grameen”, where the company writes CreditAccess). Tests: pipeline/tests/test_equity_master.py.

Against the names the site already used (30 Oct 2026)

Compared after the site’s own suffix rule (lib/names.ts clean):

SourceRowsNot on the registerSameCase onlyDifferent text
fpi/stock_changes (largest 500)5000482180
ipo/listings/mainboard547194712730
ipo/listings/sme736486312235

Rule: the register names every current symbol. lib/names.ts reads it first, then the largest 500 (still the source of market value for ordering), then the IPO listings, which now name only symbols the register no longer has (old rows on the IPO pages). Where none knows a symbol the page prints the ticker.

The site check

apps/site/scripts/check-tickers.mjs (on the rebuild branch until the cutover), a stage of the site build (“stock names”), reads every built page. A cell, list item or chart label whose whole text is an NSE symbol, in a table, list or chart holding three or more such symbols, or two or more symbols in a comma list in running text, is a ticker in print. It fails the build when a source names that symbol and the name is not beside it in the same row, and it lists the symbols no source names (BSE-only companies and old symbols: three on 30 Oct 2026, all on /mtf/limits/). ETFs keep their tickers; a symbol whose name is itself (ITC, BSE) is not a ticker; NSE, BSE, NSDL, CDSL, MCX, IEX and CAMS in a sentence are the institutions. A Table column declared f: "stock" prints the name and keeps the symbol in the data page’s CSV.

This note is the repository file docs/methods/names.md, rendered as-is.