The Global Public Company Security Master API is the first publicly available security reference via an open REST API.  This is only possible due to the amazing work of the team at OpenFIGI, who are tirelessly advocating for their new standard for non-proprietary security identifiers.  Prior to the release of the Intrinio Global Public Company Security Master API powered by OpenFIGI, most security masters were built based on the ISIN paradigm, a proprietary identifier that requires paying substantial license fees to the American Bankers Association and Standard & Poor's. 

IMPORTANT LINKS

WHAT DATA IS INCLUDED?

  • Company master - a dynamic reference list of all companies covered by Intrinio linked to US SEC unique entity identifiers
  • Security master - a dynamic reference list of all securities covered by Intrinio linked to FIGI identifiers
  • Stock Exchange master - a list of all stock markets covered by Intrinio, tied to the market identifier code (MIC)
  • Index master - a reference list of all stock market indices, sector and industry indices and economic indices
  • Owner master - a dynamic reference list of all institutional owners and insider owners of securities

GETTING STARTED WITH THE API

If you're leveraging the REST API to access the Global Public Company Security Master Data Feed, you'll want to get started with the following tutorial:

Getting Started With the Intrinio API

COMPANY MASTER

The following is the API Call and example response for retrieving the Company master:

https://api.intrinio.com/companies

{
  "result_count": 16709,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 67,
  "api_call_credits": 1,
  "data": [
    {
      "ticker": "ADM",
      "name": "Archer Daniels Midland Co",
      "lei": "549300LO13MQ9HYSTR83",
      "cik": "0000007084",
      "latest_filing_date": "2017-10-31"
    },
    {
      "ticker": "ADMA",
      "name": "ADMA Biologics Inc",
      "lei": null,
      "cik": "0001368514",
      "latest_filing_date": "2017-11-03"
    },
    {
      "ticker": "ADMD",
      "name": "Advanced Medical Isotope Corp",
      "lei": null,
      "cik": "0001449349",
      "latest_filing_date": "2017-11-13"
    },
    {
      "ticker": "ADMG",
      "name": "ADAMANT DRI PROCESSING & MINERALS GROUP",
      "lei": null,
      "cik": "0001171008",
      "latest_filing_date": "2017-11-17"
    }
    ...
  ]
}

The response included provides a listing of all companies in our dataset.  This is useful for providing you a list of all companies used in other parts of the API, or to obtain basic information about each company.  For more detailed company information, you will need to use the US Fundamentals and Stock Prices.

To look up a company, you would make this API call:

https://api.intrinio.com/companies?query=Amazon

{
  "result_count": 2,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 1,
  "api_call_credits": 1,
  "data": [
    {
      "ticker": "AMZN",
      "name": "Amazon.com Inc",
      "lei": "ZXTILKJKG63JELOEG630",
      "cik": "0001018724",
      "latest_filing_date": "2017-10-27"
    },
    {
      "ticker": "AMZO",
      "name": "AMAZON BIOTECH INC",
      "lei": null,
      "cik": "0001088781",
      "latest_filing_date": null
    }
  ]
}

SECURITY MASTER

The following is the API Call for  a listing of all securities listed on the Deutsche Boerse (MIC: XFRA)
https://api.intrinio.com/securities?exch_symbol=^XFRA

{
  "result_count": 18794,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 76,
  "api_call_credits": 1,
  "data": [
    {
      "ticker": "001",
      "figi_ticker": "001:GF",
      "figi": "BBG00D20DM23",
      "composite_figi": "BBG00D20DM14",
      "composite_figi_ticker": "001:GR",
      "security_name": "CARDTRONICS PLC - A",
      "market_sector": "Equity",
      "security_type": "Common Stock",
      "stock_exchange": "FRA",
      "last_crsp_adj_date": null
    },
    {
      "ticker": "008",
      "figi_ticker": "008:GF",
      "figi": "BBG00B9TY6K9",
      "composite_figi": "BBG00B9TY6J1",
      "composite_figi_ticker": "008:GR",
      "security_name": "MULTI PACKAGING SOLUTIONS INTERNATIONAL LTD",
      "market_sector": "Equity",
      "security_type": "Common Stock",
      "stock_exchange": "FRA",
      "last_crsp_adj_date": null
    },
    ...
  ]
}

To query to find a security, you would make this API call:

https://api.intrinio.com/securities?query=Amazon

