棕榈油鲜果串（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 密钥即可获得。