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

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.

ParametersExpand Collapse
instrument_id: InstrumentIDOrSymbol

OEMS instrument UUID

formatuuid
from_: Optional[Union[null, null]]

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

formatdate
to: Optional[Union[null, null]]

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

formatdate
ReturnsExpand Collapse
class InstrumentDataGetInstrumentAnalystConsensusResponse: …

Aggregated analyst consensus metrics

date: date

The date the consensus snapshot was generated

formatdate
distribution: Optional[AnalystDistribution]

Count of individual analyst recommendations by category

buy: int

Number of buy recommendations

formatint64
hold: int

Number of hold recommendations

formatint64
sell: int

Number of sell recommendations

formatint64
strong_buy: int

Number of strong buy recommendations

formatint64
strong_sell: int

Number of strong sell recommendations

formatint64
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

One of the following:
"STRONG_BUY"
"BUY"
"HOLD"
"SELL"
"STRONG_SELL"

Get Instrument Analyst Consensus

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