Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Instrument Data

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.

ParametersExpand Collapse

OEMS instrument UUID

formatuuid
query V1InstrumentDataGetInstrumentAnalystConsensusParams
From param.Field[Time]Optional

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

formatdate
To param.Field[Time]Optional

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

formatdate
ReturnsExpand Collapse
type V1InstrumentDataGetInstrumentAnalystConsensusResponse struct{…}

Aggregated analyst consensus metrics

Date Time

The date the consensus snapshot was generated

formatdate
Distribution AnalystDistributionOptional

Count of individual analyst recommendations by category

Buy int64

Number of buy recommendations

formatint64
Hold int64

Number of hold recommendations

formatint64
Sell int64

Number of sell recommendations

formatint64
StrongBuy int64

Number of strong buy recommendations

formatint64
StrongSell int64

Number of strong sell recommendations

formatint64
PriceTarget PriceTargetOptional

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 AnalystRatingOptional

Consensus analyst rating

One of the following:
const AnalystRatingStrongBuy AnalystRating = "STRONG_BUY"
const AnalystRatingBuy AnalystRating = "BUY"
const AnalystRatingHold AnalystRating = "HOLD"
const AnalystRatingSell AnalystRating = "SELL"
const AnalystRatingStrongSell AnalystRating = "STRONG_SELL"

Get Instrument Analyst Consensus

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)
}

{
  "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"
  }
}
{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAP"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}
Returns Examples
{
  "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"
  }
}
{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAP"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}