One challenge developers face when working with financial data is identifying a stock, company, security, index or other financial entity across data sets. Is Apple Inc. the same as AAPL in your code? This seems like a simple example but things can quickly get more complicated when working with numerous data types and thousands of securities in the same application. The Security Master Data Feed serves as a guide for investors and developers working with multiple data sets, providing an authoritative source of information about the various identifiers associated with an economic entity.
The Security Master Data Feed is designed to make it possible to bring multiple data sets together without running into confusion when the curators of those data sets create non-unique names. Typically, when users run into these challenges, they are forced to use the names used by the data providers, which can slow down development and create headaches for end-users who aren't sure what they are looking at. With the Security Master data feed, investors and developers can use the identifier that suits their needs rather than adjusting their system to suit the data provider's naming convention. By searching the security master, users can quickly and definitively see how that entity is named across data sets.
Intrinio offers a variety of ways to access this data feed. Choose your preferred access method below:
Welcome to the Intrinio Financial Data Platform! Through our Data Marketplace, we offer a wide selection of financial data feeds sourced by our own proprietary processes as well as from many data vendors. The Intrinio API uses HTTPS verbs and a RESTful endpoint structure, which makes it easy to request data from Intrinio. Basic Authentication is administered over HTTPS. Responses are delivered in JSON format.
If you need additional help in using the API, chat with us.
For a quick guide to getting started with our API, please see the Tutorial.
For private/trusted environments, use Basic Authentication over HTTPS.
You can find your API Username and API Password on your Account page. You must include these credentials with every request in order to receive access to the API.
To include the credentials in your HTTPS request, specify an Authorization header, with the value Basic (key) , replacing (key) with the Base-64 encoded string API_USERNAME:API_PASSWORD .
If your credentials are not authorized, a status code of 401 will be returned.
You can create a Public Access Key on your Account page. Make sure to specify all domains from which this key may be used. Any domain not listed will be rejected by the API. For development purposes, localhost is listed as a domain by default. Make sure to delete this domain before going to production.
To include a public key in your HTTPS request, specify it as the value of an X-Authorization-Public-Key header.
If your public key is not authorized, a status code of 401 will be returned.
Intrinio uses normal HTTP response codes to indicate the success or failure of an API request. A response code of 200 indicates success and codes in the 4xx range indicate an error that failed given the information provided, and codes in the 5xx range indicate an error with Intrinio’s servers (these are rare).
The Intrinio API uses the following error codes:
|200||OK – Everything worked as expected|
|401||Unauthorized – Your User/Password API Keys are incorrect|
|403||Forbidden – You are not subscribed to the data feed requested|
|404||Not Found – The endpoint requested does not exist|
|429||Too Many Requests – You have hit a limit. See limits|
|500||Internal Server Error – We had a problem with our server. Try again later.|
|503||Service Unavailable – You have hit your throttle limit or Intrinio may be experiencing high system load.|
Often there is too much information in our system to serve in a single request of reasonable size. Therefore we limit results to a certain number per request and provide you with paging information which can be used to retrieve the remaining pages of data.
In the Web API, you will notice that most requests contain paging information.
File Downloads may have paging information as well, listed in the first row.
In order to request the next page of data, append a page_number parameter to your request:
The Intrinio API employs several reasonable limits to ensure that stable, reliable service is provided to all users. These limits can vary based on which data feeds you are subscribed to, as well as which API call you are making. The limits are grouped as: daily calls, 10-minute calls, paging, throttling, and timeouts. If you hit an API limit, the response will contain a 429 code and an explanation of the limit.
Most data feed subscriptions have limited daily usage. This means that you can make up to a certain number of API calls in a 24-hour period (resetting at midnight Eastern). To view the limits for a data feed subscription, go to your Account page, click on Subscriptions, click on the subscription in question, and click on Limits.
Some data feed subscriptions have limited 10-minute usage. This means that you can make up to a certain number of API calls in a 10-minute period.
As an alternative to Daily Call Limits, some data feeds employ a 1-minute call limit. This means that you can make up to a certain number of API calls in a 1-minute period.
API endpoints that employ paging are limited by the maximum page size that you may request. This varies by endpoint:
|Endpoint||Maximum Page Size|
Users enjoying free data feed subscriptions only are limited to 100 requests-per-second.
Each request must be fulfilled within 25 seconds, otherwise it will be dropped with a 503 error. Given the flexibility of our endpoints and the complexity of potential API calls, we leave it to the users to fashion requests which can be satisfied in a reasonable time.
The following endpoints will help you to check your API access, limits, and usage:
Note: this is limited to data feeds with daily API call limits.
Below are all of the API endpoints available for this data feed:
Welcome to the Intrinio Financial Data Platform! Through our Data Marketplace, we offer a wide selection of financial data feeds sourced by our own proprietary processes as well as from many data vendors. All of our data is available for download in the CSV (comma-separated values) format.
If you need additional help, chat with us.
For a quick guide to getting started with our CSV Download functionality, please see the Tutorial.
When using the download links, your browser will prompt you for a username and password. These credentials correspond to your access keys, which can be found in your Account page.
Sometimes there is too much information in our system to put into a single file of reasonable size. Therefore we limit file downloads to 10,000 rows. In order to retrieve the rest of the rows, you will have to request the second "page" of results. The first row of each file will contain paging information: RESULT_COUNT: 6342 , PAGE_SIZE: 10000 , CURRENT_PAGE: 1, TOTAL_PAGES: 1 , API_CALL_CREDITS: 1
If the TOTAL_PAGES field in your file is greater than 1 and you want to see the other pages, append a page_number parameter to the URL:
To exclude the paging information from your file, include a hide_paging parameter in the URL:
URLs must be formatted correctly in order for file downloads to be processed successfully. Here are examples of correct URLs:
Here are examples of incorrect URLs:
Here is a key to the different parts of a URL:
Below are all of the CSV file downloads available for this data feed:
Returns security list and information for all securities covered by Intrinio.
|query||A string query search of security name or ticker symbol with the returned results being the relevant securities in compacted list format.||AAPL|
|identifier||The identifier for the legal entity or a security associated with the security.||A|
|exch_symbol||The Intrinio Stock Market Symbol, to specify the exchange for the list of securities.||NYSE|
|last_crsp_adj_date||A date value that returns the list of securities that have had adjusted stock prices due to a corporate event after this date.||2017-12-29|
Return only US-based securities.
|page_number||An integer greater than or equal to 1 for specifying the page number for the return values.||3|
|page_size||An integer greater than or equal to 1 for specifying the number of results on each page.||15|
Hide first row of paging information.
|ticker||the stock market ticker symbol associated with the companies common stock securities||A|
|figi_ticker||the OpenFIGI ticker symbol||A:UN|
|figi||the OpenFIGI identifier||BBG000C2V541|
|composite_figi||the OpenFIGI composite-level identifier||BBG000C2V3D6|
|composite_figi_ticker||the OpenFIGI composite-level ticker||BBG00B3T3HD3|
|security_name||the security description as provided by the exchange||Alcoa Corp|
|market_sector||the type of market for the security||Equity|
|security_type||the type of security, such as Common Stock, Preferred Stock, Warrants, Limited Partnership Interests, etc.||Ordinary Shares|
|stock_exchange||the Stock Exchange (and market category) where the company’s common stock is primarily traded||NYSE|
|last_crsp_adj_date||the last recorded date (“YYYY-MM-DD”) of an CRSP adjustment made to prior prices due to a stock split or dividend event.||2017-12-29|
|figi_uniqueid||the security’s unique FIGI identifier||EQ0000000045469815|
|share_class_figi||the security’s share class FIGI identifier||BBG00B3T3HF1|
|figi_exch_cntry||the security’s FIGI country of the exchange||US|
|currency||the security’s traded currency on the listed exchange||USD|
|mic||the Market Identification Code for the Stock Exchange where the security is listed.||XNYS|
|exch_symbol||the Intrinio Stock Exchange Symbol used as an identifier on the Intrinio API.||^XNYS|
|etf||a boolean to represent whether the security is an ETF or otherwise||false|
|delisted_security||if the security is no longer traded on public exchanges, the security will be considered delisted and the security no longer will report pricing data.||false|
|primary_listing||a boolean to represent whether the security is the primary issue or a secondary issue of the security on a different stock exchange.||true|
Not available for this access method
Not available for this access method
Returns stock exchange list and information for all stock exchanges covered by Intrinio.
|query||A string query search of stock exchange name or MIC with the returned results being the relevant stock exchanges in compacted list format.||NYSE|
|page_number||An integer greater than or equal to 1 for specifying the page number for the return values.||2|
|page_size||An integer greater than or equal to 1 for specifying the number of results on each page.||10|
Hide first row of paging information.
|symbol||the Intrinio symbol associated with the stock exchange||^BMEX|
|mic||the MIC identifier for the stock exchange||BMEX|
|institution_name||the name of the stock exchange||BME - BOLSAS Y MERCADOS ESPANOLES|
|acronym||the stock exchanges short form identifier||BME|
|city||the city where the stock exchange is located||MADRID|
|country||the country where the stock exchange is located||SPAIN|
|country_code||the country code for the country where the stock exchange is located||ES|
|website||the website for the stock exchange||HTTP://WWW.BOLSASYMERCADOS.ES|
Not available for this access method