Skip to main content
WSS
stream

Documentation Index

Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

ParameterRequiredDescription
tokenYesYour Benzinga WebSocket API token (bz.production***)
tickersNoComma-separated list of ticker symbols (e.g., AAPL,MSFT)
isinsNoComma-separated list of ISINs to filter
simplifyNoSimplify ratings to Buy, Hold, Sell
aggregate_typeNoAggregation 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

RatingNumeric ValueDescription
STRONG_BUY5.0Very bullish consensus
BUY4.0 - 4.9Bullish consensus
HOLD3.0 - 3.9Neutral consensus
SELL2.0 - 2.9Bearish consensus
STRONG_SELL1.0 - 1.9Very bearish consensus

​
Key Metrics

FieldDescription
consensus_ratingOverall rating (BUY, HOLD, SELL)
consensus_rating_valNumeric rating value (1.0-5.0)
consensus_price_targetAverage price target across analysts
high_price_targetHighest price target
low_price_targetLowest price target
total_analyst_countTotal number of ratings
unique_analyst_countNumber of unique analysts

​
Interactive Commands

CommandDescription
pingKeep connection alive (responds with pong)
replayReplay 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
Messages
token
type:httpApiKey

Benzinga WebSocket API token (bz.production***)

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Consensus ratings event