## Get Instrument Analyst Consensus

`$ clear-street v1:instrument-data get-instrument-analyst-consensus`

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

Retrieves analyst ratings and price targets for an instrument.

### Parameters

- `--instrument-id: string`

  OEMS instrument UUID

- `--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

- `V1InstrumentDataGetInstrumentAnalystConsensusResponse: BaseResponse`

  - `data: object { date, distribution, price_target, rating }`

    Aggregated analyst consensus metrics

    - `date: string`

      The date the consensus snapshot was generated

    - `distribution: optional object { buy, hold, sell, 2 more }`

      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 object { average, currency, high, low }`

      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 "STRONG_BUY" or "BUY" or "HOLD" or 2 more`

      Consensus analyst rating

      - `"STRONG_BUY"`

      - `"BUY"`

      - `"HOLD"`

      - `"SELL"`

      - `"STRONG_SELL"`

### Example

```cli
clear-street v1:instrument-data get-instrument-analyst-consensus \
  --api-key 'My API Key' \
  --instrument-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e
```

#### 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"
  }
}
```