모든 API

경제 데이터 API

공식 통계 기관의 CPI, 인플레이션, 노동, GDP 및 무역 데이터를 위한 하나의 출처입니다.

국가와 월 하나의 헤드라인 소비자물가지수를 조회합니다.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시 예시 응답 · 라이브 요청 아님
{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

엔드포인트

GET소비자물가지수/v1/economics/{country}/cpi

국가와 월 하나의 헤드라인 소비자물가지수를 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_cpi

GET인플레이션/v1/economics/{country}/inflation

월 하나의 전년 동기 대비, 전월 대비 및 연초 이후 인플레이션을 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_inflation

GET실업률/v1/economics/{country}/unemployment

관측 기간 하나의 공식 실업률을 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_unemployment

GET경제활동 참가율/v1/economics/{country}/labour-force-participation

관측 기간 하나의 공식 경제활동 참가율을 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_labour_force_participation

GET국내총생산/v1/economics/{country}/gdp

분기 하나의 현재 가격 국가 GDP를 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_gdp

GETGDP 성장률/v1/economics/{country}/gdp-growth

분기 하나의 공식 실질 GDP 성장률 측정값을 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_gdp_growth

GET상품 무역/v1/economics/{country}/trade

기간 하나의 수출, 수입 및 정확한 상품 무역 수지를 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_trade

GET상품 수출/v1/economics/{country}/trade/exports

국가와 기간 하나의 상품 수출 합계를 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.
partner
계약상 승인되었지만 현재 베타에서는 파트너별 필터 합계를 게시하지 않습니다.
product
HS 상품 코드입니다. 분류 정보와 함께 제공하십시오.
classification
통일상품분류체계 판입니다. product와 함께 제공하세요.

MCP · economics_get_trade_exports

GET상품 수입/v1/economics/{country}/trade/imports

국가와 기간 하나의 상품 수입 합계를 조회합니다.

country
지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period
최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.
partner
계약상 승인되었지만 현재 베타에서는 파트너별 필터 합계를 게시하지 않습니다.
product
HS 상품 코드입니다. 분류 정보와 함께 제공하십시오.
classification
통일상품분류체계 판입니다. product와 함께 제공하세요.

MCP · economics_get_trade_imports

출처 및 방법론

1차 출처

모든 라이브 스트림은 공식 국가 제공 기관에서 제공됩니다.

방법론 읽기

명시된 기간

각 응답에는 관측 기간과 공식 발표일이 포함됩니다.

REST 및 MCP

REST와 MCP는 18개 작업, 스키마 및 할당량을 공유합니다.

10개국의 공식 국가 발행기관이 제공하는 최신 및 과거 경제 데이터를 살펴보세요.

자주 묻는 질문

어떤 국가를 지원하나요?

호주, 캐나다, 독일, 프랑스, 영국, 일본, 말레이시아, 네덜란드, 싱가포르 및 미국.

API에 과거 경제 데이터가 포함되나요?

예. 9개 최신 발표 작업 각각에는 현재 승인된 과거 시계열에 대응하는 관측 경로가 있습니다.

경제 데이터는 어디에서 오나요?

모든 라이브 스트림은 데이터 범위 매트릭스에 명시된 정부 통계청 또는 다른 공식 국가 제공 기관에서 제공됩니다.

새 발표를 얼마나 빨리 이용할 수 있나요?

Narwhal은 발표가 검증을 통과한 후 게시합니다. 공개 베타는 출처에서 발표까지의 고정 지연 시간을 약속하지 않습니다.

첫 요청 보내기

무료 API 키 받기