所有 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 密鑰