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`	سلاسل نصية أو قيمة فارغة	نعم	Palmoil product and exact geographic scope.
`producer_type / producer_arrangement`	سلاسل نصية أو قيمة فارغة	نعم	نطاق المنتج الذي يستخدمه الجدول الرسمي.
`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.