商品出口歷史數據 API

獲取一個國家當前已接受的商品出口時間序列。

economics_get_trade_exports_history 可通過 REST 和 economics_get_trade_exports_history MCP 工具。兩者返回相同的數據結構，並消耗相同的月度配額。

端点與請求

REST 端點

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

請求範例

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"

MCP 使用工具 economics_get_trade_exports_history 使用下面對應的參數。

參數

此操作接受的期間格式是 YYYY-MM.

名稱	必填	類型	含義
`country`	是	路徑·ISO alpha-3	支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
`start`	否	查詢·YYYY-MM	包含的首個觀測期。
`end`	否	查詢·YYYY-MM	包含的最後觀測期。
`limit`	否	查詢·整數，1–1000	最多返回的觀測值數量。預設為 100。
`cursor`	否	查詢·不透明字串	上一頁返回的next_cursor。

回應

回應範例

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

欄位	類型	必填	含義
`observations`	陣列	是	按從最早到最近的順序排列已接受的觀測值。缺失的來源數值會被省略，絕不會填補。
`observations[].country`	字串	是	所請求的大寫 ISO 三字母國家代碼。
`observations[].measure`	字串	是	該觀測值所代表的規範指標。
`observations[].period`	字串	是	觀測值所代表的官方月份或季度。
`observations[].value`	十進位數值字串	是	不經過二進位浮點轉換的已接受來源值。
`observations[].unit`	字串	是	該指標的來源單位或貨幣代碼。
`observations[].transformation`	字串	是	指標變換；若為水平值則為空字串。
`next_cursor`	字串或 null	否	將此值原樣作為 cursor 傳入，以讀取下一頁。
`as_of`	RFC 3339 時間戳記	否	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 無法安全提供已接受的發布版本。

只有成功的數據回應才會消耗配額。參見所有錯誤、請求頭和重試規則.

新鮮度

此路由返回Narwhal截至指定時間當前已接受的序列 as_of。這是按當前版本提供的歷史數據，不是對過去每次發布版本的重建。

官方來源可能較為稀疏，且提供的歷史深度各不相同。Narwhal 會省略缺失觀測值，而不是進行插值或向前延續數值。

讀取源檢查、驗證、已儲存發布版本和失敗檢查的工作方式.

當前公開測試覆蓋範圍

AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA 的官方歷史數據已公開；最早可用期間因來源而異。

印度尼西亞、區域路由和 Commodities 尚未公開。FX 可通過單獨的 FX API.

返回所有經濟數據操作.