商品出口 API | Narwhal 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: 一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period: 省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。
partner: API 規格接受此參數，但目前測試版尚未發布依貿易夥伴篩選的總額。
product: HS 商品代碼。請與 classification 一併提供。
classification: Harmonized System 的版本。請與 product 一併提供。

MCP · economics_get_trade_exports

API 參考 →

GET貨物出口歷史資料/v1/economics/{country}/trade/exports/observations

country: 一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
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"
}