API: Coverage

The New Constructs Coverage API provides access to lists of the securities in our coverage universe by type - stocks, ETFs, mutual funds, and inactive stocks. This information can be used to identify the securities available in other APIs.


The API generally uses ticker as an identifier. Companies with multiple classes of common stock return the same information for all classes. The primary ticker appears in results that include a ticker. For example, GOOG and GOOGL are alternate classes of stock for Alphabet, Inc. Requesting data for GOOG or GOOGL returns the same results. Since the primary ticker is GOOG, it will appear in ratings request results and other endpoints that return a ticker.


Tickers that include a colon are currently inactive stocks. They are no longer traded because they were acquired, went bankrupt, etc. We assign the last used ticker to the security followed by a colon and a number that increments for each new company that becomes inactive with that ticker. For example, XYZ Corp uses ticker XYZ and goes inactive. We assign the company the ticker XYZ:1 because it is the first company in our system to go inactive using ticker XYZ. If a different company, XYZ Technology, starts using ticker XYZ and goes inactive, it will be assigned XYZ:2.

API: Securities by Type

Returns a list of all covered securities of the requested type.

Endpoint
URL
Method
/coverage/:security_type
GET
URL Parameters
Name
Description
Example
:security_type
Desired security type. Options:
stock
etf
mf
inactive
sector
industry
stock
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
ticker
Ticker of the listed security.
AAPL
name
Name of the security.
Apple Inc.
type
The security type requested in the API call.
stock
sector
Ticker of the sector the listed security belongs to.
TECHNOLOGYSEC
last_trade_date
The last date the security traded.
2018-12-07
Sample Call:
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/coverage/stock'
Success Response:

{
  "statusCode": 200,
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "results": [
      {
        "ticker": "AAPL",
        "name": "Apple Inc.",
        "type": "stock",
        "sector": "TECHNOLOGYSEC",
        "last_trade_date": "2018-12-07"
      },
      ...
    ]
  }
}
  

API: Single Security

Returns more information about a single security.

Endpoint
URL
Method
/coverage/:security_type/:ticker
GET
URL Parameters
Name
Description
Example
:security_type
Desired security type. Options:
stock
etf
mf
inactive
sector
industry
stock
:ticker
Ticker of the security.
AAPL
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
ticker
Ticker of the listed security.
AAPL
name
Name of the security.
Apple Inc.
type
The security type requested in the API call.
stock
sector
Ticker of the sector the listed security belongs to.
TECHNOLOGYSEC
sector_name
Name of the sector the listed security belongs to.
Technology Sector
subsector
Ticker of the subsector the listed security belongs to.
NA
subsector_name
Name of the subsector the listed security belongs to.
Technology Equipment Subsector
industry
Ticker of the industry the listed security belongs to.
COMPUTERSPHONESHOUSEHOLDELECTROI
industry_name
Name of the industry the listed security belongs to.
Computers, Phones & Household Electronics Industry
subindustry
Ticker of the subindustry the listed security belongs to.
NA
subindustry_name
Name of the subindustry the listed security belongs to.
Phones & Handheld Devices
last_trade_date
The last date the security traded.
2018-12-07
Sample Call:
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/coverage/stock/AAPL'
Success Response:

{
  "statusCode": 200,
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "results": [
      {
        "ticker": "AAPL",
        "name": "Apple Inc.",
        "type": "stock",
        "sector": "TECHNOLOGYSEC",
        "sector_name": "Technology Sector",
        "subsector": "NA",
        "subsector_name": "Technology Equipment Subsector",
        "industry": "COMPUTERSPHONESHOUSEHOLDELECTROI",
        "industry_name": "Computers, Phones & Household Electronics Industry",
        "subindustry": "NA",
        "subindustry_name": "Phones & Handheld Devices",
        "last_trade_date": "2018-12-07"
      }
    ]
  }
}

  

API: Coverage Errors

Error
Message
Error Code
InvalidSecurityType
Invalid security type. Available options: stock, etf, mf, inactive, sector, and industry.
400