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. Thats 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, 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 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 access is easy. You can set up an account and copy your API access key at intrinio.com/login.

After you set up an account you can take a free trial of many of our data feeds, such as Economic and US Fundamentals data. This means you can screen on hundreds of parameters including anything from a balance sheet or income statement and valuation metrics like EBITA and P/E.

This section contains examples of how to get started with the API in general and includes articles on authenticating, REST API sample codes in numerous languages (Python, R, Ruby, C#, Node JS, Java, etc), and sample API calls.

EXAMPLE STOCK SCREENER API CALLS

You can view the documentation for the API screener here. It shows the base syntax of the API and the conditions that can be added to screen stocks. You can look up tags to use in your calls here.

Here is an example showing a single screen for stocks with a price to earnings ratio greater than 15:

https://api.intrinio.com/securities/search?conditions=pricetoearnings~gt~15

The gt represents greater than. If you paste that call into your browser, you should be prompted for your API access key which you can copy from intrinio.com/login

Add your single access key at the end of the url, in this format: https://api.intrinio.com/securities/search?conditions=pricetoearnings~gt~15&api_key=[your api key here]

Once you have entered your API keys you will see the JSON response:

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:

https://api.intrinio.com/securities/search?conditions=open_price~lte~10.50,pricetoearnings~gte~10

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:

https://api.intrinio.com/securities/search?conditions=percent_change~gt~0&order_column=percent_change&order_direction=desc

And the losers:

https://api.intrinio.com/securities/search?conditions=percent_change~lt~0&order_column=percent_change&order_direction=asc

This call shows how to find all of the stocks in a specific industry by searching SIC codes:

https://api.intrinio.com/securities/search?conditions=sic~eq~1000

Its 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:

https://api.intrinio.com/securities/search?conditions=change~gt~2

This will return securities with a percent change greater than 200%.

https://api.intrinio.com/securities/search?conditions=change~gt~.02

This will return securities with a percent change greater than 2%.

https://api.intrinio.com/securities/search?conditions=sector~eq~BasicMaterials~basicmat,sector~eq~Technology~tech&logic=basicmat OR tech

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.

https://api.intrinio.com/securities/search?conditions=security_type~eq~Common%20Stock~Common,security_type~eq~ADR~ADR&logic=(Common%20OR%20ADR)

This will return ADRs or Common stock for securities with those security types. 

Screen Based on Exchange:

This will give you the exchange identifiers:

https://api.intrinio.com/stock_exchanges

Then you can use this:

https://api.intrinio.com/securities?exch_symbol={stock-exchange-symbol}

So it would look like this:

https://api.intrinio.com/securities?exch_symbol=XNYS

WHY USE INTRINIO?

Unlike big data providers, Intrinio doesn't bundle data feeds into an expensive monthly subscription. In fact, many of its feeds have free trials and others include redistribution at prices that are disruptively affordable.

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.

Did this answer your question?