> ## 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.
# 뉴스 스트림
> Benzinga의 실시간 뉴스 기사와 업데이트.
## 개요
실시간 뉴스 업데이트를 구독하여 새 기사가 게시되거나 기존 기사가 수정될 때 즉시 알림을 받을 수 있습니다.
### 주요 기능
* **실시간 업데이트**: 뉴스 기사가 게시되거나 업데이트될 때 즉시 알림을 받습니다
* **종목 필터링**: 특정 티커 또는 국제증권식별번호(ISIN)를 구독하여 관련 뉴스만 수신합니다
* **풍부한 데이터**: 기사 본문, 작성자 정보, 이미지 및 연관된 종목 정보를 포함합니다
* **동작 추적**: 기사가 생성, 업데이트 또는 제거되는 시점을 모니터링합니다
### 사용 사례
* 특정 종목에 대한 실시간 뉴스 피드 구축
* 포트폴리오 보유 종목의 속보 알림 생성
* 여러 티커에 대한 뉴스 통합
* 매매 신호를 위한 뉴스 심리(센티먼트)와 뉴스량 추적
## 빠른 시작
위의 대화형 웹소켓 테스터를 사용해 연결한 뒤 스트림을 실시간으로 테스트하세요.
### 접속 URL
```
wss://api.benzinga.com/api/v1/news/stream?token=YOUR_TOKEN
```
### 쿼리 파라미터
| Parameter | Required | Description |
| ---------- | -------- | ----------------------------------------- |
| `token` | Yes | Benzinga 웹소켓 API 토큰 (bz.production\*\*\*) |
| `tickers` | No | 쉼표(,)로 구분된 티커 심볼 목록 (예: `AAPL,MSFT`) |
| `channels` | No | 쉼표(,)로 구분된 필터링용 뉴스 채널 목록 |
## 메시지 예제
```json theme={null}
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"api_version": "websocket/v1",
"kind": "news",
"data": {
"action": "created",
"id": 36444586,
"timestamp": "2024-01-01T13:35:14Z",
"content": {
"id": 36444586,
"author": "Benzinga Insights",
"created": "Mon, 01 Jan 2024 13:35:14 -0400",
"updated": "Mon, 01 Jan 2024 13:35:15 -0400",
"title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
"teaser": "",
"body": "Full article content...",
"url": "https://www.benzinga.com/markets/options/24/01/36444586/...",
"image": [
{
"size": "thumb",
"url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/..."
}
],
"channels": [
{
"name": "Options"
}
],
"stocks": [
{
"name": "AAPL",
"cusip": "037833100",
"isin": "US0378331005",
"exchange": "NASDAQ"
}
],
"tags": [
{
"name": "BZI-AUOA"
}
]
}
}
}
```
### 메시지 동작
| Action | 설명 |
| --------------------- | -------- |
| `created` / `Created` | 새 기사 게시 |
| `updated` / `Updated` | 기존 기사 수정 |
| `deleted` / `Deleted` | 기사 삭제 |
## 대화형 명령
| Command | 설명 |
| -------- | --------------------------- |
| `ping` | 연결을 유지합니다 (`pong`으로 응답) |
| `replay` | 캐시된 최근 최대 100개의 메시지를 재전송합니다 |
## 모범 사례
* **중복 제거**: `id` 필드를 사용해 중복 메시지 처리를 방지합니다
* **하트비트**: 연결 유지를 위해 30\~60초마다 `ping` 명령을 전송합니다
* **오류 처리**: 지수 백오프(exponential backoff)를 사용하는 재연결 로직을 구현합니다
* **필터링**: 대역폭 사용량을 줄이기 위해 티커/채널 필터를 사용합니다
## AsyncAPI
````yaml asyncapi/news-stream.yml news
id: news
title: News
description: Send action commands; receive real-time news updates
servers:
- id: production
protocol: wss
host: api.benzinga.com/api/v1/news
bindings: []
variables: []
address: stream
parameters: []
bindings: []
operations:
- &ref_2
id: news.publish
title: News.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: news
- &ref_3
id: news.subscribe
title: News.subscribe
description: Receive real-time news updates
type: send
messages:
- &ref_5
id: subscribe
contentType: application/json
payload:
- name: News Update
description: A news article or update message
type: object
properties:
- name: id
type: string
description: Unique message identifier
required: false
- name: api_version
type: string
description: API version
required: false
- name: kind
type: string
description: Message type
required: false
- name: data
type: object
required: false
properties:
- name: action
type: string
description: Action type
enumValues:
- created
- updated
- deleted
required: false
- name: id
type: integer
description: News article ID
required: false
- name: timestamp
type: string
description: Message timestamp
required: false
- name: content
type: object
required: false
properties:
- name: id
type: integer
description: Article ID
required: false
- name: author
type: string
description: Article author
required: false
- name: created
type: string
description: Article creation timestamp
required: false
- name: updated
type: string
description: Article update timestamp
required: false
- name: title
type: string
description: Article headline
required: false
- name: teaser
type: string
description: Article teaser text
required: false
- name: body
type: string
description: Full article body
required: false
- name: url
type: string
description: Article URL
required: false
- name: image
type: array
required: false
properties:
- name: size
type: string
required: false
- name: url
type: string
required: false
- name: channels
type: array
required: false
properties:
- name: name
type: string
required: false
- name: stocks
type: array
required: false
properties:
- name: name
type: string
required: false
- name: cusip
type: string
required: false
- name: isin
type: string
required: false
- name: exchange
type: string
required: false
- name: tags
type: array
required: false
properties:
- name: name
type: string
required: false
headers: []
jsonPayloadSchema:
type: object
properties:
id:
type: string
description: Unique message identifier
x-parser-schema-id:
api_version:
type: string
description: API version
example: websocket/v1
x-parser-schema-id:
kind:
type: string
description: Message type
example: news
x-parser-schema-id:
data:
type: object
properties:
action:
type: string
description: Action type
enum:
- created
- updated
- deleted
x-parser-schema-id:
id:
type: integer
description: News article ID
x-parser-schema-id:
timestamp:
type: string
format: date-time
description: Message timestamp
x-parser-schema-id:
content:
type: object
properties:
id:
type: integer
description: Article ID
x-parser-schema-id:
author:
type: string
description: Article author
x-parser-schema-id:
created:
type: string
description: Article creation timestamp
x-parser-schema-id:
updated:
type: string
description: Article update timestamp
x-parser-schema-id:
title:
type: string
description: Article headline
x-parser-schema-id:
teaser:
type: string
description: Article teaser text
x-parser-schema-id:
body:
type: string
description: Full article body
x-parser-schema-id:
url:
type: string
description: Article URL
x-parser-schema-id:
image:
type: array
items:
type: object
properties:
size:
type: string
x-parser-schema-id:
url:
type: string
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
channels:
type: array
items:
type: object
properties:
name:
type: string
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
stocks:
type: array
items:
type: object
properties:
name:
type: string
x-parser-schema-id:
cusip:
type: string
x-parser-schema-id:
isin:
type: string
x-parser-schema-id:
exchange:
type: string
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
tags:
type: array
items:
type: object
properties:
name:
type: string
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
x-parser-schema-id:
title: News Update
description: A news article or update message
example: No examples found
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe
bindings: []
extensions: *ref_1
sendOperations:
- *ref_2
receiveOperations:
- *ref_3
sendMessages:
- *ref_4
receiveMessages:
- *ref_5
extensions:
- id: x-parser-unique-object-id
value: news
securitySchemes:
- id: tokenAuth
name: token
type: httpApiKey
description: Benzinga WebSocket API token (bz.production***)
in: query
extensions: []
````