調和インフレ率 API
1つの国について、最新の調和インフレ率(HICP)として、パーセント表示の年率を取得します。
economics_ を利用できるのは REST と、 economics_ MCPツール。どちらも同じデータ形式を返し、同じクレジットを使用します。
エンドポイントとリクエスト
GET /v1/economics/{country}/harmonised-inflationcurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP で使用するツールは economics_ です。以下の対応する引数を指定します。
パラメータ
この操作で受け付ける期間形式: YYYY-MM。
| 名前 | 必須 | 種別 | 意味 |
|---|---|---|---|
country | はい | パス · ISO alpha-3 | 対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。 |
period | いいえ | クエリ · YYYY-MM | 受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。 |
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)",
"period": "2026-10",
"value": "3.7",
"country": "FRA",
"series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
"unit": "percent"
}| フィールド | 種別 | 必須 | 意味 |
|---|---|---|---|
source | オブジェクト | はい | 数値の発行元。publisherはその数値を出した統計機関で、distributorはNarwhalが読み取る元の機関です。系列ごとに全履歴を通じて出典は1つです。released_はありません。 |
measure | 文字列 | はい | year_は前年比の変化率(パーセント)。levelは指数水準です。 |
seasonal_ | 文字列 | はい | Always not_. |
classification | 文字列 | はい | 数値が対象とする物価の集計区分:全品目、COICOP 2018。 |
base_ | 文字列 | いいえ | 指数が100となる年。Present for the index level only. |
base_ | 小数文字列 | いいえ | 基準年の指数値。指数水準にのみ含まれます。 |
period | 文字列 | はい | 返される公式観測期間。 |
value | 小数文字列 | はい | unitの数値:パーセント表示の年率(負になることもあります)、または指数水準。 |
status | 文字列 | いいえ | 発行元が示す数値にのみ含まれます:estimated、break_、definition_、break_。それ以外は省略されます。 |
release_ | 文字列 | いいえ | 発行元がその数値を暫定としている場合はpreliminary。それ以外は省略されます。 |
country | 文字列 | はい | 指定された大文字 ISO alpha-3 国コード。 |
series_ | 文字列 | はい | 数値の元になった系列。同じ系列を再度読み取るには、series_として渡します。 |
unit | 文字列 | はい | 年率はpercent、指数水準はindex。 |
APIエラーとクレジット
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID, orid periodis not a month inYYYY-MMformat.version_,id versionandas_are not accepted on this route.of 401 invalid_: Bearerキーがないか拒否されました。api_ key 402 insufficient_: 残高では呼び出しの料金を支払えません。credits 404 series_: その国がこのページの対象国一覧にない、not_ found series_がその国の系列ではない、またはid periodに一致する観測値がありません。一覧にない国には、この指標群は利用できないという詳細が返ります。404は課金されません。429 rate_: ネットワークまたはアカウントの短時間枠の上限に達しました。limit_ exceeded Retry-Afterの後に再試行してください。503 economics_: Narwhalは保存されている系列を安全に提供できません。unavailable
Only a successful data response costs credit. 参照: すべてのエラー、ヘッダー、再試行規則。
鮮度
periodを省略すると、保存されている最新の観測値を返します。このAPI呼び出しはNarwhalのデータベースを読み取ります。発行元をリアルタイムで呼び出すことはありません。配信元が示す日付は発行元の公表日ではないため、回答にreleased_はありません。
現在の公開ベータ版カバレッジ
10 国
DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE
月次の消費者物価調和指数(HICP)。全品目、Eurostat、季節調整なし。各国のinflationルートとは別物で、同じ国でも2つの数値は異なります。デフォルトの系列は前年比の変化率(パーセント)で、負になることもあります。指数水準の基準は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
}日次 FX データの提供先は 為替API。
戻る: すべての 経済データ 操作。
無料キーで始めましょう
毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。
このページは役に立ちましたか?