歷史棕櫚油 FFB 價格 API

獲取 FFB 歷史價格表

端点與請求

REST 端點

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

契約請求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/oil-palm-ffb-price/observations?series_id=id-ri-oil-palm-ffb-smallholder-purchase-agreement&start=2026-08-01&end=2026-09-02&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

參數

名稱	必填	類型	含義
`series_id`	是	查詢·穩定的 Narwhal ID	通過實物序列發現返回的序列。
`start`	否	查詢·YYYY-MM-DD	包含下限。必須與 end 一起提供。
`end`	否	查詢·YYYY-MM-DD	不包含的上限，必須晚於 start。
`limit`	否	查詢·整數，1–500	最多返回的完整日程數量。預設為 100。
`cursor`	否	查詢·不透明字串	綁定到相同序列和日期範圍的續接令牌。

回應

契約示例

{
  "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",
  "observations": [
    {
      "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"
        }
      ]
    }
  ],
  "next_cursor": null
}

欄位	類型	必填	含義
`series_id / commodity / country / area`	字串	是	穩定的身份和實物市場範圍。
`producer_type / producer_arrangement`	字串或 null	是	生產者範圍由每個返回的時間表共享.
`price_basis / currency / unit`	字串	是	共享值含義和報價約定。
`observations`	陣列	是	按 effective_from 排序的完整價目表，最早的在前。
`next_cursor`	字串或 null	是	不透明的延續令牌，結束時為 null。

錯誤與配額

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

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

覆蓋範圍

歷史記錄僅包含已接受的完整價目表。這不代表每個區域或每個年份都完整覆蓋。

使用 Narwhal API 密鑰即可獲得。