## Get Instrument Analyst Consensus

**get** `/v1/instruments/{instrument_id}/analyst-reporting`

Retrieves analyst ratings and price targets for an instrument.

### Path Parameters

- `instrument_id: InstrumentIDOrSymbol`

  OEMS instrument UUID

### Query Parameters

- `from: optional string`

  The start date for the query range, inclusive (YYYY-MM-DD)

- `to: optional string`

  The end date for the query range, inclusive (YYYY-MM-DD)

### Returns

- `data: InstrumentAnalystConsensus`

  Aggregated analyst consensus metrics

  - `date: string`

    The date the consensus snapshot was generated

  - `distribution: optional AnalystDistribution`

    Count of individual analyst recommendations by category

    - `buy: number`

      Number of buy recommendations

    - `hold: number`

      Number of hold recommendations

    - `sell: number`

      Number of sell recommendations

    - `strong_buy: number`

      Number of strong buy recommendations

    - `strong_sell: number`

      Number of strong sell recommendations

  - `price_target: optional PriceTarget`

    Aggregated analyst price target statistics

    - `average: string`

      Average analyst price target

    - `currency: string`

      ISO 4217 currency code of the price targets

    - `high: string`

      Highest analyst price target

    - `low: string`

      Lowest analyst price target

  - `rating: optional AnalystRating`

    Consensus analyst rating

    - `"STRONG_BUY"`

    - `"BUY"`

    - `"HOLD"`

    - `"SELL"`

    - `"STRONG_SELL"`

### Example

```http
curl https://api.clearstreet.com/v1/instruments/$INSTRUMENT_ID/analyst-reporting \
    -H "Authorization: Bearer $API_KEY"
```

#### Response

```json
{
  "data": {
    "date": "2025-10-01",
    "distribution": {
      "buy": 20,
      "hold": 3,
      "sell": 1,
      "strong_buy": 18,
      "strong_sell": 0
    },
    "price_target": {
      "average": "240.00",
      "currency": "USD",
      "high": "275.00",
      "low": "190.00"
    },
    "rating": "BUY"
  },
  "error": null,
  "metadata": {
    "request_id": "9e0f1a2b-3c4d-5e6f-7890-1a2b3c4d5e6f"
  }
}
```