Bulls/Bears Stream

Get bull say bear say stream.

WebSocket websocket/v1:

wss://api.benzinga.com/api/v1/analyst/insights/stream

Parameters

Name	In	Required	Type	Description
token	query	string	Yes	Benzinga websocket token (bz.production***).
symbols	query	true	string	Stock ticker symbol to query for bull/bear cases.

Stream Response:

When you subscribe to the stream, you’ll receive updates about analyst insights in the following format:

{
  "id": "websocket123",
  "api_version": "websocket/v1",
  "kind": "bull_bear_case",
  "data": {
    "action": "created",
    "id": "case123",
    "content": {
      "bear_case": "Market downturn expected.",
      "bull_case": "Positive earnings forecast.",
      "id": "case123",
      "ticker": "AAPL",
      "updated": 1696153200
    },
    "timestamp": "2024-10-01T10:00:00Z"
  }
}

Responses

• 200 OK
  • Description: Success
  • Content Type: application/json
  • Schema: BullBearWSResp

BullBearWSResp

Parameter	Type	Description
id	string	Unique UUID for the WebSocket response
api_version	string	WebSocket API version
kind	string	WebSocket connection stream type
data	object	Contains the action and details of the bull/bear case

Data Object (inside BullBearWSResp)

Parameter	Type	Description
action	string	WebSocket data action (e.g., created, updated, deleted)
id	string	Data ID for the bull/bear case
content	object	The bull/bear case details (see below)
timestamp	string	Timestamp of the data

BullBearCase Schema (inside data content)

Parameter	Type	Description
bear_case	string	Description of the bear case scenario
bull_case	string	Description of the bull case scenario
id	string	Unique identifier for the bull/bear case (UUID format)
ticker	string	Stock ticker symbol related to the bull/bear case
updated	integer	Timestamp of when the case was last updated (int64 format)

Success Response

• Success 101 - Websocket connection established successfully.

✅ Connected to wss://api.benzinga.com/api/v1/bulls_bears_say/stream?token=bz.p***

Handshake Details

Request URL:

”https://api.benzinga.com/api/v1/bulls_bears_say/stream?token=bz”

Request Method: “GET”

Status Code: “101 Switching Protocols”

Error Response

• Unauthorized 401 - Invalid token, check the token provided.

❗ Could not connect to wss://api.benzinga.com/api/v1/bulls_bears_say/stream?token=bz.p***

Error: Unexpected server response: 401

Handshake Details

Request Method: “GET”

Status Code: “401 Unauthorized”

• Bad Gateway 502 - Either invalid route or server error.

❗ Could not connect to wss://api.benzinga.com/api/v1/bulls_bears_say/stream?token=bz.p***

Error: Unexpected server response: 502

Handshake Details

Request Method: “GET”

Status Code: “502 Bad Gateway”