واجهة API لأسعار Palmoil FFB التاريخية

نقطة النهاية والطلب

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": "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
}

الأخطاء والحصة

• 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.