Skip to main content
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": "216000",
      "actual_t": "216K",
      "confirmed": true,
      "consensus": "170000",
      "consensus_t": "170K",
      "country": "United States",
      "date": "2024-01-09T00:00:00.000Z",
      "description": "The change in the number of employed people",
      "event_category": "Employment",
      "event_name": "Nonfarm Payrolls",
      "event_period": "December",
      "id": "60a7f5e8e4b0f5a3c8e9f5af",
      "importance": 5,
      "notes": "Nonfarm payrolls beat expectations",
      "period_year": 2023,
      "prior": "199000",
      "prior_t": "199K",
      "time": "08:30:00",
      "updated": 1704819600
    }
  ]
}

Authorizations

​
token
string
query
required

Headers

​
accept
enum<string>
default:application/json
required

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

Available options:
application/json

Query Parameters

​
page
integer
default:0

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

​
pagesize
integer

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

Required range: 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>

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

Available options:
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>

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

Response

성공

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

​
economics
object[]