所有 API

各國貿易統計 API

貿易統計 API 可透過 REST 或 MCP 查詢各國官方商品貿易統計資料，取得最新採用值、指定期間的數值，或附日期的歷史資料，方便串接到你的應用程式。

在線99.94% uptime, last 30天378 ms 一般回應

首次請求

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

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

取得一個期間的出口額、進口額和精確的商品貿易差額。不包含服務。

country必填
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period選填
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。
version_id選填
選填的不可變發布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略則讀取目前已收錄的指標。

country字串
所請求的大寫 ISO 三字母國家代碼。
period字串
回傳的官方觀測期間。
exports表示非負數的十進位字串
貨物出口總額。
imports表示非負數的十進位字串
貨物進口總額。
balance十進位數值字串
精確的出口額減進口額；結果可能為負。
currencyISO 4217 字串
三個貨幣值所使用的貨幣。
released_on日期
官方發布日期，而不是 Narwhal 的檢索時間。
source對象
選填的 source 物件僅在統計資料經由分發方取得時出現，包含 publisher（分發方所註明的原始發布方）和 distributor（分發機構）。存在 source 時，released_on 是分發方的發布日期，而不是原始發布方的發布日期。由發布方直接提供的序列沒有 source。

GET貨物貿易歷史資料/v1/economics/{country}/trade/observations

取得指定國家目前已接受的貨物貿易時間序列。

country必填
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
start選填
起始觀測期間（含該期間）。
end選填
結束觀測期間（含該期間）。
limit選填
傳回的期間數上限。預設值為 100。頁面可能包含較少的期間；請繼續使用 next_cursor。
cursor選填
上一頁回傳的 next_cursor。
version選填
只接受 first_reported：回傳每個期間首次儲存的值，並附帶 first_reported_at。不能與 as_of 同時使用。
as_of選填
回傳截至指定 UTC 日終時已發布的序列。不能與 version 同時使用。

country字串
請求的大寫 ISO alpha-3 國家代碼。每頁傳回一次，不在每筆觀測資料中重複。
start字串
僅當 Narwhal 將請求的 start 移至較晚的期間時出現。不會傳回更早的期間。
as_ofRFC 3339 時間戳記
來源最後更新本頁最新觀測值的時間，精確到整秒，使用 UTC。
source對象
透過資料分發機構取得的統計資料來源資訊；請參閱最新值操作。
currencyISO 4217 字串
本頁所有數值使用的幣別。
observations陣列
按時間由早到晚排列的已採用觀測資料，每個期間一筆。來源缺少的值會省略，絕不補值。每頁觀測資料筆數可能少於 limit；請繼續使用 next_cursor，直到其值為 null。
observations[].period字串
觀測值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 時間戳記
僅在 version=first_reported 時出現。這個 UTC 時間戳記錄 Narwhal 首次儲存該期間的時間（如果各項指標是分開儲存的，則取最晚的時間）。在開始擷取之前發布的期間，顯示的是 Narwhal 的首次擷取時間。
observations[].exports十進位數值字串
該期間的商品出口額。該期間沒有可用值時省略。
observations[].imports十進位數值字串
該期間的商品進口額。該期間沒有可用值時省略。
next_cursor字串或 null
將此值原樣作為 cursor 傳入，以讀取下一頁；最後一頁為 null。