Economics API 레퍼런스

10개 국가의 최근 발표 및 과거 관측값입니다.

9개 경로는 최근 승인된 공식 발표를 반환합니다. 이에 대응하는 9개 /observations 경로는 현재 승인 시계열을 반환합니다. REST와 MCP는 동일한 스키마와 월간 할당량을 사용합니다.

기본 URL 및 매개변수

REST 기본 경로

https://api.narwhalapi.com/v1/economics/{country}

알려진 기간 하나 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, 및 USA.

모든 국가는 동일한 최신 작업 9개와 과거 작업 9개를 지원합니다.

정확한 매개변수, 허용되는 기간 형식, 응답 필드, 예시, 오류, 최신성 및 현재 제한을 확인하려면 작업 페이지를 여세요.

작업	REST 경로	기간
소비자물가지수	`/v1/economics/{country}/cpi`	`YYYY-MM`
인플레이션	`/v1/economics/{country}/inflation`	`YYYY-MM`
실업률	`/v1/economics/{country}/unemployment`	`YYYY, YYYY-MM, or YYYY-QN`
경제활동 참가율	`/v1/economics/{country}/labour-force-participation`	`YYYY, YYYY-MM, or YYYY-QN`
국내총생산	`/v1/economics/{country}/gdp`	`YYYY-QN`
GDP 성장률	`/v1/economics/{country}/gdp-growth`	`YYYY-QN`
상품 무역	`/v1/economics/{country}/trade`	`YYYY or YYYY-MM`
상품 수출	`/v1/economics/{country}/trade/exports`	`YYYY or YYYY-MM`
상품 수입	`/v1/economics/{country}/trade/imports`	`YYYY or YYYY-MM`

과거 데이터 경로는 다음을 허용합니다 start, end, limit, 및 cursor 결과는 오래된 항목부터 정렬되며, 과거의 모든 발행 빈티지가 아니라 현재 승인된 시계열을 설명합니다.

작업	REST 경로	기간
소비자물가지수 과거 데이터	`/v1/economics/{country}/cpi/observations`	`YYYY-MM`
인플레이션 과거 데이터	`/v1/economics/{country}/inflation/observations`	`YYYY-MM`
실업률 과거 데이터	`/v1/economics/{country}/unemployment/observations`	`YYYY, YYYY-MM, or YYYY-QN`
경제활동 참가율 과거 데이터	`/v1/economics/{country}/labour-force-participation/observations`	`YYYY, YYYY-MM, or YYYY-QN`
국내총생산 과거 데이터	`/v1/economics/{country}/gdp/observations`	`YYYY-QN`
GDP 성장률 과거 데이터	`/v1/economics/{country}/gdp-growth/observations`	`YYYY-QN`
상품 무역 과거 데이터	`/v1/economics/{country}/trade/observations`	`YYYY-MM`
상품 수출 과거 데이터	`/v1/economics/{country}/trade/exports/observations`	`YYYY-MM`
상품 수입 과거 데이터	`/v1/economics/{country}/trade/imports/observations`	`YYYY-MM`

필드 또는 규칙	의미
`country`	요청된 ISO alpha-3 국가 코드입니다.
`period`	응답이 나타내는 정확한 공식 월, 분기 또는 연도입니다.
`released_on`	Narwhal 조회 시각이 아닌 공식 발표일입니다.
십진 문자열	정확한 십진 표현을 보존하기 위해 숫자형 경제 값은 문자열로 반환됩니다.
단위 및 기준	해당되는 경우 환율, 통화, 가격 기준, 연율화, 데이터 범위 및 지수 기준을 명시적으로 유지합니다.
누락된 발표	Narwhal은 누락값을 만들어내거나 이월하거나 0으로 변환하는 대신 폐쇄적으로 실패 처리합니다.

공개 검색은 위의 18개 경로와 10개 국가로 제한됩니다. 인도네시아와 지역별 경로는 공개 Economics 베타에 포함되지 않습니다.

확인 오류 및 할당량 누락 시계열 및 서비스 이용 불가 동작에 대해.