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

鉱工業生産 API

1つの国について、基準と出典を含む最新の月次鉱工業生産指数を取得します。

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

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

REST エンドポイント
GET /v1/economics/{country}/industrial-production
リクエストの例
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/industrial-production" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP で使用するツールは economics_get_industrial_production です。以下の対応する引数を指定します。

パラメータ

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

名前必須種別意味
countryはいパス · ISO alpha-3対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
periodいいえクエリ · YYYY-MM受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
series_idいいえクエリ · UUID任意。以前の回答から取得した1つの系列の`series_id`。省略すると、その国のデフォルトの系列を読み取ります。

レスポンス

レスポンスの例
{
  "source": {
    "publisher": "OECD",
    "distributor": "OECD"
  },
  "seasonal_adjustment": "seasonally_and_calendar_adjusted",
  "base_period": "2015",
  "base_value": "100",
  "period": "2026-09",
  "value": "102.9",
  "country": "USA",
  "series_id": "ea690cc4-a528-4c6d-b07a-5ecbdac08575",
  "unit": "index"
}
フィールド種別必須意味
sourceオブジェクトはい数値の発行元。publisherはその数値を出した統計機関で、distributorはNarwhalが読み取る元の機関です。系列ごとに全履歴を通じて出典は1つです。released_onはありません。
seasonal_adjustment文字列はいAlways seasonally_and_calendar_adjusted.
base_period文字列はい指数が100となる年:Eurostatの系列では2021、OECDの系列では2015。
base_value小数文字列はい基準年の指数値。ここではすべての系列で100です。
period文字列はい返される公式観測期間。
value小数文字列はい指数水準。基準はbase_periodとbase_valueにあります。水準であり、成長率ではありません。
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文字列はいAlways 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. 参照: すべてのエラー、ヘッダー、再試行規則。

鮮度

periodを省略すると、保存されている最新の観測値を返します。このAPI呼び出しはNarwhalのデータベースを読み取ります。発行元をリアルタイムで呼び出すことはありません。配信元が示す日付は発行元の公表日ではないため、回答にreleased_onはありません。

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

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

15 国

BEL, BGR, BRA, CHL, CZE, EST, FIN, FRA, HRV, IRL, ITA, KOR, SVN, SWE, USA

月次の指数水準。暦調整および季節調整済み。Eurostatの系列は2021=100、OECDの系列は2015=100で、どちらかはsourceとbase_periodで分かります。基準は国ごとに異なるため、水準の比較は同じ国の中だけにしてください。期間はYYYY-MM形式の月です。ほかの国は404 not_foundを返し、課金されません。

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

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

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