## Get Instrument Analyst Consensus

`client.V1.InstrumentData.GetInstrumentAnalystConsensus(ctx, instrumentID, query) (*V1InstrumentDataGetInstrumentAnalystConsensusResponse, error)`

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

Retrieves analyst ratings and price targets for an instrument.

### Parameters

- `InstrumentID InstrumentIDOrSymbol`

  OEMS instrument UUID

- `query V1InstrumentDataGetInstrumentAnalystConsensusParams`

  - `From param.Field[Time]`

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

  - `To param.Field[Time]`

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

### Returns

- `type V1InstrumentDataGetInstrumentAnalystConsensusResponse struct{…}`

  - `Data InstrumentAnalystConsensus`

    Aggregated analyst consensus metrics

    - `Date Time`

      The date the consensus snapshot was generated

    - `Distribution AnalystDistribution`

      Count of individual analyst recommendations by category

      - `Buy int64`

        Number of buy recommendations

      - `Hold int64`

        Number of hold recommendations

      - `Sell int64`

        Number of sell recommendations

      - `StrongBuy int64`

        Number of strong buy recommendations

      - `StrongSell int64`

        Number of strong sell recommendations

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

      Consensus analyst rating

      - `const AnalystRatingStrongBuy AnalystRating = "STRONG_BUY"`

      - `const AnalystRatingBuy AnalystRating = "BUY"`

      - `const AnalystRatingHold AnalystRating = "HOLD"`

      - `const AnalystRatingSell AnalystRating = "SELL"`

      - `const AnalystRatingStrongSell AnalystRating = "STRONG_SELL"`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.InstrumentData.GetInstrumentAnalystConsensus(
    context.TODO(),
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    clearstreet.V1InstrumentDataGetInstrumentAnalystConsensusParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", 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"
  }
}
```