---
title: "Harmonised inflation API Reference | Narwhal API"
description: "한 국가의 최신 조화 인플레이션(HICP)으로, 퍼센트 단위의 연간 변동률을 조회합니다. Parameters, examples, errors, freshness, and coverage."
url: "https://narwhalapi.com/ko/docs/api/economics/harmonised-inflation"
---

# 조화 인플레이션 API

한 국가의 최신 조화 인플레이션(HICP)으로, 퍼센트 단위의 연간 변동률을 조회합니다.

`economics_get_harmonised_inflation` —REST와 다음 `economics_get_harmonised_inflation` MCP 도구입니다. 둘 다 같은 데이터 형식을 반환하며 같은 크레딧을 사용합니다.

## 엔드포인트 및 요청

REST 엔드포인트

```
GET /v1/economics/{country}/harmonised-inflation
```

요청 예시

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

MCP에서 사용하는 도구: `economics_get_harmonised_inflation` —아래의 해당 인수로 호출하세요.

## 매개변수

이 작업에서 허용되는 기간 형식: `YYYY-MM`.

| 이름 | 필수 | 유형 | 의미 |
| --- | --- | --- | --- |
| `country` | 예 | 경로 · ISO alpha-3 | 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요. |
| `period` | 아니요 | 쿼리 · YYYY-MM | 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요. |
| `series_id` | 아니요 | 쿼리 · UUID | 선택 사항입니다. 기본 시계열인 연간 변동률을 읽으려면 생략하세요. 지수 수준을 읽으려면 지수 수준의 `series_id`를 전달하세요. `GET /v1/economics/{country}/series?family=harmonised-inflation`로 찾을 수 있으며, `unit`이 `index`인 시계열입니다. |

## 응답

응답 예시

```
{
  "source": {
    "publisher": "Eurostat",
    "distributor": "Eurostat"
  },
  "measure": "year_over_year",
  "seasonal_adjustment": "not_seasonally_adjusted",
  "classification": "COICOP 2018, all items (HICP total)",
  "period": "2026-10",
  "value": "3.7",
  "country": "FRA",
  "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
  "unit": "percent"
}
```

| 필드 | 유형 | 필수 | 의미 |
| --- | --- | --- | --- |
| `source` | 객체 | 예 | 수치를 발행한 기관입니다. `publisher`는 해당 수치를 낸 통계 기관이고, `distributor`는 Narwhal이 읽어 오는 기관입니다. 시계열당 전체 이력에 하나의 출처만 있습니다. `released_on`은 없습니다. |
| `measure` | 문자열 | 예 | `year_over_year`는 연간 변동률(퍼센트)이고 `level`은 지수 수준입니다. |
| `seasonal_adjustment` | 문자열 | 예 | Always `not_seasonally_adjusted`. |
| `classification` | 문자열 | 예 | 수치가 포괄하는 물가 집계: 전 품목, COICOP 2018. |
| `base_period` | 문자열 | 아니요 | 지수가 100인 연도입니다. Present for the index level only. |
| `base_value` | 십진수 문자열 | 아니요 | 기준 연도의 지수 값입니다. 지수 수준에만 포함됩니다. |
| `period` | 문자열 | 예 | 반환된 공식 관측 기간입니다. |
| `value` | 십진수 문자열 | 예 | `unit` 단위의 수치: 퍼센트 단위의 연간 변동률(음수일 수 있음) 또는 지수 수준입니다. |
| `status` | 문자열 | 아니요 | 발행 기관이 표시한 수치에만 포함됩니다: `estimated`, `break_in_series`, `definition_differs`, `break_in_series_and_definition_differs`. 그렇지 않으면 생략됩니다. |
| `release_status` | 문자열 | 아니요 | 발행 기관이 수치를 잠정치로 표시한 경우 `preliminary`입니다. 그렇지 않으면 생략됩니다. |
| `country` | 문자열 | 예 | 요청된 대문자 ISO alpha-3 국가 코드입니다. |
| `series_id` | 문자열 | 예 | 수치가 나온 시계열입니다. 같은 시계열을 다시 읽으려면 `series_id`로 전달하세요. |
| `unit` | 문자열 | 예 | 연간 변동률은 `percent`, 지수 수준은 `index`입니다. |

## API 오류 코드와 크레딧

- `400 invalid_query`: A query parameter is unknown or repeated, `country` is not three uppercase letters, `series_id` is not a UUID, or `period` is not a month in `YYYY-MM` format. `version_id`, `version` and `as_of` are not accepted on this route.
- `401 invalid_api_key`: Bearer 키가 누락되었거나 거부되었습니다.
- `402 insufficient_credits`: 잔액이 호출 비용에 부족합니다.
- `404 series_not_found`: 해당 국가가 이 페이지의 지원 국가 목록에 없거나, `series_id`가 그 국가의 시계열이 아니거나, `period`와 일치하는 관측값이 없습니다. 목록에 없는 국가에는 해당 지표군을 이용할 수 없다는 상세 설명이 반환됩니다. 404는 요금이 부과되지 않습니다.
- `429 rate_limit_exceeded`: 네트워크 또는 계정의 단기 구간 한도에 도달했습니다. `Retry-After` 이후에 다시 시도하세요.
- `503 economics_unavailable`: Narwhal이 저장된 시계열을 안전하게 제공할 수 없습니다.

Only a successful data response costs credit. 확인 [모든 오류, 헤더 및 재시도 규칙](https://narwhalapi.com/ko/docs/errors.md).

## 최신성

`period`를 생략하면 저장된 가장 최신 관측값을 반환합니다. 이 API 호출은 Narwhal의 데이터베이스를 읽으며 발행 기관을 실시간으로 호출하지 않습니다. 배포 기관이 표시하는 날짜는 발행 기관의 발표일이 아니므로 응답에 `released_on`이 없습니다.

읽기 [출처 확인, 검증, 발표 데이터 저장 및 확인 실패 시 처리 방식](https://narwhalapi.com/ko/docs/freshness.md).

## 현재 공개 베타 데이터 범위

10 국가

`DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE`

Eurostat의 월별 조화소비자물가지수(HICP)이며 전 품목, 계절 미조정입니다. 각국의 `inflation` 경로와는 다르며, 같은 국가라도 두 수치는 다릅니다. 기본 시계열은 전년 대비 변동률(퍼센트)이며 음수일 수 있습니다. 지수 수준의 기준은 `2025=100`입니다. 기간은 `YYYY-MM` 형식의 월입니다. 다른 국가는 `404 series_not_found`를 반환하며 요금이 부과되지 않습니다. 지수 수준을 읽으려면 먼저 해당 국가의 시계열을 나열하세요. `GET /v1/economics/{country}/series?family=harmonised-inflation`는 각 시계열을 `series_id`, `name`, `unit`(`percent` 또는 `index`), `is_default`와 함께 반환하며, `limit`과 `cursor`를 사용한 요청으로 페이지를 넘기며 조회할 수 있습니다. `unit`이 `index`인 `series_id`를 최신 경로 또는 이력 경로에 전달하세요.

### List the개 시리즈

요청 예시

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/series?family=harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

응답 예시

```
{
  "series": [
    {
      "country": "FRA",
      "series_id": "11bc022a-cd6e-4847-8ff8-11dae4e93451",
      "unit": "index",
      "name": "Harmonised index of consumer prices",
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "base_period": "2025",
        "base_value": "100",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "measure": "level",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    },
    {
      "country": "FRA",
      "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
      "unit": "percent",
      "name": "Harmonised inflation, annual rate",
      "is_default": true,
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "measure": "year_over_year",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "annualization": "not_annualized",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    }
  ],
  "next_cursor": null
}
```

일일 환율을 제공하는 API: [환율 API](https://narwhalapi.com/ko/api/fx.md).

다음으로 돌아가기 [모든 경제 데이터 작업](https://narwhalapi.com/ko/docs/api/economics.md).

## 무료 키로 시작하세요

매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.

[무료 API 키 받기](https://narwhalapi.com/ko/signup)

이 페이지가 도움이 되었나요?
