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-v2.intrinio.com/companies

Which returns:

{
    "companies": [
        {
            "id": "com_NX6GzO",
            "ticker": "AAPL",
            "name": "Apple Inc",
            "lei": "HWUPKR0MPOU8FGXBT394",
            "cik": "0000320193"
        },
        {
            "id": "com_2zvNzA",
            "ticker": "XOM",
            "name": "Exxon Mobil Corp",
            "lei": "J3WHBG0MTS7O8ZVMDC91",
            "cik": "0000034088"
        },
        {
            "id": "com_0XLDXx",
            "ticker": "ORCL",
            "name": "Oracle Corp",
            "lei": "1Z4GXXU7ZHVWFCD8TV52",
            "cik": "0001341439"
        },
        ...
    ],
    "next_page": "MTAz"
}

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 by ticker, you would make this API call:

https://api-v2.intrinio.com/companies/AAPL

Which returns:

{
    "id": "com_NX6GzO",
    "ticker": "AAPL",
    "name": "Apple Inc",
    "lei": "HWUPKR0MPOU8FGXBT394",
    "legal_name": "APPLE INC",
    "stock_exchange": "NasdaqGS",
    "sic": 3571,
    "short_description": "Apple, Inc. engages in the design, manufacture, and marketing of mobile communication, media devices, personal computers, and portable digital music players. It operates through the following geographical segments: Americas, Europe, Greater China, Japan, and Rest of Asia Pacific. The Americas segment includes both North and South America. The Europe segment consists of European countries, as well as India, the Middle East, and Africa. The Greater China segment comprises of China, Hong Kong, and Taiwan. The Rest of Asia Pacific segment includes Australia and Asian countries not included in the reportable operating segments of the company. The company was founded by Steven Paul Jobs, Ronald Gerald Wayne, and Stephen G. Wozniak on April 1, 1976 and is headquartered in Cupertino, CA.",
    "long_description": "Apple Inc. designs, manufactures, and markets mobile communication and media devices, personal computers, and portable digital music players to consumers, small and mid-sized businesses, and education, enterprise, and government customers worldwide. The company also sells related software, services, accessories, networking solutions, and third-party digital content and applications. It offers iPhone, a line of smartphones; iPad, a line of multi-purpose tablets; and Mac, a line of desktop and portable personal computers. The company also provides iLife, a consumer-oriented digital lifestyle software application suite; iWork, an integrated productivity suite that helps users create, present, and publish documents, presentations, and spreadsheets; and other application software, such as Final Cut Pro, Logic Pro X, and FileMaker Pro. In addition, it offers Apple TV that connects to consumers' TV and enables them to access digital content directly for streaming high definition video, playing music and games, and viewing photos; Apple Watch, a personal electronic device; and iPod, a line of portable digital music and media players. Further, the company sells Apple-branded and third-party Mac-compatible, and iOS-compatible accessories, such as headphones, displays, storage devices, Beats products, and other connectivity and computing products and supplies. Additionally, it offers iCloud, a cloud service; AppleCare that offers support options for its customers; and Apple Pay, a mobile payment service. The company sells and delivers digital content and applications through the iTunes Store, App Store, Mac App Store, TV App Store, iBooks Store, and Apple Music. It also sells its products through its retail and online stores, and direct sales force, as well as through third-party cellular network carriers, wholesalers, retailers, and value-added resellers. Apple Inc. was founded in 1977 and is headquartered in Cupertino, California.",
    "ceo": "Tim Cook",
    "company_url": "www.apple.com",
    "business_address": "ONE APPLE PARK WAY, CUPERTINO, CA 95014",
    "mailing_address": "ONE APPLE PARK WAY, CUPERTINO, CA 95014",
    "business_phone_no": "(408) 996-1010",
    "hq_address1": "1 Infinite Loop",
    "hq_address2": null,
    "hq_address_city": "Cupertino",
    "hq_address_postal_code": "95014",
    "entity_legal_form": "INCORPORATED",
    "cik": "0000320193",
    "latest_filing_date": "2019-05-01",
    "hq_state": "California",
    "hq_country": "United States of America",
    "inc_state": "California",
    "inc_country": "United States of America",
    "employees": 132000,
    "entity_status": "ACTIVE",
    "sector": "Consumer Goods",
    "industry_category": "Consumer Durables",
    "industry_group": "Electronic Equipment",
    "template": "indu",
    "standardized_active": true,
    "first_fundamental_date": "2007-09-29",
    "last_fundamental_date": "2019-03-30",
    "first_stock_price_date": "1980-12-12",
    "last_stock_price_date": "2019-05-15"
}

SECURITY MASTER

The following is the API Call for  a listing of all securities listed on the Deutsche Boerse (MIC: XFRA)

https://api-v2.intrinio.com/stock_exchanges/XFRA/securities

Which returns:

