商品輸入履歴API

1つの国について、現在受け入れられている財輸入の時系列を取得します。

economics_get_trade_imports_history REST と次の経路で利用できます： economics_get_trade_imports_history MCPツール。どちらも同じデータ形式を返し、同じ月間クォータを消費します。

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

REST エンドポイント

GET /v1/economics/{country}/trade/imports/observations

リクエストの例

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade/imports/observations?start=2026-06&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

パラメータ

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

名前	必須	種別	意味
`country`	はい	パス · ISO alpha-3	サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
`start`	いいえ	クエリ · YYYY-MM	最初の観測期間（その期間を含む）。
`end`	いいえ	クエリ · YYYY-MM	最後の観測期間（その期間を含む）。
`limit`	いいえ	クエリ · 整数、1～1000	返す観測値の最大数。デフォルトは100です。
`cursor`	いいえ	クエリ · 不透明な文字列	前のページの next_cursor。

レスポンス

レスポンスの例

{
  "observations": [
    {
      "country": "USA",
      "measure": "trade_imports",
      "value": "275000000000",
      "unit": "USD",
      "transformation": "",
      "period": "2026-06"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

フィールド	種別	必須	意味
`observations`	配列	はい	受け入れ済み観測値を古い順に表示。ソースの欠損値は省略し、決して補完しません。
`observations[].country`	文字列	はい	指定された大文字 ISO alpha-3 国コード。
`observations[].measure`	文字列	はい	この観測値が表す正式な指標。
`observations[].period`	文字列	はい	観測値が表す公式の月または四半期。
`observations[].value`	10進数文字列	はい	2進浮動小数点変換を行わない、受け入れ済みソース値。
`observations[].unit`	文字列	はい	指標のソース単位または通貨コード。
`observations[].transformation`	文字列	はい	指標の変換方法。水準の場合は空文字列。
`next_cursor`	文字列または null	いいえ	これを変更せずカーソルとして渡すと、次のページを読み取れます。
`as_of`	RFC 3339 タイムスタンプ	いいえ	Narwhal が現在の保存済み系列スナップショットを受け入れた時点。

エラーとクォータ

400 invalid_query — 国、期間、フィルター形式が無効です。
401 invalid_api_key — Bearer キーがないか拒否されました。
404 series_not_found — リクエストに一致する承認済み観測値がありません。
429 rate_limit_exceeded — ネットワークまたはアカウントの短時間上限に達しました。再試行時刻： Retry-After.
429 quota_exhausted — アカウントが月間枠に達しました。
503 economics_unavailable — Narwhal は受け入れ済み公開データを安全に提供できません。

クォータを消費するのは成功したデータレスポンスだけです。次を参照：すべてのエラー、ヘッダー、再試行規則.

鮮度

このルートは、次の時点で Narwhal が受け入れた現在の系列を返します： as_of。これは現行版の履歴であり、過去の公開版をすべて再構成したものではありません。

公式ソースは観測値が疎で、公開する履歴の深さも異なる場合があります。Narwhal は補間や値の繰り越しをせず、欠損した観測値を省略します。

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

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

AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USAでは、利用可能な公式履歴が公開されています。最初に利用できる期間はソースによって異なります。

インドネシア、地域別ルート、コモディティは公開されていません。FXは別の FX API.

戻る：すべての Economics 操作.