모든 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",
  "index_base": "1982-84=100",
  "released_on": "2026-08-12"
}

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

특정 국가의 특정 월 소비자물가지수 총지수를 조회합니다.

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_cpi

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

특정 월의 전년 동월 대비, 전월 대비 및 연초 이후 누적 인플레이션율을 조회합니다.

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_inflation

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

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

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_unemployment

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

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

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_labour_force_participation

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

한 분기의 국가 GDP를 조회합니다. 항상 당해년가격 기준입니다.

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_gdp

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

한 분기의 공식 실질 GDP 성장률을 조회합니다. 불변가격으로 측정하며 퍼센트로 표시합니다.

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_gdp_growth

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

한 기간의 수출액, 수입액, 정확한 상품 무역수지를 조회합니다. 서비스는 제외됩니다.

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_trade