Stock Screener

Screen stocks based on a set of criteria. This can be useful to find companies that match a specific criteria or your analysis. Further filtering can be done by utilising the Finance Toolkit and calculating the relevant ratios to filter by. This can be:

• Market capitalization (market_cap_higher, market_cap_lower)
• Price (price_higher, price_lower)
• Beta (beta_higher, beta_lower)
• Volume (volume_higher, volume_lower)
• Dividend (dividend_higher, dividend_lower)
• Classification (sector, industry, country, exchange, is_etf)

The result is capped at limit companies, 1000 by default. Getting back exactly that many means the list was truncated, which is warned about in the log; narrow the criteria or raise the limit to see the remainder.

Also known as: filter stocks, financial criteria screener.

Stock Screener in Python or via the MCP

Install the Finance Toolkit with:

pip install financetoolkit -U

Then call get_stock_screener as shown below.

from financetoolkit import Discovery

discovery = Discovery(api_key="FINANCIAL_MODELING_PREP_KEY")

discovery.get_stock_screener(
    market_cap_higher=1000000,
    market_cap_lower=200000000000,
    price_higher=100,
    price_lower=200,
    beta_higher=1,
    beta_lower=1.5,
    volume_higher=100000,
    volume_lower=2000000,
    dividend_higher=1,
    dividend_lower=2,
    is_etf=False
)

Or, after setting up the Finance Toolkit MCP, ask:

Which returns:

Parameters

get_stock_screener accepts the following parameters.

Related Discovery Functions