If you need to make multiple API queries with complex selections from our financial database, then our powerful Stock Market Screener API tool is perfect for you.

The Stock Market Screener API allows users to filter companies with defined parameters – such as market capitalization, exchange, industry, dividend yield, and a bunch of others – in a fraction of a second.

For example, how to filter out companies in the biological sector with a capitalization of 2 to 5 billion, starting with A, with a dividend yield > 9% and which yesterday had growth from 10% to 20% and, if desired, with a number of conditions? With our screener, you will receive output for analysis in a fraction of a second.

Register & Get Data

Please note: before continuing to work with our APIs, make sure that you import and install all required libraries. More details information about the functions of the Stock Market Screener API can be found on our documentation web-page.

Accessing the EODHD API

To access the EODHD API, we need to create an instance of the “APIClient” class and pass our API key to it. In this example, we will use the demo API key provided by EODHD, but in your real application, you should use your registered API key.

api = APIClient("demo")

Please note that you can also specify the API key in a configuration file or as an environment variable, as described in the library documentation here.

1. Use “DEMO” API key to test our data from a limited set of the tickers without registering:
Real-Time Data and All of the APIs (except Bulk) are included without limitations on API calls.
2. Register to get your free API key (limitated by 20 API calls per day) with access to:
End-Of-Day Historical Data with only past year for any ticker and List of tickers per Exchange
3. To unlock your API key we recommend to choose subscription which covers your needs

Retrieving Screener Data

The Screener API is available under ‘All World Extended’ and ‘All-In-One’ data packages. Each Screener API request consumes 5 API calls. The Screener API is a powerful tool that helps you filter out tickers with the given parameters. 

List of supported parameters

Filter – filters out tickers by different fields. For example: filters=[[“field1”, “operation1”, value1],[“field2”, “operation2”, value2] , … ].

Signals – Filter out tickers by signals, the calculated fields. For example, signals=signal1,signal2,…

Sort – Sorts all fields with type ‘Number’ in ascending/descending order. 

Limit – the number of results should be returned with the query. Default value: 50, minimum value: 1, maximum value: 100. 

Offset – The offset of the data. Default value: 0, minimum value: 0, maximum value: 1000. For example, to get 100 symbols starting from 200 you should use limit=100 and offset=200.

screener_extended = api.stock_market_screener (filters = [["market_capitalization",">",1000]], limit = "100", offset = "200")

The API response is a JSON array containing data for all the requested tickers. You can convert the resulting JSON array to a DataFrame for further analysis:

screener_m = pd.DataFrame(screener_extended)
print (screener_m)

List of supported signals

  • 50d_new_lo50d_new_hi200d_new_lo200d_new_hi – filters tickers that have new 50/200 days lows or new 50/200 days highs.
  • bookvalue_negbookvalue_pos – filters tickers with positive Book Value or with Negative Book Value.
  • wallstreet_lowallstreet_hi – filters tickers that have a price lower or higher than expected by Wall Street analysts.


In essence, the Screener API is your invaluable ally in the world of financial data analysis, helping you unlock insights, make informed decisions, and navigate the complexities of the stock market with confidence and efficiency. It’s a tool designed to save you time and provide you with the data-driven edge you need in the competitive world of finance. Happy screening!

Register & Get Data