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.

ParametersExpand Collapse

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

ReturnsExpand Collapse

V1InstrumentDataGetInstrumentAnalystConsensusResponse: BaseResponse { metadata, error }

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"

Get Instrument Analyst Consensus

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

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