## Get Instrument Analyst Consensus

`v1.instrument_data.get_instrument_analyst_consensus(InstrumentIDOrSymbolinstrument_id, InstrumentDataGetInstrumentAnalystConsensusParams**kwargs)  -> InstrumentDataGetInstrumentAnalystConsensusResponse`

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

Retrieves analyst ratings and price targets for an instrument.

### Parameters

- `instrument_id: InstrumentIDOrSymbol`

  OEMS instrument UUID

- `from_: Optional[Union[null, null]]`

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

- `to: Optional[Union[null, null]]`

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

### Returns

- `class InstrumentDataGetInstrumentAnalystConsensusResponse: …`

  - `data: InstrumentAnalystConsensus`

    Aggregated analyst consensus metrics

    - `date: date`

      The date the consensus snapshot was generated

    - `distribution: Optional[AnalystDistribution]`

      Count of individual analyst recommendations by category

      - `buy: int`

        Number of buy recommendations

      - `hold: int`

        Number of hold recommendations

      - `sell: int`

        Number of sell recommendations

      - `strong_buy: int`

        Number of strong buy recommendations

      - `strong_sell: int`

        Number of strong sell recommendations

    - `price_target: Optional[PriceTarget]`

      Aggregated analyst price target statistics

      - `average: str`

        Average analyst price target

      - `currency: str`

        ISO 4217 currency code of the price targets

      - `high: str`

        Highest analyst price target

      - `low: str`

        Lowest analyst price target

    - `rating: Optional[AnalystRating]`

      Consensus analyst rating

      - `"STRONG_BUY"`

      - `"BUY"`

      - `"HOLD"`

      - `"SELL"`

      - `"STRONG_SELL"`

### Example

```python
from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.instrument_data.get_instrument_analyst_consensus(
    instrument_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(response)
```

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