경제 지표

여러 국가의 경제 지표, 발표, 보고서를 포함한 경제 calendar 데이터를 반환합니다. GDP, 고용 지표, 인플레이션 지표 등과 같은 경제 이벤트에 대해 실제 값, 컨센서스 추정치, 이전 값을 제공합니다.

GET /api/v2.1/calendar/economics

경제 calendar 데이터를 반환합니다

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/economics?token=' \
  --header 'accept: <accept>'

응답 (200 OK)

{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) report tracks the percentage change in layoffs reported by employers during a given month compared to the same month of the previous year. This report is used by investors and analysts to gauge the strength of the labor market and make informed decisions about their investments. The data in this report can also impact the value of the US dollar, with higher than expected numbers being seen as negative and lower than expected numbers being seen as positive.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ]
}

응답 (200 OK)

{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) report tracks the percentage change in layoffs reported by employers during a given month compared to the same month of the previous year. This report is used by investors and analysts to gauge the strength of the labor market and make informed decisions about their investments. The data in this report can also impact the value of the US dollar, with higher than expected numbers being seen as negative and lower than expected numbers being seen as positive.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ]
}

인증

token · string · query · 필수

헤더

accept · enum<string> · 기본값: application/json · 필수

반환 형식을 지정합니다. 두 형식 모두에서 쿼리 매개변수는 동일하게 작동합니다.

사용 가능한 옵션: application/json

쿼리 매개변수

page · integer · 기본값: 0

페이지 오프셋입니다. 최적화, 성능 및 기술적 이유로 페이지 오프셋은 0에서 100000 사이로 제한됩니다. 날짜 등의 다른 파라미터를 사용하여 쿼리 결과를 제한하세요.

pagesize · integer

반환되는 결과 수. 최대 1000개.

필수 범위: x <= 1000

parameters[date] · string<YYYY-MM-DD>

calendar 데이터를 조회할 기준 날짜입니다. date_from과 date_to가 동일할 때 이를 대신해서 사용할 수 있는 단축 형태입니다. 지정하지 않으면 최신 날짜가 기본값입니다.

parameters[date_from] · string<YYYY-MM-DD>

조회 시작 기준이 되는 날짜

parameters[date_to] · string<YYYY-MM-DD>

조회할 시점을 지정하는 날짜

parameters[importance] · enum<integer>

필터링에 사용할 중요도 수준입니다. 지정한 중요도 이상(크거나 같음)인 항목만 포함합니다.

사용 가능한 옵션: 1, 2, 3

parameters[updated] · integer

레코드가 마지막으로 업데이트된 Unix 타임스탬프(UTC)입니다. 이를 사용하면 정렬 순서가 지정된 타임스탬프 이상(Greater Than or Equal)이 되도록 강제됩니다

country · string<A-Z:3>

3자리 국가 코드 (예: USA, CAN, GBR)

event_category · string<csv>

하나 이상의 카테고리(쉼표로 구분)

응답

200

application/json

성공

경제 이벤트 레코드 배열을 포함한 API 응답

economics · object[]

Show child attributes