{"id":1843,"date":"2020-10-11T15:27:09","date_gmt":"2020-10-11T15:27:09","guid":{"rendered":"https:\/\/eodhd.com\/financial-apis\/?p=1843"},"modified":"2026-08-13T15:14:31","modified_gmt":"2026-08-13T13:14:31","slug":"stock-market-screener-api","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/stock-market-screener-api","title":{"rendered":"Stock Market Screener API"},"content":{"rendered":"\n

The Screener API filters the whole covered stock universe in a single request \u2014 by market capitalisation, exchange, sector, industry, EPS, dividend yield, recent performance and traded volume \u2014 and returns the matching tickers with the values you filtered on. It is the endpoint behind “top gainers today”, “large-cap technology companies”, “high-yield dividend payers” and similar screens.<\/p>\n\n\n\n

Filters are passed as a JSON array of conditions that all have to hold at once, sorting is a single field with a direction, and results are paginated with limit and offset. Values come from the latest completed trading day \u2014 every row carries the date it was taken from in last_day_data_date<\/strong>.<\/p>\n\n\n\n\n\n\n

<\/div>\n\n\n\n

How to call the Screener API<\/h2>\n\n\n
\n
https:\/\/eodhd.com\/api\/screener?api_token=YOUR_API_TOKEN&filters=[[\"exchange\",\"=\",\"us\"],[\"market_capitalization\",\">\",10000000000]]&sort=market_capitalization.desc&limit=10&offset=0<\/code><\/pre>\n<\/div>\n\n\n
Parameters<\/h4>\n\n\n
\n    \n
\n    
\n                    api_token<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Your EODHD API token<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    filters<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Filter conditions as a JSON array of triples: [[field, operation, value], \u2026]. Conditions are combined with AND. Must be valid JSON with straight double quotes<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    signals<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Comma-separated list of pre-calculated signals, for example bookvalue_neg,200d_new_lo. Several signals narrow the result further<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    sort<\/code>\n        \n                    string<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Sort as field_name.direction, for example market_capitalization.desc. Direction is asc or desc; every filterable field is also sortable<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    limit<\/code>\n        \n                    integer<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Number of tickers to return<\/span>\n                    (Default: 50, Range: 1-500)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    offset<\/code>\n        \n                    integer<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Number of tickers to skip, for paging. limit=100 with offset=200 returns rows 201-300. Because the offset stops at 999, no screen can be paged beyond its first 1,000 matches<\/span>\n                    (Default: 0, Range: 0-999)<\/em><\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n    
\n        <\/svg><\/span>\n        
\n\n
The filters value must be valid JSON with straight double quotes. Curly typographic quotes \u2014 the kind a word processor produces \u2014 return HTTP 422 with “The filters must be a valid JSON string”. Requesting more than 500 rows, or an offset above 999, also returns 422. Since paging stops at offset 999, a single screen exposes at most its first 1,000 matches \u2014 narrow the filters, or split the screen by exchange or by market-capitalisation band, when a query matches more than that.<\/p>\n\n<\/div>\n    <\/div>\n    \n\n\n
Request Example<\/h4>\n\n\n\n
The five largest companies by market capitalisation, no filters:<\/p>\n\n\n\n
    
\n                
\n            
\n                                                                        URL<\/button>\n                                                                            cURL<\/button>\n                                                                            PHP<\/button>\n                                                                            Python<\/button>\n                                                                            R<\/button>\n                                                                            Chat GPT<\/button>\n                                                <\/div>\n            
\n