Skip to main content
WSS
wss://api.benzinga.com/api/v1/analyst/insights
stream
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst insight event

Overview

Subscribe to real-time analyst insights and receive updates on analyst ratings, price targets, and detailed recommendations as they happen.

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

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

Connection URL

wss://api.benzinga.com/api/v1/analyst/insights/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

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

ActionDescription
created / CreatedNew analyst insight published
updated / UpdatedExisting insight modified
deleted / DeletedInsight removed

Interactive Commands

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

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