Global Security Master | Intrinio

Global Security Master

Provided by Intrinio
Info
Pricing
Documentation
Resources
Data Explorer

Flexible Access

This data is available via Web API.

Centralized Financial Data

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. 

Flexible Identifiers

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. 

Have Questions?
Features
  • Current and Previous aliases for an economic entity
  • View active and de-listed securities
  • Get basic details to identify the entities you need to analyze
Need a bulk historical download?
Buy a one-time historical download of this data
Browse Options

Custom Pricing with Intrinio

We offer custom pricing and plans for enterprises and start-ups because we don't think that you should pay an outrageous cost for data you don't use.
With Intrinio, you'll only pay for the data you need an an affordable rate.

Global Security Master

Request a Quote

Request Sent! Thank You.
{{ submittedText }}
*
*
*
*
*
*
License
Non-Professional
define
Professional
define
Startup
define
Enterprise
define
Student/Military, 50% off
define
Usage
Non-Display
define
Display
define
Billing
Monthly
Yearly, Save 15%
Your Price
Questions?
Chat with Us
$
Request a Quote
The options you have selected require a custom quote.
Request Quote
Subscribe
Need to take a test drive?
7 days, 500 API calls Free Trial
Join our Developer Program
Free data for 6 months to build your app Apply

Frequently Asked Questions

Below you will find the most frequently asked questions about this data feed. We have also curated some resources to help you get started, listed on the right. As always, feel free to chat with us if you have any questions.
Why doesn't the companies endpoint return data for all securities?
  • The companies endpoint strictly returns public companies registered in the US, filing with the SEC. It does not include any international public companies not registered in the US.
  • The securities endpoint will work with all security types, US and international.
Does your security master include delisted companies?
  • Yes, our security master includes delisted US and international companies/securities back to 2007.
- or -
Data Categories

Intrinio offers a variety of ways to access this data feed. Choose your preferred access method below:

API
CSV

API Documentation

There are two versions of our API. We recommend "v2". To learn which one may be right for you, click here.
API v1
API v2

{{ docSectionTitle }} Documentation

Welcome to the Intrinio Financial Data Platform! Through our Financial 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.

Getting Started

First, you'll need an Intrinio account for your API access credentials.

Sign Up for API Access

If you have an Intrinio account you can view your API access keys here.

For a quick-start guide to our API, please see the tutorial.

If you need additional help using the API, chat with us.

Authentication

Private

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.

Public

For public/untrusted environments (such as client-side JavaScript), use our public key authentication over HTTPS.

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.

Response Codes

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:

Code Meaning
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.

Paging

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:

https://api.intrinio.com/companies
https://api.intrinio.com/companies?page_number=2
https://api.intrinio.com/companies?page_number=3

Limits

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.

Daily Call Limits

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.

10-Minute Call 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.

1-Minute Call Limits

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.

Paging Limits

API endpoints that employ paging are limited by the maximum page size that you may request. This varies by endpoint:

Endpoint Maximum Page Size
/historical_data 1,000
All others 100

Throttle Limits

Users enjoying free data feed subscriptions only are limited to 100 requests-per-second.

Timeout Limits

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.

Usage & Limits

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.

Endpoints

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.

Getting Started

For a quick guide to getting started with our CSV Download functionality, please see the Tutorial.

Authentication

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.

Limits

The CSV Download functionality is well-suited for human use or light programmatic use. Downloads are limited to 1 per second. If you exceed this limit, the system will return a 429 error. If you need to download larger dataset, we recommend browsing our Financial Data Downloads , which allow you to download massive datasets for a flat fee.

Paging

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

  • RESULT_COUNT tells you how many total rows there are in our system
  • PAGE_SIZE tells you how many records you are fetching per page
  • CURRENT_PAGE tells you which page you are currently viewing
  • TOTAL_PAGES tells you how many total pages there are
  • API_CALL_CREDITS tells you how many API calls credits your request consumed

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:

https://api.intrinio.com/indices.csv?type=economic&page_number=1
https://api.intrinio.com/indices.csv?type=economic&page_number=2
https://api.intrinio.com/indices.csv?type=economic&page_number=3

To exclude the paging information from your file, include a hide_paging parameter in the URL:

https://api.intrinio.com/indices.csv?type=economic&page_number=1&hide_paging=true

URL Formatting

URLs must be formatted correctly in order for file downloads to be processed successfully. Here are examples of correct URLs:

https://api.intrinio.com/indices.csv
https://api.intrinio.com/indices.csv?type=economic
https://api.intrinio.com/indices.csv?type=economic&query=GDP
https://api.intrinio.com/data_point.csv?identifier=AAPL&item=marketcap,beta

Here are examples of incorrect URLs:

https://api.intrinio.com/indices.csv&type=economic
https://api.intrinio.com/indices.csv?type=economic?query=GDP
https://api.intrinio.com/data_point.csv?identifier=AAPL&item=marketcap/beta

Here is a key to the different parts of a URL:

https://api.intrinio.com /data_point.csv ? identifier = AAPL & item = marketcap,beta
1 2 3 4 5 6 7 8 9 10

  1. Intrinio's API web address.
  2. The location of the data you are trying to access.
  3. The separator between the URL address and the URL parameters.
  4. The name of the URL parameter.
  5. The separator between the name of the URL parameter and the value of the URL parameter.
  6. The value of the URL parameter.
  7. The separator between URL parameters.
  8. The name of the URL parameter.
  9. The separator between the name of the URL parameter and the value of the URL parameter.
  10. The value of the URL parameter. Note some parameters allow multiple values - separate them with a comma.

Functions

Below are all of the CSV file downloads available for this data feed:

Returns security list and information for all securities covered by Intrinio.

Parameters

expand collapse
Name Description Example
query
* required
A string query search of security name or ticker symbol with the returned results being the relevant securities in compacted list format. AAPL
identifier
* required
The identifier for the legal entity or a security associated with the security. A
exch_symbol
* required
The Intrinio Stock Market Symbol, to specify the exchange for the list of securities. NYSE
last_crsp_adj_date
* required
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
us_only
* required
Return only US-based securities.
Options:
Yes
Yes
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 15
hide_paging
* required
Hide first row of paging information.
Options:
true
-

Output Fields

expand collapse
Name Description Example
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

Sample Data

expand collapse

Security Master

Returns a list of summary information about all US securities
URL:

Security Master

Returns a list of summary information about all US securities
URL:

Security Master

Not available for this access method

Security Lookup

Returns detailed information about a single security
URL:

Security Lookup

Returns detailed information about a single security
URL:

Security Lookup

Not available for this access method

Stock Exchanges

Returns stock exchange list and information for all stock exchanges covered by Intrinio.

Parameters

expand collapse
Name Description Example
identifier
* required
An identifer for a stock exchange, which can be the MIC, symbol, or acronym. XLON
query
* required
A string query search of stock exchange name or MIC with the returned results being the relevant stock exchanges in compacted list format. London
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 2
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

expand collapse
Name Description Example
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

Sample Data

expand collapse

Stock Exchange Master

Returns stock exchange list and information for all stock exchanges covered by Intrinio.
URL:

Stock Exchange Master

Returns stock exchange list and information for all stock exchanges covered by Intrinio.
URL:

Stock Exchange Master

Not available for this access method