> ## 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의 웹소켓 API를 사용한 실시간 데이터 스트리밍에 대한 간단한 소개입니다.

Benzinga 웹소켓 API 문서에 오신 것을 환영합니다. 이 가이드는 Benzinga의 실시간 데이터 스트림에 액세스하는 방법을 안내하며, 실시간 시세, 체결, 뉴스 및 기타 핵심 인사이트를 포함한 금융 데이터에 대해 지속적인 업데이트를 구독할 수 있도록 합니다.

<div id="websocket-endpoint">
  ## 웹소켓 엔드포인트
</div>

모든 웹소켓 연결은 다음 엔드포인트를 사용해 수립할 수 있습니다:

```
wss://api.benzinga.com
```

<div id="authentication">
  ## 인증
</div>

Benzinga 웹소켓 API는 Bearer 인증 방식을 사용합니다. 웹소켓 연결을 시작할 때, 다음 형식으로 연결 URL의 쿼리 매개변수에 API 토큰을 포함해야 합니다:
`token` 쿼리 매개변수에 `token: <token>` 형식으로 API 토큰을 넣어야 합니다.

API 토큰을 발급·관리하는 방법에 대한 자세한 내용은 [Authentication](./authentication) 페이지를 참고하세요.

<div id="subscribing-to-streams">
  ## 스트림 구독
</div>

연결이 완료되면 주가 시세, 체결 데이터, 뉴스 업데이트와 같이 요구사항에 따라 특정 데이터 스트림을 구독할 수 있습니다. 각 구독에는 고유한 식별자가 필요하며, 데이터 유형에 따라 필요한 파라미터를 함께 지정해야 합니다.

<div id="example-subscription-message">
  ### 예시 구독 메시지
</div>

실시간 주가 시세 스트림을 구독하려면 다음과 같은 형식의 JSON 메시지를 보내십시오:

```json theme={null}
{
  "action": "subscribe",
  "symbol": "AAPL",
  "type": "quote"
}
```

<div id="heartbeat-mechanism">
  ## 하트비트 메커니즘
</div>

건강한 연결 상태를 유지하고 클라이언트와 서버가 동기화된 상태를 유지하기 위해, Benzinga 웹소켓 API에는 하트비트 메커니즘이 포함되어 있습니다.

<div id="client-side-heartbeat">
  ### 클라이언트 측 하트비트
</div>

* ping 메시지를 일반 텍스트 프레임(예: 문자열 `ping`)으로 전송하면, 서버는 일반 텍스트 프레임으로 pong 메시지(예: 문자열 `pong`)를 응답으로 반환합니다.

* 이를 사용하여 연결이 여전히 활성 상태이며 응답 가능한지 확인할 수 있습니다.

<div id="example">
  #### 예시
</div>

* 클라이언트가 전송: `ping`

* 서버가 응답: `pong`

<div id="server-side-heartbeat">
  ### 서버 측 하트비트
</div>

* 서버는 연결이 유지되고 있는지 확인하기 위해 10초마다 클라이언트로 PING 프레임을 자동 전송합니다.

* 클라이언트는 이 PING 프레임에 응답해야 합니다(대부분의 웹소켓 라이브러리에서 자동으로 처리됩니다).

<div id="handling-heartbeats">
  ### 하트비트 처리
</div>

* 대부분의 웹소켓 클라이언트 라이브러리(예: JavaScript, Python, Go)는 서버에서 수신되는 ping을 자동으로 처리하고 pong으로 응답합니다.

* 하지만 사용자 정의 웹소켓 클라이언트를 구현하는 경우, 연결이 종료되지 않도록 서버의 ping 프레임에 정상적으로 응답하는지 확인해야 합니다.

<div id="rate-limiting">
  ## Rate Limiting
</div>

Benzinga API는 남용 방지와 서비스 안정성 유지를 위해 Rate Limit을 적용합니다. 하나의 API 토큰당 동시에 허용되는 연결은 1개뿐입니다. Rate Limit을 초과하면 오류 응답을 받게 됩니다.

***

이 가이드가 Benzinga API 사용을 시작하는 데 도움이 되기를 바랍니다. 질문이 있으시면 언제든지 지원 팀에 문의해 주세요.