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 analyst rating changes and price target updates. Monitor upgrades, downgrades, initiations, and price target adjustments as they happen.

​
Key Features

  • Real-time Ratings: Get instant notifications of analyst rating changes
  • Price Targets: Track current and prior price targets with adjustments
  • Analyst Details: Includes analyst name, firm, and historical accuracy metrics
  • Action Classification: Upgrades, downgrades, maintains, initiates, reiterates
  • Filter by Security: Subscribe to specific tickers or ISINs

​
Use Cases

  • Build real-time rating change alerts and notifications
  • Track analyst firm performance and accuracy
  • Monitor price target consensus shifts
  • Create rating upgrade/downgrade dashboards
  • Automate trading strategies based on analyst actions

​
Quick Start

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

​
Connection URL

wss://api.benzinga.com/api/v2.1/calendar/ratings/stream?token=YOUR_TOKEN

​
Query Parameters

ParameterRequiredDescription
tokenYesYour Benzinga WebSocket API token (bz.production***)
tickersNoComma-separated list of ticker symbols (e.g., AAPL,TSLA)
isinsNoComma-separated list of ISINs to filter

​
Message Example

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "action": "created",
    "id": "66fffdc08f3f630001a2ea51",
    "timestamp": "2024-10-04T19:21:06Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "10:37:52",
      "action_company": "Upgrades",
      "rating_current": "Buy",
      "rating_prior": "Neutral",
      "pt_current": "200.00",
      "pt_prior": "180.00",
      "analyst": "Goldman Sachs",
      "firm_id": "57f832ab6b87f600016fa383",
      "importance": 4
    }
  }
}

​
Rating Actions

ActionDescription
UpgradesRating improved (e.g., Neutral → Buy)
DowngradesRating lowered (e.g., Buy → Hold)
MaintainsRating unchanged
InitiatesFirst rating coverage
ReiteratesConfirms existing rating

​
Message Actions

ActionDescription
created / CreatedNew rating published
updated / UpdatedRating modified
deleted / DeletedRating removed

​
Interactive Commands

CommandDescription
pingKeep connection alive (responds with pong)
replayReplay up to the last 100 cached messages

​
Best Practices

  • Track Changes: Compare rating_current vs rating_prior for upgrade/downgrade detection
  • Price Target Movement: Monitor pt_current vs pt_prior for target changes
  • Analyst Reputation: Consider firm importance and historical accuracy
  • Importance Filter: Focus on high-importance (4-5) ratings for major impact
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst ratings event