---
title: "Analyst ratings US equities"
method: GET
path: "/analyst_ratings/us_equities"
tags: ["analysis"]
---

# Analyst ratings US equities

`GET /analyst_ratings/us_equities`

The analyst ratings US equities endpoint provides detailed information on analyst ratings for U.S. stocks. It returns data on the latest ratings issued by various analyst firms, including the rating itself, the firm issuing the rating, and any changes in the rating. This endpoint is useful for users tracking analyst opinions on U.S. equities, allowing them to see how professional analysts view the potential performance of specific stocks.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `exchange` string
- `mic_code` string
- `rating_change` 'Maintains' | 'Upgrade' | 'Downgrade' | 'Initiates' | 'Reiterates'
- `outputsize` integer

## Response `200`

- object
  - `meta` object, required — Meta information about the instrument
    - `symbol` string, required — Symbol ticker of the instrument
    - `name` string, required — Name of the instrument
    - `currency` string, required — Currency in which the instrument is traded
    - `exchange_timezone` string, required — Timezone of the exchange
    - `exchange` string, required — Exchange where the instrument is traded
    - `mic_code` string, required — Market identifier code (MIC) under ISO 10383 standard
    - `type` string, required — Type of the instrument
  - `ratings` object[] — List of analyst ratings
    - `date` string, required — Date when the rating was released
    - `firm` string, required — Firm that issued the ranking
    - `analyst_name` string — Name of an analyst
    - `rating_change` string — Defines the action of the firm to ranking, could be `Maintains`, `Upgrade`, `Downgrade`, `Initiates`, `Reiterates`, `Assumes`, or `Reinstates`
    - `rating_current` string — Current firm's ranking of the instrument
    - `rating_prior` string — Prior firm's ranking of the instrument
    - `time` string — Time when the rating was released or updated
    - `action_price_target` string — Action that firm took towards target price
    - `price_target_current` number, double — Current firm's price target for the instrument
    - `price_target_prior` number, double — Prior firm's price target for the instrument
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)