Analyst Insights Stream

​

Overview

​

Key Features

• Real-time Updates: Get instant notifications when analysts publish new insights or update existing ratings
• Filter by Security: Subscribe to specific tickers or ISINs to receive only relevant data
• Comprehensive Data: Includes analyst firm details, ratings, price targets, and detailed insights
• Action Tracking: Monitor when insights are created, updated, or removed

​

Use Cases

• Track analyst sentiment changes for portfolio securities
• Build real-time alerts for rating upgrades or downgrades
• Monitor price target changes across multiple analysts
• Aggregate consensus insights from multiple analyst firms

​

Quick Start

​

Connection URL

wss://api.benzinga.com/api/v1/analyst/insights/stream?token=YOUR_TOKEN

​

Query Parameters

​

Message Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "api_version": "websocket/v1",
  "kind": "stream_type",
  "data": {
    "action": "created",
    "id": "insight-id",
    "timestamp": "2024-10-08T10:00:00Z",
    "content": {
      "action": "Upgrades",
      "analyst_insights": "The analyst has upgraded the stock...",
      "firm": "Goldman Sachs",
      "pt": "150.00",
      "rating": "Buy",
      "security": {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "exchange": "NASDAQ"
      }
    }
  }
}

​

Message Actions

​

Interactive Commands

​

Best Practices

• Deduplication: Use the id field to prevent processing duplicate messages
• Heartbeat: Send ping commands every 30-60 seconds to maintain connection
• Error Handling: Implement reconnection logic with exponential backoff
• Filtering: Use ticker/ISIN filters to reduce bandwidth