Find US-listed companies by valuation and quality criteria
screen_stocksSearches Zyberno's database of roughly 10,000 US-listed companies and returns those matching the numeric criteria you supply, ranked by a field you choose. All metrics are computed from SEC filings.
Use when the user wants to find, filter, rank, or count companies by their characteristics rather than asking about one company by name. Omit any filter you do not want applied; omitting all of them ranks the whole covered universe. Do not use it for a single known ticker (use get_stock_valuation), and do not use it to reconstruct the published monthly lists, which apply their own fixed thresholds, sector exclusions and curation (use list_flagged_stocks).
Returns at most 25 companies plus the total number that matched, so a query that is too broad or too narrow reports its own breadth.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many companies to return, 1 to 25. Defaults to 10. The total number that matched is reported regardless. | |
| sector | No | Restrict to one sector, spelled as Zyberno stores it, for example Technology, Healthcare, Industrials, Energy, Consumer Cyclical, Financial Services, Real Estate, Utilities, Basic Materials, Communication Services, Consumer Defensive. | |
| roe_min | No | Minimum return on equity in percent. | |
| sort_by | No | Field to rank the matches by, largest first. Defaults to market_cap. | |
| exchange | No | Restrict to one listing venue. | |
| roic_min | No | Minimum return on invested capital in percent. Pass 15 for 15 percent. | |
| eps_sue_max | No | Maximum standardised earnings surprise (SUE), range -4 to +4. | |
| eps_sue_min | No | Minimum standardised earnings surprise (SUE), a winsorized z-score bounded to the range -4 to +4. Positive means the latest reported earnings beat the trend-based expectation. Pass 1 for a one standard deviation beat. | |
| pb_ratio_max | No | Maximum price to book ratio. | |
| pe_ratio_max | No | Maximum trailing price to earnings ratio. Companies with no meaningful P/E, including loss makers, are excluded when this is set. | |
| brina_gap_max | No | Maximum Brina Gap in percentage points. Use a negative value to isolate companies whose price implies more growth than fundamentals support. | |
| brina_gap_min | No | Minimum Brina Gap in percentage points. Positive means the growth the business can fund exceeds the growth its price implies; negative means the price implies faster growth than the fundamentals support. Pass 3 for 3 percentage points. | |
| fcf_yield_min | No | Minimum free cash flow yield in percent. Pass 5 for 5 percent. | |
| peg_ratio_max | No | Maximum PEG ratio, price to earnings divided by growth. | |
| market_cap_max | No | Maximum market capitalisation in US dollars. | |
| market_cap_min | No | Minimum market capitalisation in US dollars, for example 2000000000 for 2 billion. | |
| eps_cagr_3yr_min | No | Minimum 3 year diluted EPS compound annual growth rate in percent. | |
| current_ratio_min | No | Minimum current ratio. Pass 1.5 for 1.5x. | |
| momentum_12_1_max | No | Maximum 12 minus 1 price momentum in percent. Pass a negative value to isolate fallers. | |
| momentum_12_1_min | No | Minimum 12 minus 1 price momentum in percent: total return including dividends over the last 12 months, skipping the most recent month. Pass 20 for 20 percent, or -30 for a 30 percent fall. Values are unbounded above, and the strongest names in the universe can read in the hundreds of percent. Companies listed under 13 months have no window and are excluded whenever any momentum filter is set. | |
| zyberno_score_min | No | Minimum Zyberno quality score, on a 0 to 100 scale combining profitability, balance sheet strength and earnings consistency. | |
| debt_to_equity_max | No | Maximum debt to equity ratio, as a ratio not a percent. Pass 1.5 for 1.5x. | |
| earnings_yield_min | No | Minimum earnings yield in percent, the inverse of P/E. Pass 8 for 8 percent. | |
| net_margin_ttm_min | No | Minimum trailing twelve month net margin in percent. | |
| ev_ebitda_ratio_max | No | Maximum enterprise value to EBITDA ratio. | |
| market_cap_category | No | Restrict by size band, as an alternative to explicit market cap bounds. Bands are micro under $300M, small $300M to $2B, mid $2B to $10B, large $10B to $200B, mega $200B and above. Note that large excludes mega, so for the very largest companies use mega, and to cover both give market_cap_min instead. | |
| gross_margin_ttm_min | No | Minimum trailing twelve month gross margin in percent. | |
| margin_of_safety_max | No | Maximum Margin of Safety in percentage points. Pass 10 for 10 percent. | |
| margin_of_safety_min | No | Minimum Margin of Safety in percentage points, where positive means the price sits below the discounted cash flow estimate. Pass 10 for 10 percent, not 0.1. Negative values are allowed. | |
| revenue_cagr_3yr_min | No | Minimum 3 year revenue compound annual growth rate in percent. | |
| momentum_12_1_pct_max | No | Maximum cross-sectional momentum percentile, 0 to 100. | |
| momentum_12_1_pct_min | No | Minimum cross-sectional momentum percentile, 0 to 100, where 100 is the strongest momentum in the covered universe. Prefer this over the raw percentage when the user asks for strong or weak momentum in relative terms. Percentiles refresh on a monthly recompute, so they can lag the raw figure. | |
| price_to_52w_high_max | No | Maximum ratio of current price to the 52 week high. Pass 0.7 to find stocks at least 30 percent below their high. | |
| price_to_52w_high_min | No | Minimum ratio of current price to the 52 week high, where 1.0 means the stock is sitting at its high. Pass 0.95 for within 5 percent of the high. | |
| revenue_yoy_growth_min | No | Minimum year over year revenue growth in percent. | |
| operating_margin_ttm_min | No | Minimum trailing twelve month operating margin in percent. | |
| owner_earnings_yield_min | No | Minimum owner earnings yield in percent. Owner earnings is the cash figure the discounted cash flow behind Margin of Safety is built on. | |
| fundamental_growth_rate_max | No | Maximum fundamentally fundable growth rate in percent. | |
| fundamental_growth_rate_min | No | Minimum fundamentally fundable growth rate in percent, defined as ROIC times reinvestment rate. This is the first half of the Brina Gap on its own. | |
| interest_coverage_ratio_min | No | Minimum interest coverage ratio, operating income over interest expense. |