Documentation Index
Fetch the complete documentation index at: https://benzinga-2-locadex-main-1770976803646.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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
| Parameter | Required | Description |
|---|
token | Yes | Your Benzinga WebSocket API token (bz.production***) |
tickers | No | Comma-separated list of ticker symbols (e.g., AAPL,MSFT) |
isins | No | Comma-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
| Action | Description |
|---|
created / Created | New analyst insight published |
updated / Updated | Existing insight modified |
deleted / Deleted | Insight removed |
Interactive Commands
| Command | Description |
|---|
ping | Keep connection alive (responds with pong) |
replay | Replay 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