> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/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
```
### 쿼리 파라미터
| Parameter | Required | Description |
| --------- | -------- | ----------------------------------------- |
| `token` | Yes | Benzinga 웹소켓 API 토큰 (bz.production\*\*\*) |
| `tickers` | No | 쉼표로 구분된 티커 심볼 목록 (예: `AAPL,MSFT`) |
| `isins` | No | 쉼표로 구분된 국제증권식별번호(ISIN) 목록 |
## 메시지 예시
```json theme={null}
{
"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
}
}
}
```
### 주요 필드
| Field | Description |
| ---------------------- | ------------------------- |
| `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시간 형식을 사용한다는 점에 유의하세요
## AsyncAPI
````yaml asyncapi/calendar-earnings-stream.yml calendarEarnings
id: calendarEarnings
title: Calendar earnings
description: Send action commands; receive real-time earnings updates
servers:
- id: production
protocol: wss
host: api.benzinga.com/api/v2.1/calendar/earnings
bindings: []
variables: []
address: stream
parameters: []
bindings: []
operations:
- &ref_2
id: calendarEarnings.publish
title: Calendar earnings.publish
description: Send commands to the server
type: receive
messages:
- &ref_4
id: publish
contentType: text/plain
payload:
- type: string
enum: &ref_0
- ping
- replay
description: Send action commands (ping, replay)
x-parser-schema-id:
name: publish
headers: []
jsonPayloadSchema:
type: string
enum: *ref_0
description: Action to perform (ping for heartbeat, replay for message history)
x-parser-schema-id:
title: Publish
description: Send action commands (ping, replay)
example: '{}'
bindings: []
extensions:
- id: x-parser-unique-object-id
value: publish
- id: x-parser-message-name
value: ActionRequest
bindings: []
extensions: &ref_1
- id: x-parser-unique-object-id
value: calendarEarnings
- &ref_3
id: calendarEarnings.subscribe
title: Calendar earnings.subscribe
description: Receive real-time earnings data
type: send
messages:
- &ref_5
id: subscribe
contentType: application/json
payload:
- name: subscribe
description: Earnings event
type: object
properties:
- name: id
type: string
description: Unique UUID for the websocket response
required: true
- name: api_version
type: string
description: Websocket API version
enumValues:
- websocket/v1
required: true
- name: kind
type: string
description: Websocket connection stream type
enumValues:
- data/v2.1/calendar/earnings
required: true
- name: data
type: object
required: true
properties:
- name: action
type: string
description: Websocket data action
enumValues:
- created
- updated
- deleted
- Created
- Updated
- Deleted
required: true
- name: id
type: string
description: Data ID for the earnings
required: true
- name: timestamp
type: string
description: Timestamp of the data
required: true
- name: content
type: object
required: true
properties:
- name: id
type: string
description: Unique identifier for the earnings
required: true
- name: date
type: string
description: Announced Date on Calendar
required: true
- name: date_confirmed
type: integer
description: If the report date was confirmed (1/0)
required: false
- name: time
type: string
description: Announced Time on Calendar (24hr format)
required: false
- name: ticker
type: string
description: Ticker Symbol (F, MSFT, etc...)
required: true
- name: exchange
type: string
description: Exchange (NYSE, NASDAQ, etc...)
required: true
- name: isin
type: string
description: International Securities Identification Number
required: false
- name: cusip
type: string
description: CUSIP identifier
required: false
- name: name
type: string
description: Name of the security
required: true
- name: currency
type: string
description: Currency the data is denominated in
required: false
- name: period
type: string
description: Period of the earnings actual
enumValues:
- Q1
- Q2
- Q3
- Q4
- FY
- H1
- H2
required: false
- name: period_year
type: integer
description: Period Year of the earnings actual
required: false
- name: eps_type
type: string
description: EPS Type
enumValues:
- Adj
- GAAP
- FFO
required: false
- name: eps
type: string
description: Comparable and Adjusted Earnings Per Share
required: false
- name: eps_est
type: string
description: Adjusted EPS Consensus Aggregate Analyst Estimate
required: false
- name: eps_prior
type: string
description: Adjusted EPS from Prior Period
required: false
- name: eps_surprise
type: string
description: EPS deviation from estimate
required: false
- name: eps_surprise_percent
type: string
description: Deviation from estimate as a percentage
required: false
- name: revenue_type
type: string
description: Revenue Type
enumValues:
- Adj
- GAAP
- FFO
required: false
- name: revenue
type: string
description: Revenue
required: false
- name: revenue_est
type: string
description: Revenue estimate
required: false
- name: revenue_prior
type: string
description: Revenue value for previous period
required: false
- name: revenue_surprise
type: string
description: Revenue deviation from estimate
required: false
- name: revenue_surprise_percent
type: string
description: Deviation from estimate as a percentage
required: false
- name: importance
type: integer
description: Importance of the event to the market (0-5)
required: false
- name: notes
type: string
description: Additional notes provided by the Benzinga Newsdesk
required: false
- name: updated
type: integer
description: Last updated timestamp (UTC)
required: false
headers: []
jsonPayloadSchema:
type: object
required:
- id
- api_version
- kind
- data
properties:
id:
type: string
format: uuid
description: Unique UUID for the websocket response
x-parser-schema-id:
api_version:
type: string
enum:
- websocket/v1
description: Websocket API version
x-parser-schema-id:
kind:
type: string
enum:
- data/v2.1/calendar/earnings
description: Websocket connection stream type
x-parser-schema-id:
data:
type: object
required:
- action
- id
- content
- timestamp
properties:
action:
type: string
enum:
- created
- updated
- deleted
- Created
- Updated
- Deleted
description: Websocket data action
x-parser-schema-id:
id:
type: string
description: Data ID for the earnings
x-parser-schema-id:
timestamp:
type: string
format: date-time
description: Timestamp of the data
x-parser-schema-id:
content:
type: object
required:
- id
- date
- ticker
- exchange
- name
properties:
id:
type: string
description: Unique identifier for the earnings
x-parser-schema-id:
date:
type: string
format: date
description: Announced Date on Calendar
x-parser-schema-id:
date_confirmed:
type: integer
description: If the report date was confirmed (1/0)
x-parser-schema-id:
time:
type: string
description: Announced Time on Calendar (24hr format)
x-parser-schema-id:
ticker:
type: string
description: Ticker Symbol (F, MSFT, etc...)
x-parser-schema-id:
exchange:
type: string
description: Exchange (NYSE, NASDAQ, etc...)
x-parser-schema-id:
isin:
type: string
description: International Securities Identification Number
x-parser-schema-id:
cusip:
type: string
description: CUSIP identifier
x-parser-schema-id:
name:
type: string
description: Name of the security
x-parser-schema-id:
currency:
type: string
description: Currency the data is denominated in
x-parser-schema-id:
period:
type: string
enum:
- Q1
- Q2
- Q3
- Q4
- FY
- H1
- H2
description: Period of the earnings actual
x-parser-schema-id:
period_year:
type: integer
description: Period Year of the earnings actual
x-parser-schema-id:
eps_type:
type: string
enum:
- Adj
- GAAP
- FFO
description: EPS Type
x-parser-schema-id:
eps:
type: string
description: Comparable and Adjusted Earnings Per Share
x-parser-schema-id:
eps_est:
type: string
description: Adjusted EPS Consensus Aggregate Analyst Estimate
x-parser-schema-id:
eps_prior:
type: string
description: Adjusted EPS from Prior Period
x-parser-schema-id:
eps_surprise:
type: string
description: EPS deviation from estimate
x-parser-schema-id:
eps_surprise_percent:
type: string
description: Deviation from estimate as a percentage
x-parser-schema-id:
revenue_type:
type: string
enum:
- Adj
- GAAP
- FFO
description: Revenue Type
x-parser-schema-id:
revenue:
type: string
description: Revenue
x-parser-schema-id:
revenue_est:
type: string
description: Revenue estimate
x-parser-schema-id:
revenue_prior:
type: string
description: Revenue value for previous period
x-parser-schema-id:
revenue_surprise:
type: string
description: Revenue deviation from estimate
x-parser-schema-id:
revenue_surprise_percent:
type: string
description: Deviation from estimate as a percentage
x-parser-schema-id:
importance:
type: integer
minimum: 0
maximum: 5
description: Importance of the event to the market (0-5)
x-parser-schema-id:
notes:
type: string
description: Additional notes provided by the Benzinga Newsdesk
x-parser-schema-id:
updated:
type: integer
format: int64
description: Last updated timestamp (UTC)
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
title: Subscribe
description: Earnings event
example: No examples found
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe
- id: x-parser-message-name
value: EarningsMessage
bindings: []
extensions: *ref_1
sendOperations:
- *ref_2
receiveOperations:
- *ref_3
sendMessages:
- *ref_4
receiveMessages:
- *ref_5
extensions:
- id: x-parser-unique-object-id
value: calendarEarnings
securitySchemes:
- id: tokenAuth
name: token
type: httpApiKey
description: Benzinga WebSocket API token (bz.production***)
in: query
extensions: []
````