文件
大宗商品 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 期貨。請參閱 Commodities 涵蓋範圍 以及 方法 以了解確切限制。
使用 Narwhal API 金鑰即可存取。