所有 API

商品出口 API

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

首次请求

快速入门
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade/exports?period=2026-06" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例 示例响应 · 并非实时请求
{
  "country": "USA",
  "period": "2026-06",
  "flow": "export",
  "value": "189000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "partner": null,
  "product": null,
  "released_on": "2026-08-04"
}

端点

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

MCP · economics_get_trade_exports

API 参考
GET商品出口历史数据/v1/economics/{country}/trade/exports/observations
country
支持的一个大写国家代码:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
start
包含的首个观测期。
end
包含的最后观测期。
limit
最多返回的观测值数量。默认为 100。
cursor
上一页返回的next_cursor。

MCP · economics_get_trade_exports_history

API 参考

历史

cURL
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade/exports/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"
}

来源与方法论

明确的期间

省略此参数可获取最新已接受的完整发布,或传入一个精确期间。

REST 和 MCP

使用一个 API 密钥,通过 REST 或 MCP 获取最新及历史数据。

常见问题

响应包含哪些内容?

获取一个国家某个期间的商品出口总额。

可以请求哪些时间段?

YYYY 或 YYYY-MM

支持哪些数据范围?

AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP和USA的未筛选全国商品出口总额已公开。契约接受伙伴和产品筛选条件,但在筛选总额发布前会返回404。

发起你的第一个请求

获取免费 API 密钥