API: Coverage
The New Constructs Coverage dataset 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 datasets.
Our datasets generally use 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.
stock
etf
mf
inactive
sector
industry
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/coverage/stock'
{
"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.
stock
etf
mf
inactive
sector
industry
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/coverage/stock/AAPL'
{
"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"
}
]
}
}