Available Datasets
Stock Screener API
Analytics APIFilter stocks in one call
Filter 100,000+ instruments by metrics, sector and technical signals – without building your own database.
One request returns a filtered list from the global stock universe. Filter by P/E, sector, market cap, dividend yield and more – combinable with signals such as yearly lows or book-value crosses. For screening apps and watchlists on XETRA, NASDAQ and 50+ exchanges.
How screening works
You pass filters, signals, sort order and page size – Leeway returns the matching response with authentication and metering handled.
One call consumes 10 request units (regardless of limit/offset).
Example document: https://api.leeway.tech/api/v1/public/general/screener
curl -s 'https://api.leeway.tech/api/v1/public/general/screener?filters=[["pe","<",15]]&limit=10&apitoken=YOUR_TOKEN'Ready for the best API experience?
Start with 100 free request units per day.
Screener Filter Fields
All screenable listing, Highlights, keyfigures, aliases and signal fields. Full catalog in the API Glossary (Screener).
Query parameters
filters- JSON array of [field, operator, value] triplets. At least one of filters, signals, or preset is required. String ops: =, match. Numeric ops: =, >, <, >=, <=.
signals- Comma-separated market signals (see Market signals). Combinable with filters.
preset- Named filter preset. Currently: quality (ROE>0.15, ROA>0.10, OperatingMarginTTM>0.15, debt_to_equity<0.5, current_ratio>1.5, interest_coverage>5, earnings_growth_5y_cagr>0.05, sales_growth_5y_cagr>0.05, free_cashflow>0, MarketCapitalization>10000000000, PERatio<30). Matching filter fields override preset thresholds.
sort- Sort by a numeric field: field.asc or field.desc (e.g. market_capitalization.desc).
limit- Number of results to return. Default 50, min 1, max 1000.
offset- Pagination offset. Default 0, max 999.
Listing filter fields
code- Ticker symbol.
name- Company or instrument name.
exchange- Exchange code (e.g. XETRA, NASDAQ).
sector- Sector classification.
industry- Industry classification.
market_capitalization- Market capitalization (absolute).
earnings_share- Earnings per share.
dividend_yield- Dividend yield.
refund_1d_p- 1-day percentage price change.
refund_5d_p- 5-day percentage price change.
avgvol_1d- Average volume (1 day).
avgvol_200d- Average volume (200 days).
adjusted_close- Adjusted close price.
Highlights filter fields
MarketCapitalization- Total market value of outstanding shares.
MarketCapitalizationMln- Market capitalization in millions.
EBITDA- EBITDA trailing twelve months (TTM).
PERatio- Price-to-earnings ratio (TTM).
PEGRatio- Price/earnings-to-growth ratio.
WallStreetTargetPrice- Average analyst year-end price target.
BookValue- Book value per share (MRQ).
DividendShare- Dividends paid per share (TTM).
DividendYield- Annual dividend yield (TTM).
EarningsShare- Diluted EPS (TTM).
EPSEstimateCurrentYear- Analyst EPS estimate for the current fiscal year.
EPSEstimateNextYear- Analyst EPS estimate for the next fiscal year.
EPSEstimateCurrentQuarter- Analyst EPS estimate for the current quarter.
EPSEstimateNextQuarter- Analyst EPS estimate for the next quarter.
MostRecentQuarter- Most recent quarter with available financials.
ProfitMargin- Net profit margin.
OperatingMarginTTM- Operating margin (TTM).
ReturnOnAssetsTTM- Return on assets (TTM).
ReturnOnEquityTTM- Return on equity (TTM).
RevenueTTM- Total revenue (TTM).
RevenuePerShareTTM- Revenue per share (TTM).
QuarterlyRevenueGrowthYOY- Year-over-year quarterly revenue growth.
GrossProfitTTM- Gross profit (TTM).
DilutedEpsTTM- Diluted EPS (TTM).
QuarterlyEarningsGrowthYOY- Year-over-year quarterly earnings growth.
Keyfigures filter fields
net_income_margin- Margins: net income margin.
gross_margin- Margins: gross margin.
return_on_equity- Margins: return on equity.
return_on_assets- Margins: return on assets.
return_on_liabilities- Margins: return on liabilities.
EBIT_margin- Margins: EBIT margin.
EBITDA_margin- Margins: EBITDA margin.
cashflow_margin- Margins: cashflow margin.
free_cashflow_yield- Margins: free cashflow yield.
equity_ratio- Financials: equity ratio.
leverage- Financials: leverage.
debt_to_equity- Financials: debt-to-equity.
current_ratio- Financials: current ratio.
interest_coverage- Financials: interest coverage.
free_cashflow- Financials: free cashflow.
dynamic_debt- Financials: dynamic debt.
liquidity- Financials: liquidity.
r_and_d_investment_sales- Financials: R&D / sales.
earnings_growth- Growth: earnings growth.
sales_growth- Growth: sales growth.
sales_growth_3y_cagr- Growth: 3-year sales CAGR.
sales_growth_5y_cagr- Growth: 5-year sales CAGR.
earnings_growth_5y_cagr- Growth: 5-year earnings CAGR.
cashflow_growth- Growth: cashflow growth.
net_income_margin_rolling_quarters- Margins (rolling quarters): net income margin.
gross_margin_rolling_quarters- Margins (rolling quarters): gross margin.
return_on_equity_rolling_quarters- Margins (rolling quarters): ROE.
return_on_assets_rolling_quarters- Margins (rolling quarters): ROA.
return_on_liabilities_rolling_quarters- Margins (rolling quarters): return on liabilities.
EBIT_margin_rolling_quarters- Margins (rolling quarters): EBIT margin.
EBITDA_margin_rolling_quarters- Margins (rolling quarters): EBITDA margin.
cashflow_margin_rolling_quarters- Margins (rolling quarters): cashflow margin.
free_cashflow_yield_rolling_quarters- Margins (rolling quarters): free cashflow yield.
equity_ratio_rolling_quarters- Financials (rolling quarters): equity ratio.
leverage_rolling_quarters- Financials (rolling quarters): leverage.
debt_to_equity_rolling_quarters- Financials (rolling quarters): debt-to-equity.
current_ratio_rolling_quarters- Financials (rolling quarters): current ratio.
interest_coverage_rolling_quarters- Financials (rolling quarters): interest coverage.
free_cashflow_rolling_quarters- Financials (rolling quarters): free cashflow.
dynamic_debt_rolling_quarters- Financials (rolling quarters): dynamic debt.
liquidity_rolling_quarters- Financials (rolling quarters): liquidity.
r_and_d_investment_sales_rolling_quarters- Financials (rolling quarters): R&D / sales.
earnings_growth_rolling_quarters- Growth (rolling quarters): earnings growth.
sales_growth_rolling_quarters- Growth (rolling quarters): sales growth.
cashflow_growth_rolling_quarters- Growth (rolling quarters): cashflow growth.
stock_buybacks- Statistics: stock buybacks.
stock_buybacks_rolling_quarters- Statistics (rolling quarters): stock buybacks.
wallstreet_estimate_upside- Analysts: Wall Street estimate upside.
estimate_eps_growth_1y- Analysts: estimated EPS growth 1Y.
estimate_eps_growth_2y- Analysts: estimated EPS growth 2Y.
EPSEstimateCurrentYear- Analysts: EPS estimate current year.
EPSEstimateNextYear- Analysts: EPS estimate next year.
EPSEstimateCurrentQuarter- Analysts: EPS estimate current quarter.
EPSEstimateNextQuarter- Analysts: EPS estimate next quarter.
ForwardPE- Analysts: forward P/E.
PEGRatio- Analysts: PEG ratio.
analyst_rating- Analysts: consensus rating.
analyst_upside- Analysts: upside vs target.
ShortPercentFloat- Statistics: short percent of float.
PercentInsiders- Statistics: insider ownership %.
PercentInstitutions- Statistics: institutional ownership %.
Field aliases
pe- Alias for PERatio.
pe_ratio- Alias for PERatio.
roe- Alias for ReturnOnEquityTTM.
roa- Alias for ReturnOnAssetsTTM.
operating_margin- Alias for OperatingMarginTTM.
ebit_margin- Alias for EBIT_margin (keyfigures).
market_cap- Alias for MarketCapitalization.
Market signals
50d_new_lo- Price at a new 50-day low.
50d_new_hi- Price at a new 50-day high.
200d_new_lo- Price at a new 200-day low.
200d_new_hi- Price at a new 200-day high.
bookvalue_neg- Price below book value.
bookvalue_pos- Price above book value.
wallstreet_lo- Price below Wall Street target.
wallstreet_hi- Price above Wall Street target.
Frequently Asked Questions
How do I filter the screener?
Use the
filters query parameter as a JSON array of [field, operator, value] triplets, e.g. filters=[["pe","<",15],["sector","=","Technology"]]. Also: signals, preset, sort, limit (max 1000), offset. Full field list: API Glossary (Screener).Which signals are available?
50d_new_lo/hi (new 50-day low/high), 200d_new_lo/hi (new 200-day low/high), bookvalue_neg/pos (price below/above book value), wallstreet_lo/hi (price below/above Wall Street target) – combinable with filters.How are request units counted?
The screener costs 10 request units per call – regardless of
limit and offset.How do I call the screener?
Via GET request: https://api.leeway.tech/api/v1/public/general/screener
Ready for the best API experience?
Start with 100 free request units per day.
