Searches 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).
Filters combine with AND: a company must meet every one you supply, and a company missing a filtered metric is left out. 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. Each result gives the ticker, name, market cap, margin of safety, Brina Gap, Zyberno Score and ROIC, with a link to the company's report.
View input schema
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"Technology",
"Healthcare",
"Financial Services",
"Consumer Discretionary",
"Consumer Staples",
"Industrial",
"Energy",
"Materials",
"Utilities",
"Real Estate"
],
"description": "Restrict to one sector, from the SEC industry code. Media and internet platforms are Consumer Discretionary or Technology (there is no Communication Services sector)."
},
"exchange": {
"type": "string",
"enum": [
"NASDAQ",
"NYSE",
"OTC",
"CBOE"
],
"description": "Restrict to one listing venue."
},
"market_cap_category": {
"type": "string",
"enum": [
"mega",
"large",
"mid",
"small",
"micro"
],
"description": "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."
},
"market_cap_min": {
"type": "number",
"description": "Minimum market capitalisation in US dollars, for example 2000000000 for 2 billion."
},
"market_cap_max": {
"type": "number",
"description": "Maximum market capitalisation in US dollars."
},
"margin_of_safety_min": {
"type": "number",
"description": "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."
},
"margin_of_safety_max": {
"type": "number",
"description": "Maximum Margin of Safety in percentage points. Pass 10 for 10 percent."
},
"brina_gap_min": {
"type": "number",
"description": "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."
},
"brina_gap_max": {
"type": "number",
"description": "Maximum Brina Gap in percentage points. Use a negative value to isolate companies whose price implies more growth than fundamentals support."
},
"fundamental_growth_rate_min": {
"type": "number",
"description": "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."
},
"fundamental_growth_rate_max": {
"type": "number",
"description": "Maximum fundamentally fundable growth rate in percent."
},
"zyberno_score_min": {
"type": "number",
"description": "Minimum Zyberno business-quality score, 0 to 100, from 13 weighted measures of profitability, cash-flow quality, stability and growth. 70 is the cut-off the Zyberno Strategy uses."
},
"roic_min": {
"type": "number",
"description": "Minimum return on invested capital in percent. Pass 15 for 15 percent."
},
"roe_min": {
"type": "number",
"description": "Minimum return on equity in percent."
},
"pe_ratio_max": {
"type": "number",
"description": "Maximum trailing price to earnings ratio. Companies with no meaningful P/E, including loss makers, are excluded when this is set."
},
"pb_ratio_max": {
"type": "number",
"description": "Maximum price to book ratio."
},
"ev_ebitda_ratio_max": {
"type": "number",
"description": "Maximum enterprise value to EBITDA ratio."
},
"peg_ratio_max": {
"type": "number",
"description": "Maximum PEG ratio, price to earnings divided by growth."
},
"earnings_yield_min": {
"type": "number",
"description": "Minimum earnings yield in percent, the inverse of P/E. Pass 8 for 8 percent."
},
"fcf_yield_min": {
"type": "number",
"description": "Minimum free cash flow yield in percent. Pass 5 for 5 percent."
},
"owner_earnings_yield_min": {
"type": "number",
"description": "Minimum owner earnings yield in percent. Owner earnings is the cash figure the discounted cash flow behind Margin of Safety is built on."
},
"gross_margin_ttm_min": {
"type": "number",
"description": "Minimum trailing twelve month gross margin in percent."
},
"operating_margin_ttm_min": {
"type": "number",
"description": "Minimum trailing twelve month operating margin in percent."
},
"net_margin_ttm_min": {
"type": "number",
"description": "Minimum trailing twelve month net margin in percent."
},
"revenue_yoy_growth_min": {
"type": "number",
"description": "Minimum year over year revenue growth in percent."
},
"revenue_cagr_3yr_min": {
"type": "number",
"description": "Minimum 3 year revenue compound annual growth rate in percent."
},
"eps_cagr_3yr_min": {
"type": "number",
"description": "Minimum 3 year diluted EPS compound annual growth rate in percent."
},
"debt_to_equity_max": {
"type": "number",
"description": "Maximum debt to equity ratio, as a ratio not a percent. Pass 1.5 for 1.5x."
},
"current_ratio_min": {
"type": "number",
"description": "Minimum current ratio. Pass 1.5 for 1.5x."
},
"interest_coverage_ratio_min": {
"type": "number",
"description": "Minimum interest coverage ratio, operating income over interest expense."
},
"momentum_12_1_min": {
"type": "number",
"description": "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."
},
"momentum_12_1_max": {
"type": "number",
"description": "Maximum 12 minus 1 price momentum in percent. Pass a negative value to isolate fallers."
},
"momentum_12_1_pct_min": {
"type": "number",
"description": "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."
},
"momentum_12_1_pct_max": {
"type": "number",
"description": "Maximum cross-sectional momentum percentile, 0 to 100."
},
"price_to_52w_high_min": {
"type": "number",
"description": "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."
},
"price_to_52w_high_max": {
"type": "number",
"description": "Maximum ratio of current price to the 52 week high. Pass 0.7 to find stocks at least 30 percent below their high."
},
"eps_sue_min": {
"type": "number",
"description": "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."
},
"eps_sue_max": {
"type": "number",
"description": "Maximum standardised earnings surprise (SUE), range -4 to +4."
},
"sort_by": {
"type": "string",
"enum": [
"market_cap",
"zyberno_score",
"margin_of_safety",
"fundamental_vs_implied_gap",
"roic",
"roe",
"fcf_yield",
"momentum_12_1",
"momentum_12_1_pct",
"eps_sue",
"pe_ratio"
],
"description": "Field to rank the matches by, largest first. Defaults to market_cap."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "How many companies to return, 1 to 25. Defaults to 10. The total number that matched is reported regardless."
}
},
"additionalProperties": false
}