We looked up the number of Google searches for “Stock Screener API” and found out that only between 10-100 people search for it each month. That’s a tiny market, but if that is what you were looking for, you’ve come to the right place. This article explains what Intrinio’s stock screener API is and how to get access, and provides example API calls.
What is the stock screener API?
The stock screener API is just that – it allows a fintech developer to sort through securities to find those that meet a set of predefined conditions. This is not a tool for financial analysts or non-developers. It is really easy to make the API calls but it requires a programming language to do more than copy and paste results.
The screener uses Intrinio’s RESTful API to return a list of stocks that meet predefined conditions. The ticker and the value for each parameter are returned and can be called in just about any language using curl or other packages native to that environment.
How do I get access?
Setting up an Intrinio account and getting API keys is free and easy. You can set up an account and copy your API username and API password here.
After you set up an account, you will need to visit the Financial Data Marketplace to take a free trial, or subscribe, to the data feeds of your choice. Using the Economic and US Fundamentals and Stock Prices data feeds, you’re able to screen stocks based on hundreds of parameters including anything from a balance sheet or income statement to valuation metrics like EBITA and P/E.
This article explains how to get started with the API in general and includes examples of authenticating, sample code in numerous languages (Python, R, Ruby, C#, Node JS, Swift, PHP, etc), and sample API calls.
Example Stock Screener API calls
NOTE: The examples below are for v1 of the Intrinio API. If you’re using API v2, follow the v2 documentation instead.
Here is an example showing a single screen for stocks with a price to earnings ratio greater than 15:
The gt represents greater than. If you paste that call into your browser, you should be prompted for your API keys which you can copy from intrinio.com/login.
Once you have entered your API keys, you will see the JSON response. The end of the response includes the total number of pages, so that for screens with more than 250 results a pager can be used to return the entire response.
This example shows how to make an API call with multiple parameters:
In this case, the response will show stocks with an open price less than or equal to (lte) $10.5 and a P/E ratio greater than or equal to 10 (gte).
This call shows yesterday’s price gainers:
And the losers:
This call shows how to find all of the stocks in a specific industry by searching SIC codes:
It’s important to note that you can also search text fields, such as the company description, using the “contains” parameter. Don’t forget that percents should be in decimal form. For example:
This will return securities with a percent change greater than 200%.
This will return securities with a percent change greater than 2%.
Above is an example on how to return US securities from both the Technology and Basic Materials sector. Note that there is a space around the OR parameter – if you paste this in your browser, it will automatically fill in “%”s that will enable you to use this logic in your code.
This will return ADRs or Common stock for securities with those security types.
Why Use Intrinio?
Unlike big data providers, Intrinio doesn’t bundle data feeds into an expensive monthly subscription. In fact, many of its feeds offer free trials so that you’re able to test out the data before you subscribe.
Unlike smaller data providers, Intrinio only has one API. This means you can subscribe to the data feeds you need while still using a single API or Excel syntax rather than a different syntax for each provider.
This simplicity and cost structure is designed to make financial data easy to access and affordable for fintech developers and financial analysts. That’s our mission, and the stock screener API is just another way we are increasing affordable access.