---
title: "金額 supply history API Reference | Narwhal API"
description: "1つの国について、月次の広義マネーの履歴を自国通貨で古い順に取得します。Parameters, examples, errors, freshness, and coverage."
url: "https://narwhalapi.com/ja/docs/api/economics/money-supply-history"
---

# Money supplyの履歴データ API

1つの国について、月次の広義マネーの履歴を自国通貨で古い順に取得します。

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

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

REST エンドポイント

```
GET /v1/economics/{country}/money-supply/observations
```

リクエストの例

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/KWT/money-supply/observations?start=2026-01&limit=2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

MCP で使用するツールは `economics_get_money_supply_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 | 任意。以前の回答から取得した1つの系列の`series_id`。省略すると、その国のデフォルトの系列を読み取ります。 |

## レスポンス

レスポンスの例

```
{
  "source": {
    "publisher": "Country authorities; National Summary Data Pages; European Central Bank; IMF Staff Calculations",
    "distributor": "International Monetary Fund"
  },
  "seasonal_adjustment": "not_seasonally_adjusted",
  "aggregate": "broad_money",
  "definition_label": "Broad Money",
  "country": "KWT",
  "series_id": "94322188-0436-47b7-b127-01f3f73cfab9",
  "unit": "currency",
  "currency": "KWD",
  "observations": [
    {
      "period": "2026-01",
      "value": "42179995400"
    },
    {
      "period": "2026-02",
      "value": "42605920000"
    }
  ],
  "next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}
```

履歴の例は`limit=2`を指定しているため、2行です。ここでは`next_cursor`を短くしています。実際のものはもっと長い不透明な文字列です。

| フィールド | 種別 | 必須 | 意味 |
| --- | --- | --- | --- |
| `source` | オブジェクト | はい | 数値の発行元。`publisher`はIMFの系列メタデータに記載された元の発行元で、`distributor`はNarwhalが読み取る元のIMFです。系列ごとに全履歴を通じて出典は1つです。`released_on`はありません。 |
| `seasonal_adjustment` | 文字列 | はい | Always `not_seasonally_adjusted`. |
| `aggregate` | 文字列 | はい | Always `broad_money`. |
| `definition_label` | 文字列 | はい | IMFのデータセットでの集計名：`Broad Money`。 |
| `country` | 文字列 | はい | 指定された大文字 ISO alpha-3 国コード。 |
| `series_id` | 文字列 | はい | 数値の元になった系列。同じ系列を再度読み取るには、`series_id`として渡します。 |
| `unit` | 文字列 | はい | Always `currency`. |
| `currency` | ISO 4217 文字列 | はい | その国の自国通貨。例：`KWD`。 |
| `observations` | 配列 | はい | 期間ごとに1件、古い順の観測値。1ページの件数が`limit`より少ないことがあります。`next_cursor`がnullになるまで辿ってください。 |
| `observations[].period` | 文字列 | はい | 観測値が表す公式の月、四半期、または年。 |
| `observations[].value` | 小数文字列 | はい | 月末の広義マネー。`currency`の自国通貨の整数単位で表します。 |
| `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. 参照： [すべてのエラー、ヘッダー、再試行規則](https://narwhalapi.com/ja/docs/errors.md)。

## 鮮度

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

読む [ソース確認、検証、保存済みリリース、確認失敗の仕組み](https://narwhalapi.com/ja/docs/freshness.md)。

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

4 国

`DOM, KAZ, KWT, MUS`

月次、国の自国通貨の整数単位、季節調整なし。広義マネーの定義は国ごとに異なるため、水準の比較は同じ国の中だけにしてください。国際通貨基金（IMF）が系列を配信し、`source.publisher`が元の発行元を示します。期間は`YYYY-MM`形式の月です。ほかの国は`404 not_found`を返し、課金されません。

日次 FX データの提供先は [為替API](https://narwhalapi.com/ja/api/fx.md)。

戻る： [すべての 経済データ 操作](https://narwhalapi.com/ja/docs/api/economics.md)。

## 無料キーで始めましょう

毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。

[無料のAPIキーを取得](https://narwhalapi.com/ja/signup)

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