API
Embed our data directly into your workflow.
Installation
No special installation is required to use the New Constructs API.
Authentication
Access to the New Constructs API requires an API key.
Access Plans
Access to our API is included with all New Constructs Memberships, including individual investor and professional plans. Please contact support for more information.
Gold, Platinum, and Pro access includes:
- Full access to our Reference Datasets, Coverage and Datapoints
- Access to our Overall Rating, Component Ratings, Reported Fundamentals, and Adjusted Fundamentals endpoints for any securities in your portfolio*
- 10,000 API requests per month. Accessing data for 1 datapoint, for 1 security, for 1 time period = 1 request. Requests reset on the first of the month.
*Because our API only refreshes once per day, tickers added to your portfolio will not be available for API requests until the next day.
Unlimited and Institutional access includes:
- Full access to our Reference Datasets, Coverage and Datapoints
- Full access to our Overall Rating, Component Ratings, Reported Fundamentals, Adjusted Fundamentals, and Sector endpoints
- 10,000 API requests per month. Accessing data for 1 datapoint, for 1 security, for 1 time period = 1 request. Requests reset on the first of the month.
For Unlimited and Institutional members, securities do not need to be in your portfolio to access their data.
Code Samples
Code samples are provided in the documentation for each endpoint, or you can check out some examples at our sample code GitHub repo.
Data Refresh
New Constructs data is refreshed daily between 5AM CT and 5:20AM CT. During the refresh window, the API may not be available to respond to requests.
Companies with Multiple Classes of Common Stock
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 for Inactive Stocks
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.
Next Steps
Once you have your API key, review the documentation for any endpoint for instructions and examples on connecting with the API.
