메인 콘텐츠로 건너뛰기
WSS
stream

Documentation Index

Fetch the complete documentation index at: https://benzinga-2-locadex-parallel-main.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
개요

증권에 대한 실시간 강세(bull)·약세(bear) 시나리오 분석을 구독할 수 있습니다. 주식의 긍정적(강세) 및 부정적(약세) 시나리오를 균형 있게 파악할 수 있습니다.

​
주요 기능

  • 균형 잡힌 분석: 강세와 약세 케이스를 모두 제공받아 종합적인 시장 인사이트를 확보합니다.
  • 실시간 업데이트: 케이스가 생성, 업데이트 또는 삭제될 때 즉시 알림을 받습니다.
  • 종목별 필터링: 특정 티커 또는 국제증권식별번호(ISIN)를 기준으로 구독합니다.
  • 시장 심리: 낙관적·비관적 관점을 모두 파악합니다.

​
사용 사례

  • 양측의 논거를 모두 보여주는 센티먼트 분석 대시보드 구축
  • 시간 경과에 따른 강세/약세 심리 변화 추적
  • 시장 시각의 유의미한 변화에 대해 사용자에게 알림
  • 고객에게 균형 잡힌 투자 리서치 제공

​
빠른 시작

위의 대화형 웹소켓 테스트 도구를 사용해 실시간 스트림에 연결하고 테스트해 보세요.

​
접속 URL

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

​
Query Parameters

ParameterRequiredDescription
token예Benzinga 웹소켓 API 토큰 (bz.production***)
tickers아니오쉼표로 구분된 티커 목록 (예: AAPL,TSLA)
isins아니오쉼표로 구분된 국제증권식별번호(ISIN) 목록

​
메시지 예제

{
  "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
    }
  }
}

​
메시지 action

Action설명
created / Created새 bull/bear 케이스가 발행됨
updated / Updated기존 케이스가 수정됨
deleted / Deleted케이스가 삭제됨

​
대화형 명령어

CommandDescription
ping연결을 유지합니다 (pong으로 응답합니다)
replay마지막으로 캐시된 메시지 최대 100개를 재생합니다

​
모범 사례

  • 중복 제거: id 필드를 사용해 중복 메시지가 처리되지 않도록 합니다
  • 하트비트(heartbeat): 30~60초마다 ping 명령을 전송합니다
  • 균형 잡힌 제공: 강세(bull)와 약세(bear) 양측 사례를 모두 제시해 공정한 분석을 제공합니다
  • 업데이트 추적: 최근 변경 사항을 식별하기 위해 updated 타임스탬프를 모니터링합니다
Messages
token
type:httpApiKey

Benzinga WebSocket API token (bz.production***)

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Bull/Bear case event