以你的货币显示价格
用汇率把商品价格换算成你自己的货币。
阅读指南 →所有 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
常见问题
如何获取铜价历史？
使用 worldbank-cmo-copper 和 observations 端点。同时传入 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 美元免费额度，无需绑卡。