API: Overall Rating

The New Constructs Overall Rating API provides immediate access to our ratings on 2850+ stocks, 700+ ETFs, and 7050+ mutual funds. Ratings are updated daily.


For more information about our rating methodology, see the Education section of our website:

API: Overall Risk/Reward Rating

Endpoint
URL
Method
/ratings/overall/:ticker
GET
URL Parameters
Name
Description
Example
:ticker
Ticker of the stock, ETF, or mutual fund. You can use the coverage endpoint to get full lists of options.
A
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
rating_overall
Overall numeric rating of the listed security.
3
ticker
Ticker of the listed security.
A
name
Name of the security.
Agilent Technologies, Inc.
Sample Call:
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/ratings/overall/A'
Success Response:

{
  "statusCode": 200
  "headers": {"Content-Type": "application/json},
  "body": {
    "results": {
      "rating_overall": 3,
      "ticker": "A",
      "name": "Agilent Technologies, Inc."
    }
  }
}
  

API: Rating Definitions

Key
Definition
1
Very Attractive - our best rating
2
Attractive
3
Neutral
4
Unattractive
5
Very Unattractive - our worst rating

API: Data Definitions

Key
Definition
rating_overall
Rating: Overall Risk/Reward Rating (see Rating Definitions above; our best rating is 1 and our worst rating is 5)

API: Ratings Errors

Error
Message
Error Code
RatingNotFound
The requested rating information was not found.
404