すべてのドキュメントを閲覧

調和インフレ率の履歴データ API

1つの国について、月次の調和インフレ率(HICP)の履歴を古い順に取得します。

economics_get_harmonised_inflation_history を利用できるのは REST と、 economics_get_harmonised_inflation_history MCPツール。どちらも同じデータ形式を返し、同じクレジットを使用します。

エンドポイントとリクエスト

REST エンドポイント
GET /v1/economics/{country}/harmonised-inflation/observations
リクエストの例
curl --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_get_harmonised_inflation_history です。以下の対応する引数を指定します。

パラメータ

この操作で受け付ける期間形式: YYYY-MM。

名前必須種別意味
countryはいパス · ISO alpha-3対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
startいいえクエリ · YYYY-MM最初の観測期間(その期間を含む)。
endいいえクエリ · YYYY-MM最後の観測期間(その期間を含む)。
limitいいえクエリ · 整数、1~1000返す期間数の上限。デフォルトは 100 です。1ページの期間数がこれより少ない場合もあるため、next_cursor をたどってください。
cursorいいえクエリ · 不透明な文字列前のページの next_cursor。
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)",
  "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を指定しているため、2行です。ここではnext_cursorを短くしています。実際のものはもっと長い不透明な文字列です。

フィールド種別必須意味
sourceオブジェクトはい数値の発行元。publisherはその数値を出した統計機関で、distributorはNarwhalが読み取る元の機関です。系列ごとに全履歴を通じて出典は1つです。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小数文字列いいえ基準年の指数値。指数水準にのみ含まれます。
country文字列はい指定された大文字 ISO alpha-3 国コード。
series_id文字列はい数値の元になった系列。同じ系列を再度読み取るには、series_idとして渡します。
unit文字列はい年率はpercent、指数水準はindex。
observations配列はい期間ごとに1件、古い順の観測値。1ページの件数がlimitより少ないことがあります。next_cursorがnullになるまで辿ってください。
observations[].period文字列はい観測値が表す公式の月、四半期、または年。
observations[].value小数文字列はいunitの数値:パーセント表示の年率(負になることもあります)、または指数水準。
observations[].status文字列いいえ発行元が示す数値にのみ含まれます:estimated、break_in_series、definition_differs、break_in_series_and_definition_differs。それ以外は省略されます。
observations[].release_status文字列いいえ発行元がその数値を暫定としている場合はpreliminary。それ以外は省略されます。
next_cursor文字列または nullはいこれを変更せずにcursorとして渡すと、次のページを読み取れます。最後のページではnullです。

APIエラーとクレジット

  • 400 invalid_query: A query parameter is unknown or repeated, country is not three uppercase letters, series_id is not a UUID, start or end is not a month in YYYY-MM format, start and end differ in format or start is after end, or limit is outside 1 to 1000. version_id, version and as_of are not accepted on this route.
  • 400 invalid_cursor: カーソルの形式が不正か、別のフィルター用に発行されたものです。
  • 409 snapshot_unavailable: カーソルは24時間以上前のもので、有効期限が切れています。cursorなしでやり直してください。
  • 401 invalid_api_key: Bearerキーがないか拒否されました。
  • 402 insufficient_credits: 残高では呼び出しの料金を支払えません。
  • 404 series_not_found: その国がこのページの対象国一覧にない、series_idがその国の系列ではない、または範囲内に観測値がありません。一覧にない国には、この指標群は利用できないという詳細が返ります。404は課金されません。
  • 429 rate_limit_exceeded: ネットワークまたはアカウントの短時間枠の上限に達しました。Retry-Afterの後に再試行してください。
  • 503 economics_unavailable: Narwhalは保存されている系列を安全に提供できません。

Only a successful data response costs credit. 参照: すべてのエラー、ヘッダー、再試行規則。

鮮度

このルートはNarwhalが現在保存している系列を古い順に返します。startを指定しない場合は保存されている最も古い期間から始まるため、最近の期間を読むにはstartを指定してください。as_ofやversionは受け取らないため、過去の時点のデータは読み取れません。Narwhalは欠損した観測値を補完せず、省略します。

読む ソース確認、検証、保存済みリリース、確認失敗の仕組み。

現在の公開ベータ版カバレッジ

10 国

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

月次の消費者物価調和指数(HICP)。全品目、Eurostat、季節調整なし。各国のinflationルートとは別物で、同じ国でも2つの数値は異なります。デフォルトの系列は前年比の変化率(パーセント)で、負になることもあります。指数水準の基準は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
}

日次 FX データの提供先は 為替API。

戻る: すべての 経済データ 操作。

このページは役に立ちましたか?