Bulls/Bears Say Stream

​

Overview

​

Key Features

• Balanced Analysis: Receive both bull and bear cases for comprehensive market insight
• Real-time Updates: Get instant notifications when cases are created, updated, or removed
• Filter by Security: Subscribe to specific tickers or ISINs
• Market Sentiment: Understand both optimistic and pessimistic viewpoints

​

Use Cases

• Build sentiment analysis dashboards showing both sides of the argument
• Track changes in bull/bear sentiment over time
• Alert users to significant shifts in market perspective
• Provide balanced investment research to clients

​

Quick Start

​

Connection URL

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

​

Query Parameters

​

Message Example

{
  "id": "websocket123",
  "api_version": "websocket/v1",
  "kind": "bull_bear_case",
  "data": {
    "action": "created",
    "id": "case123",
    "timestamp": "2024-10-01T10:00:00Z",
    "content": {
      "bull_case": "Strong earnings growth and market expansion expected.",
      "bear_case": "Increased competition and regulatory pressures.",
      "ticker": "AAPL",
      "updated": 1696153200
    }
  }
}

​

Message Actions

​

Interactive Commands

​

Best Practices

• Deduplication: Use the id field to prevent processing duplicate messages
• Heartbeat: Send ping commands every 30-60 seconds
• Balanced Presentation: Display both bull and bear cases to provide fair analysis
• Update Tracking: Monitor the updated timestamp to identify recent changes