{
  "result_count": 23,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 1,
  "api_call_credits": 1,
  "data": [
    {
      "ticker": "0R1O",
      "figi_ticker": "AMZNCHF:XL",
      "figi": "BBG007F5VLR6",
      "composite_figi": "BBG007F5VLG8",
      "composite_figi_ticker": "AMZNCHF:XL",
      "security_name": "AMAZON.COM INC",
      "market_sector": "Equity",
      "security_type": "Common Stock",
      "stock_exchange": "LSE",
      "last_crsp_adj_date": null
    },
    {
      "ticker": "AMZ",
      "figi_ticker": "AMZ:GQ",
      "figi": "BBG000BWBG26",
      "composite_figi": "BBG000BWB8W1",
      "composite_figi_ticker": "AMZ:GR",
      "security_name": "AMAZON.COM INC.",
      "market_sector": "Equity",
      "security_type": "Common Stock",
      "stock_exchange": "XETRA",
      "last_crsp_adj_date": null
    },
    {
      "ticker": "AMZ",
      "figi_ticker": "AMZ:GF",
      "figi": "BBG000BWBB63",
      "composite_figi": "BBG000BWB8W1",
      "composite_figi_ticker": "AMZ:GR",
      "security_name": "AMAZON.COM INC",
      "market_sector": "Equity",
      "security_type": "Common Stock",
      "stock_exchange": "FRA",
      "last_crsp_adj_date": null
    },
    {
      "ticker": "AMZN",
      "figi_ticker": "AMZN:UW",
      "figi": "BBG000BVQ4Z3",
      "composite_figi": "BBG000BVPV84",
      "composite_figi_ticker": "AMZN:US",
      "security_name": "AMAZON.COM INC",
      "market_sector": "Equity",
      "security_type": "Common Stock",
      "stock_exchange": "NASDAQ",
      "last_crsp_adj_date": "1999-09-02"
    },
    ...
  ]
}

To look up a specific security, you would make this API call:

https://api.intrinio.com/securities?identifier=AMZN:US

{
  "ticker": "AMZN",
  "figi_ticker": "AMZN:UW",
  "figi": "BBG000BVQ4Z3",
  "composite_figi": "BBG000BVPV84",
  "composite_figi_ticker": "AMZN:US",
  "security_name": "AMAZON.COM INC",
  "market_sector": "Equity",
  "security_type": "Common Stock",
  "stock_exchange": "NASDAQ",
  "last_crsp_adj_date": "1999-09-02",
  "figi_uniqueid": "EQ0021695200001000",
  "share_class_figi": "BBG001S5PQL7",
  "figi_exch_cntry": "UW",
  "currency": "USD",
  "mic": "XNAS",
  "exch_symbol": "^XNAS",
  "etf": false,
  "delisted_security": false,
  "primary_listing": true
}

HOW DOES THE FIGI WORK?

Each type of identifier in the Company and Security master are provided to allow you to define exactly what company or security you are requesting data for.  Here are all of the identifiers that make up the identification hierarchy.

Specific to a company (security issuer):

  • Central Index Key (CIK) - The identifier assigned to SEC registrants and linked to financial filings required to adhere to securities laws as an issuer of securities in the United States.
  • LEI - The Legal Entity Identifier for the company, mapped from the CIK
  • FIGI Security Name - The common security name for a security with a FIGI identifier.

Specific to a security:

  • Share Class FIGI - A common identifier to define a security across all exchanges in the world, so long as it represents a certain class of securities issued by a company.

Specific to a country:

  • Composite FIGI - The unique identifier for a security in a certain country.  This identifier will not change if the ticker symbol changes, but may change if there is a fundamental change in the security due to a corporate action.
  • Composite FIGI Ticker - A ticker symbol form of the Composite FIGI which may not be unique across time. OpenFIGI has provided a link between the MIC stock exchange identifier and their composite codes.

Specific to a stock exchange:

  • Ticker - The ticker symbol as it appeared last on the listed stock exchange.  This identifier may change overtime due to ticker symbol changes and corporate action events.
  • FIGI - The unique identifier for a security on a certain exchange.  This identifier will not change if the ticker symbol changes, but may change if there is a fundamental change in the security due to a corporate action.
  • FIGI Ticker - A ticker symbol form of the FIGI identifier, which may not be unique across time.  OpenFIGI has provided a link between the MIC stock exchange identifier and their exchange codes.

STOCK EXCHANGE MASTER

The following is the API Call for a listing of all stock exchanges covered by Intrinio
https://api.intrinio.com/stock_exchanges

