Palmoil physical price API

Get the latest accepted Palmoil observation

端点與請求

REST 端點

GET /v1/commodities/palmoil/physical/{series_id}

契約請求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical/id-ri-oil-palm-ffb-smallholder-purchase-agreement" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

參數

名稱	必填	類型	含義
`series_id`	是	path · stable Narwhal ID	Use an ID returned by discovery.

回應

契約示例

{
  "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
  "commodity": "palmoil",
  "product": "ffb",
  "country": "IDN",
  "area": "ID-RI",
  "producer_type": "smallholder",
  "producer_arrangement": "purchase_agreement",
  "price_type": "official_purchase_schedule",
  "observation_type": "age_schedule",
  "period_type": "effective",
  "currency": "IDR",
  "unit": "kilogram",
  "period_start": "2026-08-26",
  "period_end": "2026-09-01",
  "published_on": "2026-08-26",
  "revision": 1,
  "prices": [
    {
      "tree_age_min_years": 3,
      "tree_age_max_years": 3,
      "price": "2998.31"
    },
    {
      "tree_age_min_years": 4,
      "tree_age_max_years": 4,
      "price": "3347.20"
    },
    {
      "tree_age_min_years": 5,
      "tree_age_max_years": 5,
      "price": "3595.38"
    },
    {
      "tree_age_min_years": 6,
      "tree_age_max_years": 6,
      "price": "3734.94"
    },
    {
      "tree_age_min_years": 7,
      "tree_age_max_years": 7,
      "price": "3818.86"
    },
    {
      "tree_age_min_years": 8,
      "tree_age_max_years": 8,
      "price": "3865.46"
    },
    {
      "tree_age_min_years": 9,
      "tree_age_max_years": 9,
      "price": "3878.72"
    },
    {
      "tree_age_min_years": 10,
      "tree_age_max_years": 20,
      "price": "3836.93"
    },
    {
      "tree_age_min_years": 21,
      "tree_age_max_years": 21,
      "price": "3770.94"
    },
    {
      "tree_age_min_years": 22,
      "tree_age_max_years": 22,
      "price": "3695.31"
    },
    {
      "tree_age_min_years": 23,
      "tree_age_max_years": 23,
      "price": "3609.33"
    },
    {
      "tree_age_min_years": 24,
      "tree_age_max_years": 24,
      "price": "3544.29"
    },
    {
      "tree_age_min_years": 25,
      "tree_age_max_years": 25,
      "price": "3490.84"
    },
    {
      "tree_age_min_years": 26,
      "tree_age_max_years": 26,
      "price": "3471.62"
    },
    {
      "tree_age_min_years": 27,
      "tree_age_max_years": 27,
      "price": "3441.82"
    },
    {
      "tree_age_min_years": 28,
      "tree_age_max_years": 28,
      "price": "3385.41"
    },
    {
      "tree_age_min_years": 29,
      "tree_age_max_years": 29,
      "price": "3344.02"
    },
    {
      "tree_age_min_years": 30,
      "tree_age_max_years": 30,
      "price": "3249.41"
    }
  ]
}

欄位	類型	必填	含義
`series_id`	字串	是	穩定的實物序列身份。
`commodity / product / country / area`	字串或 null	是	Palmoil product and exact geographic scope.
`producer_type / producer_arrangement`	字串或 null	是	官方時間表所使用的生產者範圍。
`price_type / observation_type / period_type`	字串	是	Typed meaning of the value and its period.
`period_start / period_end / published_on`	dates or null	是	Inclusive period and optional publication date.
`revision`	整數	是	整張價格表的修訂版本號。
`price or prices`	decimal string or complete array	是	Scalar value or complete non-overlapping tree-age bands.

錯誤與配額

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

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

覆蓋範圍

Riau is the first current admitted series. Malaysian sources are not yet admitted.

使用 Narwhal API 密鑰即可獲得。