Consensus Ratings Stream

Real-time aggregated consensus ratings and price targets.

Overview

Subscribe to real-time consensus ratings that aggregate multiple analyst opinions into unified ratings and price targets. Track overall market sentiment and analyst consensus changes.

Key Features

• Aggregated Consensus: Combined view of all analyst ratings for a security
• Price Target Consensus: Average, high, and low price targets
• Rating Distribution: Breakdown by Strong Buy, Buy, Hold, Sell, Strong Sell
• Analyst Count: Track total and unique analyst coverage
• Flexible Aggregation: View as counts or percentages

Use Cases

• Build consensus rating dashboards and widgets
• Track overall analyst sentiment shifts
• Compare individual ratings to consensus
• Monitor price target ranges (high, low, average)
• Identify securities with improving/declining consensus

Quick Start

Use the interactive WebSocket tester above to connect and test the stream in real-time.

Connection URL

wss://api.benzinga.com/api/v1/consensus-ratings/stream?token=YOUR_TOKEN

Query Parameters

Parameter	Required	Description
token	Yes	Your Benzinga WebSocket API token (bz.production***)
tickers	No	Comma-separated list of ticker symbols (e.g., AAPL,MSFT)
isins	No	Comma-separated list of ISINs to filter
simplify	No	Simplify ratings to Buy, Hold, Sell
aggregate_type	No	Aggregation type: number or percentage

Message Example

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "aggregate_ratings": {
      "strong_buy": 15,
      "buy": 25,
      "hold": 8,
      "sell": 2,
      "strong_sell": 0
    },
    "aggregate_type": "number",
    "consensus_rating": "BUY",
    "consensus_rating_val": 4.2,
    "consensus_price_target": 195.50,
    "high_price_target": 225.00,
    "low_price_target": 160.00,
    "total_analyst_count": 50,
    "unique_analyst_count": 48,
    "updated_at": "2024-10-04T19:21:06Z"
  }
}

Consensus Ratings

Rating	Numeric Value	Description
STRONG_BUY	5.0	Very bullish consensus
BUY	4.0 - 4.9	Bullish consensus
HOLD	3.0 - 3.9	Neutral consensus
SELL	2.0 - 2.9	Bearish consensus
STRONG_SELL	1.0 - 1.9	Very bearish consensus

Key Metrics

Field	Description
consensus_rating	Overall rating (BUY, HOLD, SELL)
consensus_rating_val	Numeric rating value (1.0-5.0)
consensus_price_target	Average price target across analysts
high_price_target	Highest price target
low_price_target	Lowest price target
total_analyst_count	Total number of ratings
unique_analyst_count	Number of unique analysts

Interactive Commands

Command	Description
ping	Keep connection alive (responds with pong)
replay	Replay up to the last 100 cached messages

Best Practices

• Consensus Shifts: Monitor changes in consensus_rating_val over time
• Price Target Range: Compare current price to high/low targets for valuation context
• Coverage Depth: Higher analyst counts indicate more reliable consensus
• Distribution Analysis: Examine aggregate_ratings breakdown for sentiment nuance
• Percentage View: Use aggregate_type=percentage for normalized comparisons