文档
大宗商品 API 参考
实物商品价格、序列发现和历史数据。包括美国燃油周度零售价格和世界银行月度基准。
基础 URL
本页涵盖实物棕榈油、美国燃油价格和商品月度基准。 全部四种金属的现货价格另有专门的 现货金属参考。 期货参考在相关产品发布前仍不可用。
REST 基础路径
https://api.narwhalapi.com/v1/commodities- 每次请求均使用同一个 Narwhal Bearer 密钥和共享账户配额。
- REST 和 MCP 使用相同的输入和输出数据结构。
实物价格操作
| 操作 | REST 路径 | MCP 工具 |
|---|---|---|
| 查找 棕榈油 实物数据序列 | /v1/commodities/palmoil/physical | commodities_list_palmoil_physical_series |
| 获取最新 棕榈油 实物价格 | /v1/commodities/palmoil/physical/{series_id} | commodities_get_palmoil_physical_price |
| 获取 棕榈油 实物历史数据 | /v1/commodities/palmoil/physical/{series_id}/observations | commodities_get_palmoil_physical_observations |
| 发现实物价格序列 | /v1/commodities/physical/series | commodities_list_physical_series |
| 获取实物价格序列详情 | /v1/commodities/physical/series/{series_id} | commodities_get_physical_series |
| 获取最新实物价格 | /v1/commodities/physical/series/{series_id}/latest | commodities_get_physical_latest |
| 获取实物价格历史 | /v1/commodities/physical/series/{series_id}/observations | commodities_get_physical_observations |
共享行为
- 实物数据序列发现接口仅返回完整且已获使用授权的序列。
- CPO 和马来西亚 FFB 返回一个价格数值。印度尼西亚 FFB 返回完整的树龄价目表。
- 价格保留原始币种和单位，并以十进制字符串表示。
- 历史数据按从旧到新排列，并使用与筛选条件绑定的不透明游标。
- 价目表缺失、重叠、含糊不清或混合了不同使用权的数据时，请求会以失败结束。
- 被拒绝或不可用的请求不会消耗月度配额。
覆盖范围
美国燃油数据涵盖20个普通汽油和2号公路用柴油的周度序列。每种产品均包含全美平均值和九个地区，价格以 USD/美制加仑计。历史始于2026年7月20日，并在每周一调查后逐周增加。来源: 美国能源信息署
月度基准涵盖70个序列，包括软商品、油脂和油籽、金属、谷物、能源、化肥、林产品以及畜牧和乳制品。历史最早可追溯至1960年。部分序列起始较晚或已结束。价格以 USD 计价，并保留发布时的单位。来源: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
本次发布涵盖印度尼西亚 CPO 政府参考价、印度尼西亚 FFB 收购价目表、马来西亚 CPO 本地交货市场均价和马来西亚 FFB 地区参考价。它们属于不同序列，各自具有不同含义和原始单位。
各序列的历史起始日期不同，且存在已注明的来源缺口。不包含 FCPO 期货。请参阅 大宗商品覆盖范围 以及 方法 ，了解具体限制。
使用 Narwhal API 密钥即可访问。