Guide · Using ScripLens

What each page and chart shows

A tour of the site: what each page contains, how to read its charts and insights, and what the screener's query language accepts. Descriptions only. Nothing on the site says what to buy or sell.
On this page

Markets (home)

In one lineThe home page is a snapshot of the whole market on the latest trading day.
  • Market pulse counts stocks above their 200-day and 50-day averages, and those higher than a year ago, with the median one-year return. Another bar shows how far stocks sit below their 52-week highs. It describes the market today.
  • Sector heatmap shows one tile per sector, sized by market cap and coloured by the change or return for the period you pick. Its note states the colour scale.
  • Top gainers, top losers and most active list the largest one-day moves and the highest turnover on the latest day.

Every figure is an end-of-day count or statistic. Read it with the definitions in Market-wide views.

Indices

In one lineThe Indices pages list every NSE index with its returns and the valuation figures NSE publishes. Each index has its own page, and up to several can be compared side by side.
  • Index list: returns, P/E, P/B, dividend yield, and P/E vs own history, which shows where today's P/E sits among all trading days in the data.
  • Index page: returns (1 month, YTD, 1 and 3 and 5 years), valuation history, drawdowns and the constituent list.
  • Compare indices: growth of 100 over a chosen period, returns over common periods, calendar-year returns, risk, correlation, shared constituents, sector mix by count, concentration and valuation against each index's own history.

Index returns are price returns and exclude dividends. BSE indices such as the Sensex are not yet included.

Stocks A to Z

In one lineA plain alphabetical directory of every NSE-listed company, to open a stock page.

Pick a letter to see its companies, and the count beside each letter shows how many are listed under it. The filter box narrows the current letter. Long lists are shown in part, with a note to use the search bar for the rest.

Stock page, section by section

In one lineEach stock page runs from the price chart and key figures down to the financial tables. The sections appear in this order.
  1. Header. Symbol, sector (a link to the screener filtered by sector), the indices the company belongs to, signal chips, the next event, the latest close with its day change, the EOD date, and the 52-week range with how long ago the high and low were set. The star adds the stock to your watchlist.
  2. Price chart. Area or candles, with optional 50 and 200-day averages and an overlay of the Nifty 50. A readout shows the open, high, low, close and volume of the day under the cursor. A Compare with peers button opens the Compare page. Learn: candles and averages.
  3. Did you know?. A rotating set of facts computed from the same public data. You can pause it or step through the facts. They are descriptions, not advice.
  4. Key stats. Market cap, P/E, P/B, dividend yield (trailing 12 months), ROE, ROCE, debt-to-equity, net margin, revenue and profit growth, 1-month and 1-year returns, average volume over 20 days, and the latest session's turnover. Learn: what each ratio means.
  5. Price growth (CAGR). Price-only growth over 1 to 5 years, annualised, split- and bonus-adjusted. Each tile also shows the total change over the period. Learn: CAGR.
  6. Past returns. The total-return view: price only, with dividends as cash, and with dividends reinvested, including bonus and split shares. It lists the events it used. Learn: total return.
  7. Stock vs index. Growth of ₹100 and relative strength against a chosen index, a return table over several periods, calendar-year returns, and risk statistics such as beta, correlation and capture. Learn: relative strength.
  8. Where it sits. Percentile ranks for several metrics, against its sector or all NSE stocks. A dot shows where the value sits between the lowest and highest in the group, with the median marked. The direction is the same for every metric.
  9. Valuation history. Weekly P/E and P/B over the stock's own history, with today's reading placed among them as a percentile. Learn: valuation history.
  10. Risk, drawdowns and seasonality. Volatility over the last year, the share of days that closed up, the three deepest falls with recovery times, the current distance below the peak, calendar-year and monthly returns, and average returns by calendar month. Learn: risk statistics.
  11. Shareholding and delivery. The quarterly shareholding pattern (promoter, FII, DII, MF and other public) and the daily delivery % with its 20-day average. Learn: ownership terms.
  12. What if you had invested?. A calculator that replays a past lumpsum or a monthly SIP at adjusted prices, over 1, 3, 5 or 10 years where history allows. It shows the amount invested, the gain and the annual rate: CAGR for a lumpsum, XIRR for a SIP. Learn: SIP and XIRR.
  13. Dividend history. Each dividend by ex-date, restated in today's shares or as declared, with the yield at the time and streak counts. Learn: dividend history.
  14. Company timeline. Events from listing data, corporate-action records and prices, in date order. The Play button animates them.
  15. Quality and risk scores, technicals, peers. The Piotroski F-score and Altman Z'' with their range labels, RSI(14), the 50 and 200-day averages, distance from the 52-week high, and sector peers with their size and one-year return. Learn: the models.
  16. Financials. Revenue, operating profit, net profit, EPS, total assets, equity, debt and cash from operations, annual or quarterly. Each cell is coloured by whether it rose or fell on the previous period, which describes the change and not whether it is good. Learn: the financial rows.

Some sections load as you scroll to them, so a section may appear a moment after the rest of the page. Sections with no data say so, and a dash means the figure is not available.

Screener and its query language

