---
title: "Screen Stocks"
method: POST
path: "/screener/api/screen"
tags: ["screener", "screener", "screener-api"]
---

# Screen Stocks

`POST /screener/api/screen`

## Request

- Base URL: `https://api.zyberno.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.zyberno.com/screener/api/screen`
- Auth: none declared

🎯 Enhanced stock screening endpoint with optimized caching
Screen stocks based on fundamental criteria using enhanced cache service.

Features:
- Sub-50ms target performance
- Smart query result caching
- Support for all 150+ metrics
- Professional-grade optimization

## Request body

- ScreeningRequest: Professional-grade stock screening request model.
  - `sector` string, nullable
  - `industry` string, nullable
  - `country` string, nullable
  - `exchange` string, nullable
  - `market_cap_category` string, nullable
  - `price_min` number, nullable
  - `price_max` number, nullable
  - `market_cap_min` number, nullable
  - `market_cap_max` number, nullable
  - `pe_ratio_min` number, nullable
  - `pe_ratio_max` number, nullable
  - `pb_ratio_min` number, nullable
  - `pb_ratio_max` number, nullable
  - `ps_ratio_min` number, nullable
  - `ps_ratio_max` number, nullable
  - `ev_ebitda_ratio_min` number, nullable
  - `ev_ebitda_ratio_max` number, nullable
  - `peg_ratio_min` number, nullable
  - `peg_ratio_max` number, nullable
  - `earnings_yield_min` number, nullable
  - `earnings_yield_max` number, nullable
  - `eps_sue_min` number, nullable
  - `eps_sue_max` number, nullable
  - `expected_return_forward_min` number, nullable
  - `expected_return_forward_max` number, nullable
  - `expected_return_gap_min` number, nullable
  - `expected_return_gap_max` number, nullable
  - `momentum_12_1_min` number, nullable
  - `momentum_12_1_max` number, nullable
  - `momentum_12_1_pct_min` number, nullable
  - `momentum_12_1_pct_max` number, nullable
  - `volatility_12m_min` number, nullable
  - `volatility_12m_max` number, nullable
  - `volatility_12m_pct_min` number, nullable
  - `volatility_12m_pct_max` number, nullable
  - `dependent_value_min` number, nullable
  - `dependent_value_max` number, nullable
  - `critical_supplier_to_min` number, nullable
  - `critical_supplier_to_max` number, nullable
  - `price_to_52w_high_min` number, nullable
  - `price_to_52w_high_max` number, nullable
  - `fcf_yield_min` number, nullable
  - `fcf_yield_max` number, nullable
  - `sales_per_share_ttm_min` number, nullable
  - `sales_per_share_ttm_max` number, nullable
  - `operating_cash_flow_yoy_growth_min` number, nullable
  - `operating_cash_flow_yoy_growth_max` number, nullable
  - `roe_min` number, nullable
  - `roe_max` number, nullable
  - `roa_min` number, nullable
  - `roa_max` number, nullable
  - `roic_min` number, nullable
  - `roic_max` number, nullable
  - `roic_percentage_min` number, nullable
  - `roic_percentage_max` number, nullable
  - `gross_margin_ttm_min` number, nullable
  - `gross_margin_ttm_max` number, nullable
  - `operating_margin_ttm_min` number, nullable
  - `operating_margin_ttm_max` number, nullable
  - `net_margin_ttm_min` number, nullable
  - `net_margin_ttm_max` number, nullable
  - `ebitda_margin_min` number, nullable
  - `ebitda_margin_max` number, nullable
  - `fcf_margin_min` number, nullable
  - `fcf_margin_max` number, nullable
  - `fcf_margin_ttm_min` number, nullable
  - `fcf_margin_ttm_max` number, nullable
  - `revenue_yoy_growth_min` number, nullable
  - `revenue_yoy_growth_max` number, nullable
  - `net_income_yoy_growth_min` number, nullable
  - `net_income_yoy_growth_max` number, nullable
  - `revenue_cagr_3yr_min` number, nullable
  - `revenue_cagr_3yr_max` number, nullable
  - `net_income_cagr_3yr_min` number, nullable
  - `net_income_cagr_3yr_max` number, nullable
  - `operating_income_cagr_3yr_min` number, nullable
  - `operating_income_cagr_3yr_max` number, nullable
  - `operating_cf_cagr_3yr_min` number, nullable
  - `operating_cf_cagr_3yr_max` number, nullable
  - `eps_cagr_3yr_min` number, nullable
  - `eps_cagr_3yr_max` number, nullable
  - `fcf_growth_min` number, nullable
  - `fcf_growth_max` number, nullable
  - `book_value_growth_min` number, nullable
  - `book_value_growth_max` number, nullable
  - `ebitda_growth_min` number, nullable
  - `ebitda_growth_max` number, nullable
  - `operating_income_growth_min` number, nullable
  - `operating_income_growth_max` number, nullable
  - `revenue_growth_rate_linear_min` number, nullable
  - `revenue_growth_rate_linear_max` number, nullable
  - `net_income_growth_rate_linear_min` number, nullable
  - `net_income_growth_rate_linear_max` number, nullable
  - `free_cash_flow_growth_rate_linear_min` number, nullable
  - `free_cash_flow_growth_rate_linear_max` number, nullable
  - `operating_income_growth_rate_linear_min` number, nullable
  - `operating_income_growth_rate_linear_max` number, nullable
  - `operating_cash_flow_growth_rate_linear_min` number, nullable
  - `operating_cash_flow_growth_rate_linear_max` number, nullable
  - `gross_profit_growth_rate_linear_min` number, nullable
  - `gross_profit_growth_rate_linear_max` number, nullable
  - `eps_diluted_growth_rate_linear_min` number, nullable
  - `eps_diluted_growth_rate_linear_max` number, nullable
  - `current_ratio_min` number, nullable
  - `current_ratio_max` number, nullable
  - `quick_ratio_min` number, nullable
  - `quick_ratio_max` number, nullable
  - `cash_ratio_min` number, nullable
  - `cash_ratio_max` number, nullable
  - `debt_to_equity_min` number, nullable
  - `debt_to_equity_max` number, nullable
  - `debt_to_equity_ttm_min` number, nullable
  - `debt_to_equity_ttm_max` number, nullable
  - `debt_to_assets_min` number, nullable
  - `debt_to_assets_max` number, nullable
  - `interest_coverage_ratio_min` number, nullable
  - `interest_coverage_ratio_max` number, nullable
  - `debt_to_ebitda_min` number, nullable
  - `debt_to_ebitda_max` number, nullable
  - `times_interest_earned_min` number, nullable
  - `times_interest_earned_max` number, nullable
  - `cash_coverage_ratio_min` number, nullable
  - `cash_coverage_ratio_max` number, nullable
  - `fixed_charge_coverage_ratio_min` number, nullable
  - `fixed_charge_coverage_ratio_max` number, nullable
  - `debt_service_coverage_ratio_min` number, nullable
  - `debt_service_coverage_ratio_max` number, nullable
  - `defensive_interval_ratio_min` number, nullable
  - `defensive_interval_ratio_max` number, nullable
  - `working_capital_min` number, nullable
  - `working_capital_max` number, nullable
  - `cash_and_cash_equivalents_min` number, nullable
  - `cash_and_cash_equivalents_max` number, nullable
  - `total_debt_min` number, nullable
  - `total_debt_max` number, nullable
  - `equity_ratio_min` number, nullable
  - `equity_ratio_max` number, nullable
  - `asset_turnover_min` number, nullable
  - `asset_turnover_max` number, nullable
  - `inventory_turnover_min` number, nullable
  - `inventory_turnover_max` number, nullable
  - `receivables_turnover_ttm_min` number, nullable
  - `receivables_turnover_ttm_max` number, nullable
  - `cash_conversion_cycle_min` number, nullable
  - `cash_conversion_cycle_max` number, nullable
  - `working_capital_turnover_ttm_min` number, nullable
  - `working_capital_turnover_ttm_max` number, nullable
  - `days_sales_outstanding_min` number, nullable
  - `days_sales_outstanding_max` number, nullable
  - `days_inventory_outstanding_min` number, nullable
  - `days_inventory_outstanding_max` number, nullable
  - `fixed_asset_turnover_min` number, nullable
  - `fixed_asset_turnover_max` number, nullable
  - `days_payable_outstanding_min` number, nullable
  - `days_payable_outstanding_max` number, nullable
  - `asset_turnover_ttm_min` number, nullable
  - `asset_turnover_ttm_max` number, nullable
  - `payables_turnover_min` number, nullable
  - `payables_turnover_max` number, nullable
  - `free_cash_flow_min` number, nullable
  - `free_cash_flow_max` number, nullable
  - `operating_cash_flow_min` number, nullable
  - `operating_cash_flow_max` number, nullable
  - `free_cash_flow_per_share_min` number, nullable
  - `free_cash_flow_per_share_max` number, nullable
  - `cash_flow_to_net_income_min` number, nullable
  - `cash_flow_to_net_income_max` number, nullable
  - `fcf_per_share_min` number, nullable
  - `fcf_per_share_max` number, nullable
  - `operating_cf_per_share_min` number, nullable
  - `operating_cf_per_share_max` number, nullable
  - `cf_to_net_income_min` number, nullable
  - `cf_to_net_income_max` number, nullable
  - `capex_min` number, nullable
  - `capex_max` number, nullable
  - `capex_to_revenue_min` number, nullable
  - `capex_to_revenue_max` number, nullable
  - `fcf_conversion_min` number, nullable
  - `fcf_conversion_max` number, nullable
  - `operating_cash_flow_ratio_min` number, nullable
  - `operating_cash_flow_ratio_max` number, nullable
  - `sales_per_share_min` number, nullable
  - `sales_per_share_max` number, nullable
  - `operating_cash_flow_per_share_min` number, nullable
  - `operating_cash_flow_per_share_max` number, nullable
  - `book_value_per_share_min` number, nullable
  - `book_value_per_share_max` number, nullable
  - `cash_per_share_min` number, nullable
  - `cash_per_share_max` number, nullable
  - `tangible_book_per_share_min` number, nullable
  - `tangible_book_per_share_max` number, nullable
  - `shares_outstanding_min` number, nullable
  - `shares_outstanding_max` number, nullable
  - `piotroski_f_score_min` integer, nullable
  - `piotroski_f_score_max` integer, nullable
  - `piotroski_score_category` string, nullable
  - `quality_score_min` number, nullable
  - `quality_score_max` number, nullable
  - `zyberno_score_min` number, nullable
  - `zyberno_score_max` number, nullable
  - `financial_strength_score_min` number, nullable
  - `financial_strength_score_max` number, nullable
  - `profitability_score_min` number, nullable
  - `profitability_score_max` number, nullable
  - `altman_z_score_min` number, nullable
  - `altman_z_score_max` number, nullable
  - `altman_z_category` string, nullable
  - `overall_rating` string, nullable
  - `data_quality_score_min` number, nullable
  - `data_quality_score_max` number, nullable
  - `owner_earnings_min` number, nullable
  - `owner_earnings_max` number, nullable
  - `owner_earnings_yield_min` number, nullable
  - `owner_earnings_yield_max` number, nullable
  - `owner_earnings_growth_rate_min` number, nullable
  - `owner_earnings_growth_rate_max` number, nullable
  - `margin_of_safety_min` number, nullable
  - `margin_of_safety_max` number, nullable
  - `theoretical_return_5yr_annual_min` number, nullable
  - `theoretical_return_5yr_annual_max` number, nullable
  - `intrinsic_value_min` number, nullable
  - `intrinsic_value_max` number, nullable
  - `price_to_owner_earnings_ttm_min` number, nullable
  - `price_to_owner_earnings_ttm_max` number, nullable
  - `reinvestment_rate_min` number, nullable
  - `reinvestment_rate_max` number, nullable
  - `fundamental_growth_rate_min` number, nullable
  - `fundamental_growth_rate_max` number, nullable
  - `market_implied_growth_rate_min` number, nullable
  - `market_implied_growth_rate_max` number, nullable
  - `fundamental_vs_implied_gap_min` number, nullable
  - `fundamental_vs_implied_gap_max` number, nullable
  - `buffett_assessment` string, nullable
  - `investment_recommendation` string, nullable
  - `value_score_min` number, nullable
  - `value_score_max` number, nullable
  - `growth_score_min` number, nullable
  - `growth_score_max` number, nullable
  - `pe_ratio_ttm_min` number, nullable
  - `pe_ratio_ttm_max` number, nullable
  - `pfcf_ratio_ttm_min` number, nullable
  - `pfcf_ratio_ttm_max` number, nullable
  - `revenue_ttm_min` number, nullable
  - `revenue_ttm_max` number, nullable
  - `net_income_ttm_min` number, nullable
  - `net_income_ttm_max` number, nullable
  - `net_income_adjusted_ttm_min` number, nullable
  - `net_income_adjusted_ttm_max` number, nullable
  - `eps_basic_ttm_min` number, nullable
  - `eps_basic_ttm_max` number, nullable
  - `eps_diluted_ttm_min` number, nullable
  - `eps_diluted_ttm_max` number, nullable
  - `earnings_coverage_ratio_min` number, nullable
  - `earnings_coverage_ratio_max` number, nullable
  - `dividend_safety_score_min` number, nullable
  - `dividend_safety_score_max` number, nullable
  - `fcf_payout_ratio_min` number, nullable
  - `fcf_payout_ratio_max` number, nullable
  - `debt_to_equity_percentage_min` number, nullable
  - `debt_to_equity_percentage_max` number, nullable
  - `dividend_payout_ratio_ttm_min` number, nullable
  - `dividend_payout_ratio_ttm_max` number, nullable
  - `fcf_payout_ratio_ttm_min` number, nullable
  - `fcf_payout_ratio_ttm_max` number, nullable
  - `earnings_yield_ttm_min` number, nullable
  - `earnings_yield_ttm_max` number, nullable
  - `enterprise_value_min` number, nullable
  - `enterprise_value_max` number, nullable
  - `ev_sales_ratio_min` number, nullable
  - `ev_sales_ratio_max` number, nullable
  - `ptb_ratio_min` number, nullable
  - `ptb_ratio_max` number, nullable
  - `pnca_ratio_min` number, nullable
  - `pnca_ratio_max` number, nullable
  - `margin_of_safety_conservative_min` number, nullable
  - `margin_of_safety_conservative_max` number, nullable
  - `beta_min` number, nullable
  - `beta_max` number, nullable
  - `high_52w_ratio_min` number, nullable
  - `high_52w_ratio_max` number, nullable
  - `low_52w_ratio_min` number, nullable
  - `low_52w_ratio_max` number, nullable
  - `avg_volume_min` number, nullable
  - `avg_volume_max` number, nullable
  - `float_shares_min` number, nullable
  - `float_shares_max` number, nullable
  - `insider_ownership_min` number, nullable
  - `insider_ownership_max` number, nullable
  - `dividend_yield_min` number, nullable
  - `dividend_yield_max` number, nullable
  - `dividend_payout_ratio_min` number, nullable
  - `dividend_payout_ratio_max` number, nullable
  - `dividend_years_min` number, nullable
  - `dividend_years_max` number, nullable
  - `dividend_growth_5yr_min` number, nullable
  - `dividend_growth_5yr_max` number, nullable
  - `dividend_growth_3yr_min` number, nullable
  - `dividend_growth_3yr_max` number, nullable
  - `consecutive_dividend_years_min` number, nullable
  - `consecutive_dividend_years_max` number, nullable
  - `dividend_safety_min` number, nullable
  - `dividend_safety_max` number, nullable
  - `dupont_roe_min` number, nullable
  - `dupont_roe_max` number, nullable
  - `dupont_asset_turnover_min` number, nullable
  - `dupont_asset_turnover_max` number, nullable
  - `dupont_net_margin_min` number, nullable
  - `dupont_net_margin_max` number, nullable
  - `roe_avg_3yr_min` number, nullable
  - `roe_avg_3yr_max` number, nullable
  - `roe_avg_5yr_min` number, nullable
  - `roe_avg_5yr_max` number, nullable
  - `net_margin_avg_3yr_min` number, nullable
  - `net_margin_avg_3yr_max` number, nullable
  - `net_margin_avg_5yr_min` number, nullable
  - `net_margin_avg_5yr_max` number, nullable
  - `net_margin_trend` string, nullable
  - `revenue_trend` string, nullable
  - `profitability_trend` string, nullable
  - `sort_by` string: Sort field
  - `sort_desc` boolean: Sort descending
  - `limit` integer: Maximum results
  - `offset` integer: Pagination offset

## Response `200`

Successful Response

- ScreeningResponse: Stock screening response model.
  - `success` boolean, required
  - `results` object[], required
  - `total_found` integer, required
  - `execution_time_ms` number, required
  - `filters_applied` object, required
  - `timestamp` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zyberno/apis/sec-edgar-financial-data-api.md) · [All operations](https://skmtc.dev/zyberno/apis/sec-edgar-financial-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zyberno/apis/sec-edgar-financial-data-api/revisions/d453fad027b2?raw)