商品輸出API

1つの国と期間について、財輸出の合計を取得します。

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

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

REST エンドポイント

GET /v1/economics/{country}/trade/exports

リクエストの例

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade/exports?period=2026-06" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

REST が送信するもの： product および classification 個別のクエリパラメータとして。MCP はそれらを1つにネストします： product オブジェクト：

MCPのフィルター済み貿易引数

{
  "country": "USA",
  "period": "2026-06",
  "partner": "CAN",
  "product": {
    "classification": "HS2022",
    "code": "27"
  }
}

パラメータ

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

名前	必須	種別	意味
`country`	はい	パス · ISO alpha-3	サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
`period`	いいえ	クエリ · YYYY または YYYY-MM	最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
`partner`	いいえ	クエリ · ISO alpha-3	契約上は受け入れられていますが、フィルター済みのパートナー合計は現在のベータ版では公開されていません。
`product`	いいえ	クエリ · 2桁、4桁、または6桁	HS商品コード。分類と併せて指定します。
`classification`	いいえ	クエリ · HSYYYY	統一システムの版。product と一緒に指定します。

レスポンス

レスポンスの例

{
  "country": "USA",
  "period": "2026-06",
  "flow": "export",
  "value": "189000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "partner": null,
  "product": null,
  "released_on": "2026-08-04"
}

フィールド	種別	必須	意味
`country`	文字列	はい	指定された大文字 ISO alpha-3 国コード。
`period`	文字列	はい	返される公式観測期間。
`flow`	"export" または "import"	はい	ルートで固定された財貿易の方向。
`value`	10進数文字列	はい	選択した方向の金額。
`currency`	ISO 4217 文字列	はい	金額の通貨。
`coverage`	"merchandise"	はい	サービス貿易が含まれていないことを確認します。
`partner`	ISO alpha-3 文字列または null	いいえ	指定されたパートナーフィルター（存在する場合）。公開の未フィルター合計では null または省略になる場合があります。
`product`	オブジェクトまたは null	いいえ	指定された HS 分類と商品コード（存在する場合）。公開の未フィルター合計では null または省略になる場合があります。
`released_on`	日付	はい	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 は受け入れ済み公開データを安全に提供できません。

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

鮮度

省略 period Narwhal が保存した最新の受け入れ済みリリースを返します。API 呼び出しは Narwhal のデータベースを読み取り、公式発行元をリアルタイムで呼び出しません。

released_on 公式公開日です。

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

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

未フィルターの国別財輸出合計は AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA で公開されています。パートナーと商品フィルターは契約上受け付けますが、フィルター済み合計が公開されるまでは 404 を返します。

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

戻る：すべての Economics 操作.