すべてのAPI

商品貿易API

公式の商品輸出額、輸入額、貿易収支。

初回リクエスト

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

レスポンスの例説明用レスポンス · ライブリクエストではありません

{
  "country": "USA",
  "period": "2026-06",
  "exports": "189000000000",
  "imports": "275000000000",
  "balance": "-86000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "released_on": "2026-08-04"
}

エンドポイント

GET商品貿易/v1/economics/{country}/trade

country: サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period: 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。

MCP · economics_get_trade

APIリファレンス →

GET商品貿易履歴/v1/economics/{country}/trade/observations

country: サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
start: 最初の観測期間（その期間を含む）。
end: 最後の観測期間（その期間を含む）。
limit: 返す観測値の最大数。デフォルトは100です。
cursor: 前のページの next_cursor。

MCP · economics_get_trade_history

APIリファレンス →

履歴

cURL

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

レスポンスの例説明用レスポンス · ライブリクエストではありません

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