TOOL REFERENCE
screen_stocks
Filter the entire market by valuation, quality and ownership metrics. This is a read-only tool: it returns raw market data or mechanically-computed ratios, never investment advice.
screen_stocks
Filter the entire market by valuation, quality and ownership metricsUSE WHEN
The screener: combine PE, ROE, debt, promoter holding, sector and 20+ other filters across roughly 5,000 NSE/BSE 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.
EXAMPLE PROMPTS
- Find IT-sector stocks with ROE over 20% and PE under 30.
KEEP EXPLORING
Connect your AI to Indian stock market data
Sign in to DalalOS and connect your AI in one line of config. Free to start.