{
    "securities": [
        {
            "id": "sec_gYkGZz",
            "company_id": null,
            "stock_exchange_id": "sxg_NgPvzd",
            "name": "Tokyu Corporation",
            "code": "EQS",
            "currency": "EUR",
            "ticker": "01T",
            "composite_ticker": "01T:GR",
            "figi": "BBG000GF0WM3",
            "composite_figi": "BBG000GF0VV5",
            "share_class_figi": "BBG001S6BNJ0"
        },
        {
            "id": "sec_gPNLVz",
            "company_id": null,
            "stock_exchange_id": "sxg_NgPvzd",
            "name": "Keller",
            "code": "EQS",
            "currency": "EUR",
            "ticker": "01K",
            "composite_ticker": "01K:GR",
            "figi": "BBG000QJVGY2",
            "composite_figi": "BBG000QJVGG2",
            "share_class_figi": "BBG001S7WWP8"
        },
        ...
    ],
    "stock_exchange": {
        "id": "sxg_NgPvzd",
        "name": "DEUTSCHE BOERSE AG",
        "mic": "XFRA",
        "acronym": "FRA",
        "country": "GERMANY"
    },
    "next_page": "MzIxODM="
}


To query to find a securities matching the given text, you would make this API call:

https://api-v2.intrinio.com/securities/search?query=amazon

Which returns:

{
    "securities": [
        {
            "id": "sec_gPx34n",
            "company_id": "com_mgwYzQ",
            "stock_exchange_id": "sxg_AXGAyM",
            "name": "Amazon.com Inc.",
            "code": "EQS",
            "currency": "USD",
            "ticker": "0R1O",
            "composite_ticker": "0R1O:LN",
            "figi": "BBG00JPR0JG2",
            "composite_figi": "BBG00JPR0JF3",
            "share_class_figi": "BBG001S5PQL7"
        },
        {
            "id": "sec_g2dEZz",
            "company_id": "com_mgwYzQ",
            "stock_exchange_id": "sxg_DzonXe",
            "name": "Amazon.com Inc.",
            "code": "EQS",
            "currency": "CHF",
            "ticker": "AMZN",
            "composite_ticker": "AMZN:SW",
            "figi": "BBG006TKZD03",
            "composite_figi": "BBG006TKZCY8",
            "share_class_figi": "BBG001S5PQL7"
        },
        ...
  ],
  "next_page": null
}


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

https://api-v2.intrinio.com/securities/AMZN:US

Which returns:

{
    "id": "sec_ogDm2X",
    "company_id": "com_mgwYzQ",
    "stock_exchange_id": "sxg_ozMr9y",
    "name": "Amazon.com Inc.",
    "type": "Ordinary Shares",
    "code": "EQS",
    "share_class": "AMZN",
    "currency": "USD",
    "round_lot_size": 100,
    "ticker": "AMZN",
    "exchange_ticker": "AMZN:UW",
    "composite_ticker": "AMZN:US",
    "alternate_tickers": [],
    "figi": "BBG000BVQ4Z3",
    "cik": "0001018724",
    "composite_figi": "BBG000BVPV84",
    "share_class_figi": "BBG001S5PQL7",
    "figi_uniqueid": "EQ0021695200001000",
    "primary_security": true,
    "primary_listing": true,
    "etf": false,
    "delisted": false,
    "first_stock_price": "1997-05-16",
    "last_stock_price": "2019-05-15",
    "last_stock_price_adjustment": "1999-09-02",
    "last_corporate_action": "2019-04-12",
    "previous_tickers": [],
    "listing_exchange_mic": "XNAS"
}

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-v2.intrinio.com/stock_exchanges

Which returns:

{
    "stock_exchanges": [
        {
            "id": "sxg_xgxM8X",
            "name": "AB NASDAQ VILNIUS",
            "mic": "XLIT",
            "acronym": "LIT",
            "city": "VILNIUS",
            "country": "LITHUANIA",
            "country_code": "LT",
            "website": "WWW.NASDAQBALTIC.COM",
            "first_stock_price_date": "2004-05-14",
            "last_stock_price_date": "2019-05-16"
        },
        {
            "id": "sxg_2z9OBg",
            "name": "ABU DHABI SECURITIES EXCHANGE",
            "mic": "XADS",
            "acronym": "ADSM",
            "city": "ABU DHABI",
            "country": "UNITED ARAB EMIRATES",
            "country_code": "AE",
            "website": "WWW.ADX.AE",
            "first_stock_price_date": "2002-01-02",
            "last_stock_price_date": "2019-05-16"
        },
        ...
     ]
}

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-v2.intrinio.com/indices/economic
https://api-v2.intrinio.com/indices/sic
https://api-v2.intrinio.com/indices/stock_market

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

{
    "indices": [
        {
            "id": "ind_NX6GzO",
            "symbol": "$SPX",
            "name": "S&P 500",
            "continent": "North America",
            "country": "United States of America",
            "update_frequency": "daily",
            "last_updated": "2019-05-16T00:10:25.000Z",
            "observation_start": "2009-05-18",
            "observation_end": "2019-05-15"
        },
        {
            "id": "ind_2zvNzA",
            "symbol": "$DJI",
            "name": "Dow Jones Industrial Average",
            "continent": "North America",
            "country": "United States of America",
            "update_frequency": "daily",
            "last_updated": "2019-05-16T00:11:33.000Z",
            "observation_start": "2009-05-18",
            "observation_end": "2019-05-15"
        },
        ...
    ],
    "next_page": "Mg=="
}

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.

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?