以你的貨幣顯示價格
用匯率把商品價格換算成你自己的貨幣。
閱讀指南 →所有 API
歷史商品價格 API
A commodity prices API for 70 monthly series from the World Bank Pink Sheet. Read copper price history, fertilizer prices and agricultural benchmarks in USD, with units as published. 來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
首次請求
尋找金屬序列
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/physical/series?category=metals" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例
{
"series": [
{
"series_id": "worldbank-cmo-copper",
"commodity": "copper",
"commodity_key": "copper",
"category": "metals",
"product": "copper",
"country": "WLD",
"price_type": "international_benchmark",
"basis": "settlement price",
"currency": "USD",
"unit": "metric_ton",
"unit_key": "tonne",
"unit_quantity": "1",
"frequency": "monthly",
"description": "Grade A copper, minimum 99.9935% purity, cathodes and wire bar shapes, exchange settlement price.",
"attribution": "The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0",
"coverage_start": "1960-01-01",
"coverage_end": "2026-09-30"
}
]
}端點
GET探索實物價格序列/v1/commodities/physical/series
探索每週美國零售燃料價格、每日石油與天然氣現貨價格，以及每月商品基準價格。
參數
commodity選填依商品篩選，例如 gasoline、diesel、copper、urea、rice、crude-oil 或 coffee。請使用探索操作回傳的 commodity 值。
category選填支援的類別為 softs、oils-oilseeds、metals、grains、energy、fertilizers、forestry 與 livestock-dairy。燃油序列使用 energy。
country選填全球基準使用 WLD，歐盟使用 EUU。支援的國家代碼為 USA、THA、JPN、AUS、ZAF、MYS、CMR、VNM、MEX、LKA、IND 與 KEN。美國燃油使用 USA。
price_type選填燃料使用retail_average。EIA每日現貨和World Bank序列使用international_benchmark，菸草除外，使用import_unit_value。
currency選填依報價貨幣篩選。目前兩個來源均使用 USD。
limit選填每頁最多回傳的項目數，預設為100。
cursor選填使用上一頁的 next_cursor，並保持篩選條件與 limit 不變。null 表示沒有更多頁面。
回應欄位
series陣列序列包含 commodity、product、country、area、價格基準 basis、currency、unit、frequency、attribution 與涵蓋日期。空陣列表示沒有符合的序列。
series[].series_id字串序列探索操作回傳的穩定 ID。
series[].currency字串報價貨幣。美國燃油與月度基準序列均使用 USD。
series[].unit / series[].unit_quantity字串發布時的單位與計價數量。燃油使用 us_gallon。月度基準使用 metric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit 或 sheet。數量為1，合板除外，其價格以每100張的 USD 金額計。數值不作換算。
series[].unit_key字串unit_key 是以一種標準寫法表示的單位,例如 troy_ounce、barrel 或 tonne;unit 則保留來源的原始寫法。當價格以美分報價時,price_scale 為 0.01:將價格乘以該值即可得到以貨幣計的金額。
series[].attribution字串請隨資料保留回應中的來源署名。來源: 美國能源資訊署。來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
series[].commodity / series[].category / series[].product字串商品、類別與產品定義。例如 gasoline / energy / regular-gasoline 與 copper / metals / copper。探索操作會回傳各序列的對應值。
series[].commodity_key字串commodity_key 在現貨、期貨、預測與實物價格中以相同方式命名商品，例如 gold 或 crude-oil。原油另有 benchmark（wti、brent、urals 或 dubai），期貨則有 exchange_mic，即交易所的標準代碼。
series[].area字串area 表示地區範圍，全國序列省略此欄位。
series[].country字串WLD 表示世界基準。EUU 表示歐盟。國家使用 ISO alpha-3 代碼。美國燃油全國平均值使用 USA。
series[].price_type字串燃料使用retail_average。EIA每日現貨和月度序列使用international_benchmark，菸草除外，使用import_unit_value。
series[].basis字串basis 說明價格定義，來源未提供時省略。
完整參考文件 →
GET取得實物價格序列詳情/v1/commodities/physical/series/{series_id}
讀取單一每週燃料或每月基準價格序列的定義、單位與涵蓋範圍。
參數
series_id必填請使用探索操作回傳的穩定 ID，例如 fuel-eia-usa-regular-gasoline 或 worldbank-cmo-copper。
回應欄位
series_id字串序列探索操作回傳的穩定 ID。
currency字串報價貨幣。美國燃油與月度基準序列均使用 USD。
unit / unit_quantity字串發布時的單位與計價數量。燃油使用 us_gallon。月度基準使用 metric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit 或 sheet。數量為1，合板除外，其價格以每100張的 USD 金額計。數值不作換算。
unit_key字串unit_key 是以一種標準寫法表示的單位,例如 troy_ounce、barrel 或 tonne;unit 則保留來源的原始寫法。當價格以美分報價時,price_scale 為 0.01:將價格乘以該值即可得到以貨幣計的金額。
attribution字串請隨資料保留回應中的來源署名。來源: 美國能源資訊署。來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
commodity / category / product字串商品、類別與產品定義。例如 gasoline / energy / regular-gasoline 與 copper / metals / copper。探索操作會回傳各序列的對應值。
commodity_key字串commodity_key 在現貨、期貨、預測與實物價格中以相同方式命名商品，例如 gold 或 crude-oil。原油另有 benchmark（wti、brent、urals 或 dubai），期貨則有 exchange_mic，即交易所的標準代碼。
area字串area 表示地區範圍，全國序列省略此欄位。
country字串WLD 表示世界基準。EUU 表示歐盟。國家使用 ISO alpha-3 代碼。美國燃油全國平均值使用 USA。
price_type字串燃料使用retail_average。EIA每日現貨和月度序列使用international_benchmark，菸草除外，使用import_unit_value。
basis字串basis 說明價格定義，來源未提供時省略。
frequency字串EIA石油和天然氣現貨價格為每日資料，美國燃料為每週資料，World Bank基準價格為每月資料。
完整參考文件 →
GET取得最新實物價格/v1/commodities/physical/series/{series_id}/latest
讀取最新可用的每週燃料或每月基準價格及其觀測期間。
參數
series_id必填請使用探索操作回傳的穩定 ID，例如 fuel-eia-usa-regular-gasoline 或 worldbank-cmo-copper。
回應欄位
series_id字串序列探索操作回傳的穩定 ID。
currency字串報價貨幣。美國燃油與月度基準序列均使用 USD。
unit / unit_quantity字串發布時的單位與計價數量。燃油使用 us_gallon。月度基準使用 metric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit 或 sheet。數量為1，合板除外，其價格以每100張的 USD 金額計。數值不作換算。
unit_key字串unit_key 是以一種標準寫法表示的單位,例如 troy_ounce、barrel 或 tonne;unit 則保留來源的原始寫法。當價格以美分報價時,price_scale 為 0.01:將價格乘以該值即可得到以貨幣計的金額。
attribution字串請隨資料保留回應中的來源署名。來源: 美國能源資訊署。來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
period_start / period_end日期觀測日期，包含起訖日期。燃油的兩個日期均為週一調查日期。月度觀測值涵蓋整個月，例如2026-09-01至2026-09-30。
price十進位數值字串以序列貨幣發布的價格，每 unit_quantity 個單位計價。請搭配序列的價格類型與 basis 解讀。
published_on日期發布日期。來源未提供時省略。
revision整數從1開始，後續發布修改該期間的數值時遞增。
完整參考文件 →
GET取得實物價格歷史/v1/commodities/physical/series/{series_id}/observations
讀取每週燃料或每月商品價格歷史，包含期間、公布單位與修訂紀錄。
參數
series_id必填請使用探索操作回傳的穩定 ID，例如 fuel-eia-usa-regular-gasoline 或 worldbank-cmo-copper。
start選填包含起始日期。請同時提供 start 與 end，或同時省略兩者。
end選填結束日期不包含在內，且必須晚於 start。回傳與該日期區間重疊的觀測值。
limit選填每頁最多回傳的項目數，預設為100。
cursor選填使用上一頁的 next_cursor，並保持篩選條件與 limit 不變。null 表示沒有更多頁面。
回應欄位
series_id字串序列探索操作回傳的穩定 ID。
currency字串報價貨幣。美國燃油與月度基準序列均使用 USD。
unit / unit_quantity字串發布時的單位與計價數量。燃油使用 us_gallon。月度基準使用 metric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit 或 sheet。數量為1，合板除外，其價格以每100張的 USD 金額計。數值不作換算。
unit_key字串unit_key 是以一種標準寫法表示的單位,例如 troy_ounce、barrel 或 tonne;unit 則保留來源的原始寫法。當價格以美分報價時,price_scale 為 0.01:將價格乘以該值即可得到以貨幣計的金額。
attribution字串請隨資料保留回應中的來源署名。來源: 美國能源資訊署。來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
observations陣列觀測值按由舊到新排序。每項包含 period_start、period_end、以十進位字串表示的 price 與 revision。published_on 為選填欄位。
observations[].period_start / observations[].period_end日期觀測日期，包含起訖日期。燃油的兩個日期均為週一調查日期。月度觀測值涵蓋整個月，例如2026-09-01至2026-09-30。
observations[].price十進位數值字串以序列貨幣發布的價格，每 unit_quantity 個單位計價。請搭配序列的價格類型與 basis 解讀。
observations[].published_on日期發布日期。來源未提供時省略。
observations[].revision整數從1開始，後續發布修改該期間的數值時遞增。
next_cursor字串或 null不需解析內部結構的續頁權杖。null 表示最後一頁。
完整參考文件 →
使用情境
涵蓋範圍
來源
相關 API
常見問題
我要如何取得銅價歷史？
搭配 observations 端點使用 worldbank-cmo-copper。同時傳入 start 與 end 以選擇日期區間。銅價為月度十進位字串，單位為每公噸 USD。
這個商品 API 包含肥料價格與稻米價格嗎？
有。肥料價格請使用 category=fertilizers，尿素價格數列請使用 commodity=urea，稻米價格基準請使用 commodity=rice。探索會回傳用於最新價格與歷史資料的數列 ID。
歷史資料可回溯到多久以前？
最早的月度數列自 1960 年 1 月開始。其他數列開始較晚，有些已停止更新。請讀取各數列的 coverage_start 與 coverage_end。
適用哪些單位與授權？
All prices use USD and the published unit and quantity. No unit conversion is applied. Keep the attribution with the data, which is licensed under CC BY 4.0. 來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
使用資料之前應該檢查什麼？
A new month is added after each monthly publication. Individual series can lag or have ended. Barley and sorghum end in August 2020; Mexican shrimp ends in October 2023. Check coverage_end before treating a value as current. Most series use WLD for a world benchmark. Others identify a country or the European Union. 來源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。