stock_screener
Filter Nifty 50 or S&P 500 stocks by financial metrics like P/E ratio, ROE, market cap, dividend yield, and sector to identify investment opportunities.
Instructions
Screen stocks by multiple financial criteria. [PRO]
Filter Nifty 50 or S&P 500 stocks by P/E ratio, ROE, market cap, dividend yield, debt/equity ratio, and sector.
Args: exchange: "NSE" for Indian stocks, "US" for US stocks (default: NSE) pe_max: Maximum P/E ratio (e.g., 15 for value stocks). 0 = no filter. pe_min: Minimum P/E ratio. 0 = no filter. roe_min: Minimum Return on Equity in % (e.g., 20). 0 = no filter. market_cap_min: Minimum market cap in USD (e.g., 1000000000 for $1B). 0 = no filter. dividend_yield_min: Minimum dividend yield in % (e.g., 2). 0 = no filter. debt_equity_max: Maximum debt-to-equity ratio (e.g., 50). 0 = no filter. sector: Filter by sector name (e.g., "Technology", "Financial"). Empty = all. limit: Max number of results (default: 15)
Examples: stock_screener("NSE", pe_max=15, roe_min=20) → Value stocks with high ROE stock_screener("NSE", dividend_yield_min=3) → High dividend yield stocks stock_screener("US", pe_max=20, sector="Technology") → Cheap US tech stocks
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exchange | No | NSE | |
| pe_max | No | ||
| pe_min | No | ||
| roe_min | No | ||
| market_cap_min | No | ||
| dividend_yield_min | No | ||
| debt_equity_max | No | ||
| sector | No | ||
| limit | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |