조화 인플레이션 과거 데이터 API
한 국가의 월별 조화 인플레이션(HICP) 이력을 오래된 순으로 조회합니다.
economics_ —REST와 다음 economics_ MCP 도구입니다. 둘 다 같은 데이터 형식을 반환하며 같은 크레딧을 사용합니다.
엔드포인트 및 요청
GET /v1/economics/{country}/harmonised-inflation/observationscurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation/observations?start=2026-01&limit=2" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP에서 사용하는 도구: economics_ —아래의 해당 인수로 호출하세요.
매개변수
이 작업에서 허용되는 기간 형식: YYYY-MM.
| 이름 | 필수 | 유형 | 의미 |
|---|---|---|---|
country | 예 | 경로 · ISO alpha-3 | 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요. |
start | 아니요 | 쿼리 · YYYY-MM | 조회 범위의 첫 관측 기간이며, 해당 기간도 포함합니다. |
end | 아니요 | 쿼리 · YYYY-MM | 조회 범위의 마지막 관측 기간이며, 해당 기간도 포함합니다. |
limit | 아니요 | 쿼리 · 정수, 1~1000 | 반환할 최대 기간 수입니다. 기본값은 100입니다. 한 페이지에 더 적은 기간이 포함될 수 있으므로 next_cursor를 따라가세요. |
cursor | 아니요 | 쿼리 · 불투명 문자열 | 이전 페이지의 next_cursor입니다. |
series_ | 아니요 | 쿼리 · 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)",
"country": "FRA",
"series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
"unit": "percent",
"observations": [
{
"period": "2026-01",
"value": "0.4"
},
{
"period": "2026-02",
"value": "1.1"
}
],
"next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}이력 예제는 limit=2를 요청하므로 두 행이 있습니다. 여기서는 next_를 줄여 표시했습니다. 실제 값은 더 긴 불투명 문자열입니다.
| 필드 | 유형 | 필수 | 의미 |
|---|---|---|---|
source | 객체 | 예 | 수치를 발행한 기관입니다. publisher는 해당 수치를 낸 통계 기관이고, distributor는 Narwhal이 읽어 오는 기관입니다. 시계열당 전체 이력에 하나의 출처만 있습니다. released_은 없습니다. |
measure | 문자열 | 예 | year_는 연간 변동률(퍼센트)이고 level은 지수 수준입니다. |
seasonal_ | 문자열 | 예 | Always not_. |
classification | 문자열 | 예 | 수치가 포괄하는 물가 집계: 전 품목, COICOP 2018. |
base_ | 문자열 | 아니요 | 지수가 100인 연도입니다. Present for the index level only. |
base_ | 십진수 문자열 | 아니요 | 기준 연도의 지수 값입니다. 지수 수준에만 포함됩니다. |
country | 문자열 | 예 | 요청된 대문자 ISO alpha-3 국가 코드입니다. |
series_ | 문자열 | 예 | 수치가 나온 시계열입니다. 같은 시계열을 다시 읽으려면 series_로 전달하세요. |
unit | 문자열 | 예 | 연간 변동률은 percent, 지수 수준은 index입니다. |
observations | 배열 | 예 | 기간당 하나씩 오래된 순서의 관측값입니다. 한 페이지에 limit보다 적은 관측값이 있을 수 있습니다. next_가 null이 될 때까지 따라가세요. |
observations[].period | 문자열 | 예 | 관측값이 나타내는 공식 월, 분기 또는 연도입니다. |
observations[].value | 십진수 문자열 | 예 | unit 단위의 수치: 퍼센트 단위의 연간 변동률(음수일 수 있음) 또는 지수 수준입니다. |
observations[].status | 문자열 | 아니요 | 발행 기관이 표시한 수치에만 포함됩니다: estimated, break_, definition_, break_. 그렇지 않으면 생략됩니다. |
observations[].release_ | 문자열 | 아니요 | 발행 기관이 수치를 잠정치로 표시한 경우 preliminary입니다. 그렇지 않으면 생략됩니다. |
next_ | 문자열 또는 null | 예 | 다음 페이지를 읽으려면 이 값을 변경하지 말고 cursor로 전달하세요. 마지막 페이지에서는 null입니다. |
API 오류 코드와 크레딧
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID,id startorendis not a month inYYYY-MMformat,startandenddiffer in format orstartis afterend, orlimitis outside 1 to 1000.version_,id versionandas_are not accepted on this route.of 400 invalid_: 커서의 형식이 잘못되었거나 다른 필터용으로 발급되었습니다.cursor 409 snapshot_: 커서가 24시간이 넘어 만료되었습니다.unavailable cursor없이 다시 시작하세요.401 invalid_: Bearer 키가 누락되었거나 거부되었습니다.api_ key 402 insufficient_: 잔액이 호출 비용에 부족합니다.credits 404 series_: 해당 국가가 이 페이지의 지원 국가 목록에 없거나,not_ found series_가 그 국가의 시계열이 아니거나, 범위에 관측값이 없습니다. 목록에 없는 국가에는 해당 지표군을 이용할 수 없다는 상세 설명이 반환됩니다. 404는 요금이 부과되지 않습니다.id 429 rate_: 네트워크 또는 계정의 단기 구간 한도에 도달했습니다.limit_ exceeded Retry-After이후에 다시 시도하세요.503 economics_: Narwhal이 저장된 시계열을 안전하게 제공할 수 없습니다.unavailable
Only a successful data response costs credit. 확인 모든 오류, 헤더 및 재시도 규칙.
최신성
이 경로는 Narwhal이 현재 저장한 시계열을 오래된 순으로 반환합니다. start가 없으면 저장된 가장 오래된 기간부터 시작하므로, 최근 기간을 읽으려면 start를 전달하세요. as_나 version을 받지 않으므로 이전 시점의 데이터는 읽을 수 없습니다. Narwhal은 누락된 관측값을 채우지 않고 생략합니다.
현재 공개 베타 데이터 범위
10 국가
DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE
Eurostat의 월별 조화소비자물가지수(HICP)이며 전 품목, 계절 미조정입니다. 각국의 inflation 경로와는 다르며, 같은 국가라도 두 수치는 다릅니다. 기본 시계열은 전년 대비 변동률(퍼센트)이며 음수일 수 있습니다. 지수 수준의 기준은 2025=100입니다. 기간은 YYYY-MM 형식의 월입니다. 다른 국가는 404 series_를 반환하며 요금이 부과되지 않습니다. 지수 수준을 읽으려면 먼저 해당 국가의 시계열을 나열하세요. GET /는 각 시계열을 series_, name, unit(percent 또는 index), is_와 함께 반환하며, limit과 cursor를 사용한 요청으로 페이지를 넘기며 조회할 수 있습니다. unit이 index인 series_를 최신 경로 또는 이력 경로에 전달하세요.
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.
다음으로 돌아가기 모든 경제 데이터 작업.
무료 키로 시작하세요
매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.
이 페이지가 도움이 되었나요?