Tool reference

Filter Indian stocks by ROE, P/E and holding

screen_stocks — Filter the entire market by valuation, quality and ownership metrics. This is a read-only research or operational tool. It does not place trades or issue investment recommendations.

What you can ask

Connect DalalOS to Claude or ChatGPT and ask in plain English; the assistant calls screen_stocks for you and answers from the figures it returns.

EXAMPLE PROMPTS

Find IT-sector stocks with ROE over 20% and PE under 30.
List NSE companies with promoter holding above 60% and no pledged shares.
Show stocks with debt to equity below 0.5 and ROCE above 15%.

Parameters and response fields

screen_stocks

Filter the entire market by valuation, quality and ownership metrics

USE WHEN

The screener: combine PE, ROE, debt, promoter holding, sector and 20+ other filters across thousands of NSE/BSE stocks.

PARAMETERS

screen_stocks parameters
Name	Type	Required	Default	Description
`filters`	`object`	Yes	—	Range filters (e.g. pe_min/pe_max, roe_min/roe_max) plus exact filters (sector, industry, company_type, index).
`sort_by`	`string`	No	market_cap	Field to sort results by.
`order`	`string`	No	desc	"asc" or "desc".
`limit`	`integer`	No	25	Max rows, clamped 1–100.

RESPONSE DATA

results — rows shaped like a quote+ratios row, each flagged if a value looks structurally off.
match_count, total_scanned, truncated (whether the scan was capped).

NOTES

Fraction-based metrics (ROE, ROA, ROCE, net margin, dividend/earnings/FCF yield) must be passed as fractions — 0.15, not 15. A bare percentage is rejected with a clear error rather than silently misfiltering.

Also available via REST: /screen

See the same data on DalalOS

Public pages that need no sign-in and show data from the same source.

KEEP EXPLORING

Connect your AI to Indian stock market data

Get started free →