In one lineThe screener keeps the stocks that meet every condition you write. Each condition is a field, an operator and a number.
roe > 15 and debt_to_equity < 0.5 and market_cap > 1000
  • Joining conditions: and, &&, or a new line. There is no or and no brackets, so every condition must hold.
  • Operators: >, >=, <, <=, =, !=.
  • Values are plain numbers, using the units in the field list (for example, dividend_yield > 3 means 3%).
  • Short names also work: mcap, price, ltp, de, dy, vol, rsi, z, piotroski, fscore, streak, sales_growth, profit_growth.
  • Run the screen with the button, or Ctrl/Cmd + Enter in the query box.

The fields you can use, with their meanings:

FieldUnitWhat it is
market_cap₹ croreMarket value at the latest close
close₹Latest closing price
change_pct%Change on the latest session
pexP/E: market cap ÷ latest annual net profit
pbxP/B: market cap ÷ shareholders' equity
dividend_yield%Dividends with ex-dates in the last 12 months ÷ price
roe%Net profit ÷ average shareholders' equity
roce%(Profit before tax + interest) ÷ (equity + debt)
debt_to_equityxTotal debt ÷ shareholders' equity
net_margin%Net profit ÷ revenue
revenue_growth_yoy%Latest annual revenue against the year before
profit_growth_yoy%Latest annual net profit against the year before
piotroski_f/9Piotroski F-score, the count of nine tests passed
altman_zAltman Z'' score, not for banks
rsi_14RSI over 14 sessions, 0 to 100
return_1m%Price change over about one month (21 sessions)
return_1y%Price change over about one year (252 sessions)
pct_from_52w_high%Distance below the 52-week high (0 at the high)
avg_volume_20dAverage shares traded per day over 20 sessions
turnover₹ croreValue traded on the latest session
cagr_3y%Price CAGR over 3 years, split- and bonus-adjusted
cagr_5y%Price CAGR over 5 years, split- and bonus-adjusted
volatility_1y%Annualised volatility over the last year
dividend_streakyrsConsecutive financial years with a dividend
deliv_pct%Delivery % on the latest session
deliv_pct_avg_20d%Average delivery % over 20 sessions
promoter_pct%Promoter and promoter-group holding, latest filed quarter
promoter_change_1yptsChange in promoter holding against a year earlier, in percentage points
Illustrative example: reading a result

Each condition card shows how many stocks with that figure pass it, and a histogram of the whole market for that field.

The filter funnel shows how many stocks remain after each condition, applied one at a time. The step that removes the most is marked, so you can see which condition does the most work.

The panel above the table gives the median of the matches against the market, the size mix (large, mid, small), and the sector mix. Select up to five rows to compare them.

The screener's presets are examples of query syntax. They show how conditions combine and are not stock picks, model portfolios or lists to consider. Results use the latest end-of-day data and change as the data does.

Compare

In one linePick two to five stocks and see their figures side by side. The dot in each row marks the highest value in that row, for every metric.
  • Percentile profile: on each axis, the share of NSE stocks with a lower value. The centre is the lowest and the outer edge the highest. Further out is not better or worse.
  • Highest and lowest: which company leads each metric, shown row by row.
  • Return and risk: price-only returns over the chosen period, with volatility, the deepest fall, beta against the benchmark, and the best and worst days.
  • Do they move together?: the correlation of daily price changes between each pair.
  • Quarterly revenue and profit: bars for revenue and dots for net profit, each stock on its own scale.

A dot or a higher percentile is only a position in a list. It is not a ranking or a recommendation.

Past value explorer

In one lineA hypothetical look back: what a fixed amount put into each company on a past date would be worth today, or what it would have taken to own a set amount today.
  • Question: either "if this amount had been put into each company, what would it be worth today?" or "how many shares bought then make this amount today, and what did they cost?"
  • Amount: presets from ₹1 lakh to ₹1 crore, or your own figure.
  • Years ago: the look-back is limited to the start of the price data.
  • Summary: the median outcome, the spread between the 10th and 90th percentile outcomes, how many companies ended above and below the starting amount, and a histogram of the outcomes. The summary counts every company in the filtered set, including those that fell.
  • Company list: sorted by company size by default. You can sort by name, change since then or change per year, search, filter by sector, and optionally filter by growth per year. The growth filter is off unless you turn it on.
  • Which companies are counted: a note under the summary gives how many were left out, for example because they had no price near the start date or traded below ₹1.

Dividends, taxes, brokerage and other charges are left out. The list covers only companies listed today, so companies that were delisted or merged are missing (survivorship bias). It describes past prices only and is not a recommendation.

Calendar

In one lineThe Calendar lists corporate events by date, so you can see what has been announced or has already happened.

Two kinds of event appear: corporate actions (dividends, bonus issues, splits, rights issues, buybacks and demergers, with their ex-dates and record dates) and board meetings and results dates. You can filter by type and by date window. Events are announcements and records, not forecasts of the outcome.

Watchlist

In one lineA list of up to 50 stocks you have starred, kept in your own browser.

The watchlist shows the latest end-of-day figures for each starred stock. It is stored only in your browser, so it is not tied to an account and does not sync to other devices or browsers. Clearing your browser data removes it. The "Share list" link makes a link that contains only the symbols.

Next
Frequently asked questions →

Educational explanations only, not investment advice, research or a recommendation to buy, sell or hold any security. Past performance does not indicate future results. Every example uses made-up round numbers. Read the Disclaimer before relying on any figure.