所有 API

棕榈油 FFB 价格 API

按地区和树龄提供的印度尼西亚官方 FFB 计划

首次请求

快速入门
curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/oil-palm-ffb-price?country=IDN&area=ID-RI" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例 示例响应 · 并非实时请求
{
  "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
  "commodity": "OIL-PALM-FFB",
  "country": "IDN",
  "area": "ID-RI",
  "producer_type": "smallholder",
  "producer_arrangement": "purchase_agreement",
  "price_basis": "official_purchase_schedule",
  "currency": "IDR",
  "unit": "kilogram",
  "effective_from": "2026-08-26",
  "effective_to": "2026-09-01",
  "released_on": "2026-08-26",
  "revision": 1,
  "prices": [
    {
      "tree_age_min_years": 9,
      "tree_age_max_years": 9,
      "price": "3878.72"
    }
  ]
}

端点

GET发现已获批准的实物价格序列/v1/commodities/physical/{commodity}/{country}
GET读取一份最新的完整 FFB 日程/v1/commodities/oil-palm-ffb-price
GET读取按时间从旧到新排列的时间表历史记录/v1/commodities/oil-palm-ffb-price/observations

来源与方法论

真实日期

发布日期和生效日期保持分开。

没有部分数据

缺失或含糊的日程会被排除。

Narwhal 会保留已接受数据及其原有语义、时间和上下文,不会擦除数据或发布不完整更新。

FFB 价格不是 CPO 价格

series_id
某个地区和生产者安排的稳定身份。
effective_from / effective_to
一个时间表涵盖的起止日期(含首尾)。
prices[]
完整且不重叠的树龄区间及字符串格式的小数价格。
released_on / revision
官方发布日期和整份日程修订。
price_basis / currency / unit
官方收购日程、印尼盾和千克。

开发者指南

常见问题

这是 CPO 价格 API 吗?

不是。它提供官方鲜果串采购计划。CPO 基准价和期货需要单独的接口。

为什么一个响应中有多个价格?

同一份官方价格表可按树龄公布不同价格。Narwhal 会将这些记录保留在同一张表中。

哪个地区排在前面?

廖内是首个当前适配器。其他已研究地区仍仅具备历史状态或仅可验证。

发起你的第一个请求

获取免费 API 密钥