大宗商品 API 參考
棕櫚油 FFB 時間表與歷史記錄
基礎 URL
REST 基礎路徑
https://api.narwhalapi.com/v1/commodities- 每個請求都使用同一個 Narwhal Bearer 密鑰和共享帳戶配額。
- REST 與 MCP 使用相同的輸入和輸出架構。
- 輸入和輸出使用同一套由代碼定義的結構。
三項實物價格操作
| 操作 | REST 路徑 | MCP 工具 |
|---|---|---|
| 查找實物價格序列 | /v1/commodities/physical/{commodity}/{country} | commodities_discover_physical_series |
| 獲取最新棕櫚油 FFB 價格表 | /v1/commodities/oil-palm-ffb-price | commodities_get_oil_palm_ffb_price |
| 獲取棕櫚油 FFB 歷史價格表 | /v1/commodities/oil-palm-ffb-price/observations | commodities_get_oil_palm_ffb_price_observations |
共享行為
- 實物序列發現介面僅返回完整且已獲權利批准的序列。
- 每個 Palmoil FFB 回應對應一整份官方收購日程。
- 樹齡行不能獨立發布或修訂。
- 歷史數據按從舊到新排列，並使用與篩選條件綁定的不透明游標。
- 缺失、重疊、含糊或權利混雜的日程會安全失敗。
- 被拒絕或不可用的請求不會消耗月度配額。
首版發布範圍
第一個切片是印度尼西亞官方 Palmoil 新鮮果串採購價目表。它不是 CPO 基準、期貨價格、一般農場門價平均值、工廠報價或交易信號。
廖内是首个当前介接器。其他已研究地區保留歷史、仅接受或提取受限狀態。請閱讀 大宗商品覆蓋範圍 和 該 方法 用於查看確切限制。
使用 Narwhal API 密鑰即可獲得。