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'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
