واجهة أسعار Palmoil 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	مصطلحات المنتجين العالمية. يقبل العقد الأول صغار المزارعين فقط.
`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`	سلاسل نصية أو قيمة فارغة	نعم	نطاق المنتج الذي يستخدمه الجدول الرسمي.
`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.