{
  "result_count": 187,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 1,
  "api_call_credits": 1,
  "data": [
    {
      "symbol": "^ARCX",
      "mic": "ARCX",
      "institution_name": "NYSE ARCA",
      "acronym": "NYSE",
      "city": "NEW YORK",
      "country": "UNITED STATES OF AMERICA",
      "country_code": "US",
      "website": "WWW.NYSE.COM"
    },
    {
      "symbol": "^ASEX",
      "mic": "ASEX",
      "institution_name": "ATHENS STOCK EXCHANGE",
      "acronym": "ASE",
      "city": "ATHENS",
      "country": "GREECE",
      "country_code": "GR",
      "website": "HTTP:\/\/WWW.ASE.GR"
    },
    ...
}

To look up a specific stock exchange, you would make this API call:

https://api.intrinio.com/stock_exchanges?query=XFRA

{
  "result_count": 1,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 1,
  "api_call_credits": 1,
  "data": [
    {
      "symbol": "^XFRA",
      "mic": "XFRA",
      "institution_name": "DEUTSCHE BOERSE AG",
      "acronym": "FRA",
      "city": "FRANKFURT",
      "country": "GERMANY",
      "country_code": "DE",
      "website": "HTTP:\/\/WWW.DEUTSCHE-BOERSE.COM"
    }
  ]
}

INDEX MASTER

The index master contains stock market indices, sector and industry indices, and economic indices.  To get each you will use these API Calls:
https://api.intrinio.com/indices?type=stock_market
https://api.intrinio.com/indices?type=sic
https://api.intrinio.com/indices?type=economic

Here is an example of the stock market indices followed by Intrinio:

{
  "result_count": 7,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 1,
  "api_call_credits": 1,
  "data": [
    {
      "symbol": "$COMPQ",
      "index_name": "NASDAQ Composite Index",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    },
    {
      "symbol": "$DJA",
      "index_name": "Dow Jones Composite Average",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    },
    {
      "symbol": "$DJI",
      "index_name": "Dow Jones Industrial Average",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    },
    {
      "symbol": "$NDX",
      "index_name": "NASDAQ 100 Index",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    },
    {
      "symbol": "$SPX",
      "index_name": "S&P 500",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    },
    {
      "symbol": "$TRAN",
      "index_name": "Dow Jones Transportation Average",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    },
    {
      "symbol": "$UTIL",
      "index_name": "Dow Jones Utility Average",
      "continent": "North America",
      "country": "United States of America",
      "index_type": "stock_market"
    }
  ]
}

OWNER MASTER

Below is the API Call and example response for retrieving the Owner master:

https://api.intrinio.com/owners

{
  "result_count": 178687,
  "page_size": 250,
  "current_page": 1,
  "total_pages": 715,
  "api_call_credits": 1,
  "data": [
    {
      "owner_cik": "0000001800",
      "owner_name": "ABBOTT LABORATORIES"
    },
    {
      "owner_cik": "0000001961",
      "owner_name": "WORLDS INC"
    },
    {
      "owner_cik": "0000002110",
      "owner_name": "COLUMBIA ACORN TRUST"
    },
    {
      "owner_cik": "0000002230",
      "owner_name": "ADAMS DIVERSIFIED EQUITY FUND, INC."
    },
    {
      "owner_cik": "0000002488",
      "owner_name": "ADVANCED MICRO DEVICES INC"
    },
    ...
  ]
}

API EXPLORER

You'll find the API Explorer incredibly helpful. Simply select the end point you are interested in, fill in the parameters for what you are looking for and it will create an API call for you. You can copy and paste that syntax directly into the browser or into your codebase.

FILE DOWNLOAD

If you'd like to download a flat CSV file of the data, you'll want to get started with the following tutorial:

File Download Tutorial

Here is an example of how to build download links that will allow you to download the complete list of securities in the security master:

https://api.intrinio.com/securities.csv?exch_symbol=^XFRA&page_number=1,
https://api.intrinio.com/securities.csv?exch_symbol=^XFRA&page_number=2

CSV Downloads are restricted to 10,000 rows, so you must use the page numbers to download everything.  

The top line of the CSV output will contain information pertaining to paging:

RESULT_COUNT: 18794
PAGE_SIZE: 10000
CURRENT_PAGE: 1
TOTAL_PAGES: 2
API_CALL_CREDITS: 1  

You'll find the Download Link Maker incredibly helpful. Simply select the end point, the parameters of your request and it will create a download link for you, similar to the one above. 

HOW MUCH DOES THIS DATA COST?

Intrinio's underlying technology uses algorithms and machine learning to source the build the Global Public Company Security Master and uses non-proprietary identifiers instead of expensive ones like ISIN and CUSIP that require you to pay license fees to them. OpenFIGI is released free of charge for public use.  All of this allows us to make this data available for a very low cost, and it therefore forms the basis of the whole Intrinio API.

Each plan has an upper limit for the number of API Calls you can request each day. If you find that you're hitting the limit, it's very easy to upgrade. 

Should you need more data or a custom solution, we are happy to provide you with a quote. Send our team a message!

Quotes are generally returned within 1 business day and are paid month to month, meaning users can cancel at anytime. A quote and a free trial are always made available before any subscription.

If you have any additional questions about the Global Public Company Security Master Data Feed, feel free to chat with a member of our team and get started with Intrinio!

Did this answer your question?