> ## 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를 사용해 실시간 시장 데이터, 뉴스 등 다양한 정보에 액세스하세요.

<div id="benzinga-apis">
  ## Benzinga APIs
</div>

실적 보고서부터 옵션 거래 동향까지, Benzinga는 시장을 움직이는 정보에 집중합니다. 당사는 귀사가 가장 먼저 거래를 성사시킬 수 있도록 속보에 초점을 맞춘 다양한 채널을 제공합니다. 당사의 뉴스를 수신하는 방법은 Pull 기반 REST API와 Push 기반 TCP, 두 가지 방식이 있으며, 두 방식 모두 시장에 대한 전례 없는 접근성을 제공합니다.

Benzinga의 핵심 원칙 중 하나는 "경쟁사가 아니라 고객에게 집착하라"입니다.

탄탄한 관계는 비즈니스 성공을 이끄는 원동력이자, 이에 대한 당사의 헌신은 언제나 최우선 과제입니다.

Benzinga의 APIs를 사용하려면 [licensing@benzinga.com](mailto:licensing@benzinga.com)으로 직접 이메일을 보내시거나 877-440-9464로 전화해 주십시오. 영업일 기준 1일 이내에 회신드리겠습니다.

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

요청의 쿼리 문자열에서 `token` 파라미터로 API 키/토큰을 전달하세요.

<div id="best-practices">
  ## 모범 사례
</div>

가능한 경우 Benzinga에서 제공하는 클라이언트를 사용할 것을 권장합니다. 많은 엔드포인트는 당사의 [Python 라이브러리](/ko/python-client)에서 사용할 수 있습니다. 공개 [GitHub](https://github.com/benzinga)를 통해 레퍼런스 구현과 클라이언트 라이브러리를 제공합니다.

마지막으로, Calendar, Signals, News API를 사용할 때는, 특히 과거 데이터가 아닌 실시간 수집을 위해 사용하는 경우 델타(증분) 방식을 활용할 것을 강력히 권장합니다. Calendar 및 Signals API에는 `parameters[updated]` 쿼리 파라미터를, News API에는 `updatedSince` 쿼리 파라미터를 사용하십시오. 이러한 파라미터를 사용하면 지연 시간을 최소화할 수 있습니다.

<div id="max-offset">
  ## 최대 오프셋
</div>

News, Calendar, Signals API의 페이지네이션은 한 번에 10,000개를 초과하는 결과 집합을 반환할 수 없습니다. 즉, 페이지 크기가 1,000이라면 10페이지를 요청할 수 없습니다.

이 제한을 피하려면 쿼리 조건을 조정해야 합니다. 예를 들어, 10,000개 미만의 항목만 포함되도록 특정 날짜 범위나 티커 집합으로 결과를 제한할 수 있습니다. 그런 다음 또 다른 날짜 범위나, 마찬가지로 10,000개 미만의 항목을 포함하는 티커 집합을 대상으로 쿼리를 실행해 결과 집합을 합치고, 원하는 전체 결과 집합을 얻을 때까지 이 과정을 반복할 수 있습니다.

<div id="return-format">
  ## 반환 형식
</div>

Benzinga API의 기본 형식은 개별 API 사양에서 지정되지만, 별도로 명시되지 않는 한 `JSON`입니다.

XML 응답이 deprecated 상태가 아닌 API에 대해서는, `accept` 헤더를 `application/json`으로 설정하여 `JSON`을 요청하거나 `application/xml`을 사용하여 `XML`을 요청할 수 있습니다.

**`XML` 출력 형식을 사용하는 신규 연동은 권장하지 않습니다.**

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

```JSON theme={null}
curl -X GET \
'http://api.benzinga.com/api/v2/calendar/ratings?token=YOUR_TOKEN_HERE&ratings=Upgrades' \
-H 'accept: application/json'
```