메인 콘텐츠로 건너뛰기
GET
/
api
/
v2.1
/
calendar
/
economics
경제 calendar 데이터를 반환합니다
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/economics?token=' \
  --header 'accept: <accept>'
{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) 보고서는 특정 월에 고용주가 보고한 정리해고 건수가 전년 동월 대비 몇 퍼센트 변화했는지를 추적합니다. 이 보고서는 투자자와 애널리스트가 노동 시장의 상황을 평가하고 합리적인 투자 의사결정을 내리는 데 활용됩니다. 또한 이 보고서의 데이터는 미 달러화 가치에도 영향을 줄 수 있으며, 예상보다 높은 수치는 부정적으로, 예상보다 낮은 수치는 긍정적으로 인식되는 경향이 있습니다.",
      "event_category": "고용",
      "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
    }
  ]
}

{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) 보고서는 특정 월에 고용주가 보고한 정리해고 건수가 전년 동월 대비 몇 퍼센트 변화했는지를 추적합니다. 이 보고서는 투자자와 애널리스트가 노동 시장의 상황을 평가하고 합리적인 투자 의사결정을 내리는 데 활용됩니다. 또한 이 보고서의 데이터는 미 달러화 가치에도 영향을 줄 수 있으며, 예상보다 높은 수치는 부정적으로, 예상보다 낮은 수치는 긍정적으로 인식되는 경향이 있습니다.",
      "event_category": "고용",
      "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>

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

응답

성공

​
economics
object[]