> ## Documentation Index > Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt > Use this file to discover all available pages before exploring further. # Bulls/Bears Say Stream > Real-time bull and bear case scenarios for securities. ## Overview Subscribe to real-time bull and bear case analyses for securities. Get balanced perspectives on both positive (bullish) and negative (bearish) scenarios for stocks. ### 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 Use the interactive WebSocket tester above to connect and test the stream in real-time. ### Connection URL ``` wss://api.benzinga.com/api/v1/bulls_bears_say/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,TSLA`) | | `isins` | No | Comma-separated list of ISINs to filter | ## Message Example ```json theme={null} { "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 | Action | Description | | --------------------- | ---------------------------- | | `created` / `Created` | New bull/bear case published | | `updated` / `Updated` | Existing case modified | | `deleted` / `Deleted` | Case 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 * **Balanced Presentation**: Display both bull and bear cases to provide fair analysis * **Update Tracking**: Monitor the `updated` timestamp to identify recent changes ## AsyncAPI ````yaml asyncapi/bulls-bears-say-stream.yml bullsBearsSay id: bullsBearsSay title: Bulls bears say description: Send action commands; receive real-time bull/bear case updates servers: - id: production protocol: wss host: api.benzinga.com/api/v1/bulls_bears_say bindings: [] variables: [] address: stream parameters: [] bindings: [] operations: - &ref_2 id: bullsBearsSay.publish title: Bulls bears say.publish description: Send commands to the server type: receive messages: - &ref_4 id: publish contentType: text/plain payload: - type: string enum: &ref_0 - ping - replay description: Send action commands (ping, replay) x-parser-schema-id: name: publish headers: [] jsonPayloadSchema: type: string enum: *ref_0 description: Action to perform (ping for heartbeat, replay for message history) x-parser-schema-id: title: Publish description: Send action commands (ping, replay) example: '{}' bindings: [] extensions: - id: x-parser-unique-object-id value: publish - id: x-parser-message-name value: ActionRequest bindings: [] extensions: &ref_1 - id: x-parser-unique-object-id value: bullsBearsSay - &ref_3 id: bullsBearsSay.subscribe title: Bulls bears say.subscribe description: Receive real-time bull/bear case data type: send messages: - &ref_5 id: subscribe contentType: application/json payload: - name: subscribe description: Bull/Bear case event type: object properties: - name: id type: string description: Unique UUID for the websocket response required: true - name: api_version type: string description: Websocket API version enumValues: - websocket/v1 required: true - name: kind type: string description: Websocket connection stream type enumValues: - bull_bear_case required: true - name: data type: object required: true properties: - name: action type: string description: Websocket data action enumValues: - created - updated - deleted - Created - Updated - Deleted required: false - name: id type: string description: Data ID for the bull/bear case required: false - name: timestamp type: string description: Timestamp of the data required: false - name: content type: object required: false properties: - name: bear_case type: string description: Description of the bear case scenario required: false - name: bull_case type: string description: Description of the bull case scenario required: false - name: id type: string description: Unique identifier for the bull/bear case required: false - name: ticker type: string description: Stock ticker symbol related to the bull/bear case required: false - name: updated type: integer description: Timestamp of when the case was last updated required: false headers: [] jsonPayloadSchema: type: object required: - id - api_version - kind - data properties: id: type: string format: uuid description: Unique UUID for the websocket response x-parser-schema-id: api_version: type: string enum: - websocket/v1 description: Websocket API version x-parser-schema-id: kind: type: string enum: - bull_bear_case description: Websocket connection stream type x-parser-schema-id: data: type: object required: - action - id - content - timestamp properties: action: type: string enum: - created - updated - deleted - Created - Updated - Deleted description: Websocket data action x-parser-schema-id: id: type: string description: Data ID for the bull/bear case x-parser-schema-id: timestamp: type: string format: date-time description: Timestamp of the data x-parser-schema-id: content: type: object required: - bear_case - bull_case - id - ticker - updated properties: bear_case: type: string description: Description of the bear case scenario x-parser-schema-id: bull_case: type: string description: Description of the bull case scenario x-parser-schema-id: id: type: string format: uuid description: Unique identifier for the bull/bear case x-parser-schema-id: ticker: type: string description: Stock ticker symbol related to the bull/bear case x-parser-schema-id: updated: type: integer format: int64 description: Timestamp of when the case was last updated x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: title: Subscribe description: Bull/Bear case event example: No examples found bindings: [] extensions: - id: x-parser-unique-object-id value: subscribe - id: x-parser-message-name value: BullBearMessage bindings: [] extensions: *ref_1 sendOperations: - *ref_2 receiveOperations: - *ref_3 sendMessages: - *ref_4 receiveMessages: - *ref_5 extensions: - id: x-parser-unique-object-id value: bullsBearsSay securitySchemes: - id: tokenAuth name: token type: httpApiKey description: Benzinga WebSocket API token (bz.production***) in: query extensions: [] ````