메인 콘텐츠로 건너뛰기
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) 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
    }
  ]
}

{
  "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>

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

응답

성공

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

​
economics
object[]