大宗商品 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 密钥即可获得。