所有 API

商品进口 API

十个国家的官方货物进口总额。

首次请求

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

响应示例示例响应 · 并非实时请求

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

端点

GET商品进口/v1/economics/{country}/trade/imports

country: 支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period: 省略此参数可获取最新已接受的完整发布，或传入一个精确期间。
partner: 根据合约已接受，但当前测试版不会发布筛选后的合作伙伴总数。
product: HS 商品代码。请将其与分类一并提供。
classification: 《协调制度》的版本。请与product一同提供。

MCP · economics_get_trade_imports

API 参考 →

GET商品进口历史数据/v1/economics/{country}/trade/imports/observations

country: 支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
start: 包含的首个观测期。
end: 包含的最后观测期。
limit: 最多返回的观测值数量。默认为 100。
cursor: 上一页返回的next_cursor。

MCP · economics_get_trade_imports_history

API 参考 →

历史

cURL

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"

响应示例示例响应 · 并非实时请求

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