جميع واجهات API

عناقيد ثمار نخيل الزيت الطازجة (FFB) السعر API

جداول FFB الإندونيسية الرسمية حسب المنطقة وعمر الشجرة

الطلب الأول

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/oil-palm-ffb-price?country=IDN&area=ID-RI" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا

{
  "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"
    }
  ]
}

نقاط النهاية

GETاكتشف سلاسل الأسعار الفعلية المعتمدة/v1/commodities/physical/{commodity}/{country}

مرجع API →

GETاقرأ أحدث جدول FFB كاملًا/v1/commodities/oil-palm-ffb-price

مرجع API →

GETاقرأ سجل الجداول من الأقدم إلى الأحدث/v1/commodities/oil-palm-ffb-price/observations

مرجع API →

المصادر والمنهجية

جدول كامل

يصل كل سعر لعمر شجرة معًا.

اقرأ المنهجية →

تواريخ حقيقية

يبقى تاريخ الإصدار وتاريخ السريان منفصلين.

لا توجد بيانات جزئية

تظل الجداول المفقودة أو الملتبسة خارجًا.

التغطية

عرض التغطية →

يحافظ Narwhal مع كل جدول على المنطقة والترتيب والتواريخ والوحدة ونطاقات أعمار الأشجار.

أسعار FFB ليست أسعار CPO

series_id: هوية ثابتة لمنطقة وترتيب منتج واحد.
effective_from / effective_to: التواريخ الشاملة التي يغطيها جدول واحد.
prices[]: نطاقات كاملة غير متداخلة لعمر الأشجار وأسعار بالسلاسل العشرية.
released_on / revision: تاريخ الإصدار الرسمي ومراجعة الجدول بأكمله.
price_basis / currency / unit: جدول الشراء الرسمي والروبية الإندونيسية والكيلوغرام.

أدلة المطورين

مرجع API →التغطية →FFB وCPO →

الأسئلة الشائعة

هل هذه واجهة API لأسعار CPO؟

لا. إنها تخدم جداول شراء عناقيد الثمار الطازجة الرسمية. وتتطلب معايير CPO والعقود الآجلة واجهات منفصلة.

لماذا توجد عدة أسعار في استجابة واحدة؟

قد تنشر جهة واحدة أسعارًا مختلفة حسب عمر الشجرة. ويحافظ Narwhal على هذه الصفوف مجتمعة.

أي منطقة تأتي أولًا؟

رياو هي أول محول حالي. وتحتفظ المناطق الأخرى بحالتها التاريخية أو حالة التحقق الخاصة بها.

أجرِ أول طلب لك

احصل على مفتاح API مجاني →