棕櫚油鮮果串（FFB）價格 API

獲取最新 FFB 價格表

端点與請求

REST 端點

GET /v1/commodities/oil-palm-ffb-price

契約請求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/oil-palm-ffb-price?country=IDN&area=ID-RI&producer_type=smallholder&producer_arrangement=purchase_agreement" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 使用 commodities_get_oil_palm_ffb_price。REST 和 MCP 使用相同的結構、帳戶額度、權限檢查和問題格式。

參數

名稱	必填	類型	含義
`country`	是	查詢·ISO 3166-1 alpha-3	擁有官方時間表的國家。首個研究國家是 IDN。
`area`	否	查詢·ISO 3166-2 或 Narwhal 區域	代表廖內的區域，例如 ID-RI。只有在可以如實選定單個序列時才省略。
`producer_type`	是	查詢·smallholder	全球生產者詞彙表。第一份契約僅接受 smallholder。
`producer_arrangement`	否	查詢·purchase_agreement 或 supported_scheme	主管機構對生產者安排作出區分時所採用的生產者安排。

回應

契約示例

{
  "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"
    }
  ]
}

欄位	類型	必填	含義
`series_id`	字串	是	穩定的實物序列身份。
`commodity / country / area`	字串	是	OIL-PALM-FFB 及其確切地理範圍。
`producer_type / producer_arrangement`	字串或 null	是	官方時間表所使用的生產者範圍。
`price_basis / currency / unit`	字串	是	首個研究切片中的官方收購日程、印尼盾和千克。
`effective_from / effective_to / released_on`	日期	是	包含的日程日期和官方發布日期。
`revision`	整數	是	整張價格表的修訂版本號。
`prices`	陣列	是	完整且不重疊的樹齡區間及字串格式的小數價格。

錯誤與配額

400 invalid_query — 代碼、區域、日期範圍、限制或選擇器無效。
401 invalid_api_key — Bearer 密鑰缺失或被拒絕。
404 physical_price_not_found — 沒有完整的已批准數據符合請求。
409 physical_series_ambiguous — 選擇器匹配了多個序列。
429 rate_limit_exceeded 或 quota_exhausted — 共享額度已耗盡。
503 physical_price_unavailable — 完整發布版本無法安全滿足該介面。

被拒絕的請求和服務器錯誤不會消耗月度配額。

覆蓋範圍

廖内是首个当前介接器。其他地區保留各自的歷史或驗證狀態。

使用 Narwhal API 密鑰即可獲得。