Bulls/Bears Stream

Get bull say bear say stream.

WebSocket websocket/v1:

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

Parameters

Name	Location	Type	Required	Description
token	query	string	Yes	Benzinga websocket token (bz.production***).
tickers	query	string	Optional	List of tickers you want to subscribe for. Seperated by comma.
isins	query	string	Optional	List of isins you want to filter by. Seperated by comma.

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”