메인 콘텐츠로 건너뛰기
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/v1/news/stream?token=YOUR_TOKEN

​
쿼리 파라미터

ParameterRequiredDescription
tokenYesBenzinga 웹소켓 API 토큰 (bz.production***)
tickersNo쉼표(,)로 구분된 티커 심볼 목록 (예: AAPL,MSFT)
channelsNo쉼표(,)로 구분된 필터링용 뉴스 채널 목록

​
메시지 예제

{
  "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)를 사용하는 재연결 로직을 구현합니다
  • 필터링: 대역폭 사용량을 줄이기 위해 티커/채널 필터를 사용합니다
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

News Update
type:object

A news article or update message