메인 콘텐츠로 건너뛰기
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.

​
개요

실시간 애널리스트 투자의견 변경과 목표가 업데이트를 구독합니다. 상향·하향 조정, 신규 커버리지 개시, 목표가 변경을 발생하는 즉시 모니터링합니다.

​
주요 기능

  • 실시간 투자의견: 애널리스트 투자의견 변경을 실시간 알림으로 수신
  • 목표가: 현재 및 과거 목표가와 그 변동 내역을 추적
  • 애널리스트 세부 정보: 애널리스트 이름, 소속사, 과거 정확도 지표 포함
  • 조치 유형 분류: 상향 조정, 하향 조정, 유지, 신규 개시, 재확인
  • 종목 기준 필터링: 특정 티커 또는 국제증권식별번호(ISIN)을 기준으로 구독

​
사용 사례

  • 실시간 투자의견 변경 알림 및 알림 시스템 구축
  • 애널리스트 및 소속 기관의 성과와 적중률 추적
  • 목표주가 컨센서스 변동 모니터링
  • 투자의견 상향/하향 조정 대시보드 구축
  • 애널리스트 행동을 기반으로 한 트레이딩 전략 자동화

​
빠른 시작

상단의 인터랙티브 웹소켓 테스트 도구를 사용하여 스트림에 실시간으로 연결해 테스트하세요.

​
접속 URL

wss://api.benzinga.com/api/v2.1/calendar/ratings/stream?token=YOUR_TOKEN

​
쿼리 파라미터

파라미터필수 여부설명
token예Benzinga 웹소켓 API 토큰 (bz.production***)
tickers아니요쉼표로 구분된 티커 목록 (예: AAPL,TSLA)
isins아니요필터링에 사용할 쉼표로 구분된 국제증권식별번호(ISIN) 목록

​
메시지 예시

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "action": "created",
    "id": "66fffdc08f3f630001a2ea51",
    "timestamp": "2024-10-04T19:21:06Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "10:37:52",
      "action_company": "Upgrades",
      "rating_current": "Buy",
      "rating_prior": "Neutral",
      "pt_current": "200.00",
      "pt_prior": "180.00",
      "analyst": "Goldman Sachs",
      "firm_id": "57f832ab6b87f600016fa383",
      "importance": 4
    }
  }
}

​
Rating 액션

Action설명
Upgrades투자의견 상향 (예: Neutral → Buy)
Downgrades투자의견 하향 (예: Buy → Hold)
Maintains투자의견 유지
Initiates최초 투자의견 개시
Reiterates기존 투자의견 재확인

​
메시지 action 값

Action설명
created / Created새 레이팅 게시
updated / Updated레이팅 수정
deleted / Deleted레이팅 삭제

​
대화형 명령어

CommandDescription
ping연결을 유지합니다 (pong으로 응답)
replay캐시에 저장된 최근 메시지를 최대 100개까지 다시 전송합니다

​
모범 사례

  • 변경 사항 추적: 업그레이드/다운그레이드 감지를 위해 rating_current와 rating_prior를 비교합니다
  • 목표가 변동: 목표가 변경을 모니터링하기 위해 pt_current와 pt_prior를 확인합니다
  • 애널리스트 신뢰도: 기관의 중요도와 과거 정확도를 함께 고려합니다
  • 중요도 필터: 큰 영향이 있는 평가에 대해서는 중요도 4–5 등급의 평가에 집중합니다
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst ratings event