Ratings Stream

​

Overview

​

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

​

Connection URL

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

​

Query Parameters

​

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

​

Message Actions

​

Interactive Commands

​

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