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

​
개요

실시간 실적 발표를 구독하고 주당순이익(EPS), 매출, 어닝 서프라이즈를 포함한 기업 재무 실적에 대한 업데이트를 즉시 받아보세요.

​
주요 기능

  • 실시간 실적: 실적 발표가 이뤄질 때마다 즉시 알림을 받습니다
  • 포괄적인 데이터: 주당순이익(EPS), 매출, 컨센서스 추정치, 실제 실적, 어닝 서프라이즈 지표를 포함합니다
  • 종목별 필터링: 특정 티커 또는 국제증권식별번호(ISIN)을 기준으로 구독할 수 있습니다
  • 실적 기간: Q1, Q2, Q3, Q4 및 연간(FY) 실적을 추적합니다
  • 중요도 등급: 시장 중요도를 나타내는 0~5점 척도

​
사용 사례

  • 실시간 실적 캘린더 및 알림 구축
  • 어닝 서프라이즈와 실적 상회/하회 패턴 추적
  • 포트폴리오 내 보유 종목 실적을 실시간으로 모니터링
  • 실적 시즌 대시보드 생성
  • 실적 결과를 기반으로 한 거래 전략 자동화

​
빠른 시작

상단의 대화형 웹소켓 테스터를 사용해 실시간으로 스트림에 연결하고 테스트하세요.

​
접속 URL

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

​
쿼리 파라미터

ParameterRequiredDescription
tokenYesBenzinga 웹소켓 API 토큰 (bz.production***)
tickersNo쉼표로 구분된 티커 심볼 목록 (예: AAPL,MSFT)
isinsNo쉼표로 구분된 국제증권식별번호(ISIN) 목록

​
메시지 예시

{
  "id": "839f1f45-fffe-4801-9284-11dae5c5dae4",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/earnings",
  "data": {
    "action": "created",
    "id": "66fffe978f3f630001a2ea56",
    "timestamp": "2024-10-04T14:42:27Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "16:00:00",
      "period": "Q4",
      "period_year": 2024,
      "eps": "1.47",
      "eps_est": "1.39",
      "eps_surprise": "0.08",
      "eps_surprise_percent": "5.76",
      "revenue": "89500000000",
      "revenue_est": "89280000000",
      "importance": 5
    }
  }
}

​
주요 필드

FieldDescription
eps보고된 실제 주당순이익(EPS)
eps_est애널리스트 컨센서스 주당순이익(EPS) 추정치
eps_surprise실제 값과 추정치의 차이(어닝 서프라이즈)
eps_surprise_percent어닝 서프라이즈(추정치 대비 %)
revenue보고된 실제 매출
revenue_est애널리스트 컨센서스 매출 추정치
importance시장 중요도(0-5, 5 = 최고)

​
메시지 action

Action설명
created / Created새로운 실적 발표
updated / Updated실적 데이터가 변경됨
deleted / Deleted발표가 삭제됨

​
대화형 명령

Command설명
ping연결을 유지합니다(pong으로 응답)
replay최근 캐시된 메시지 최대 100개를 재전송합니다

​
모범 사례

  • 중복 제거: 중복 처리를 방지하기 위해 id 필드를 사용하세요
  • 중요도 필터: 시장에 큰 영향을 주는 실적 발표의 경우 중요도 4–5에 집중하세요
  • 서프라이즈 알림: 의미 있는 어닝 서프라이즈를 위한 임계값을 설정하세요
  • 시간: time 필드는 EST/EDT 기준 24시간 형식을 사용한다는 점에 유의하세요
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Earnings event