Ratings Stream

Real-time analyst ratings and price target changes.

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

Parameter	Required	Description
token	Yes	Your Benzinga WebSocket API token (bz.production***)
tickers	No	Comma-separated list of ticker symbols (e.g., AAPL,TSLA)
isins	No	Comma-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

Action	Description
Upgrades	Rating improved (e.g., Neutral → Buy)
Downgrades	Rating lowered (e.g., Buy → Hold)
Maintains	Rating unchanged
Initiates	First rating coverage
Reiterates	Confirms existing rating

Message Actions

Action	Description
created / Created	New rating published
updated / Updated	Rating modified
deleted / Deleted	Rating removed

Interactive Commands

Command	Description
ping	Keep connection alive (responds with pong)
replay	Replay 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