Historical Palmoil physical API

Get oldest-first Palmoil observations

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

نقطة نهاية REST

GET /v1/commodities/palmoil/physical/{series_id}/observations

طلب العقد

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical/id-ri-oil-palm-ffb-smallholder-purchase-agreement/observations?start=2026-08-01&end=2026-09-02&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

يستخدم MCP commodities_get_palmoil_physical_observationsتشترك REST وMCP في المخطط نفسه وحصة الحساب وفحص الحقوق وشكل المشكلة نفسه.

المعلمات

الاسم	مطلوب	النوع	المعنى
`series_id`	نعم	path · stable Narwhal ID	Series returned by discovery.
`start`	لا	الاستعلام · YYYY-MM-DD	حد أدنى شامل. يجب إرساله مع النهاية.
`end`	لا	الاستعلام · YYYY-MM-DD	حد أعلى حصري. يجب أن يكون لاحقًا للبداية.
`limit`	لا	الاستعلام · عدد صحيح, 1–500	الحد الأقصى للجداول الكاملة المعادة. الافتراضي 100.
`cursor`	لا	الاستعلام · سلسلة نصية غير قابلة للتفسير	رمز متابعة مرتبط بالسلسلة ونطاق التاريخ نفسيهما.

الاستجابة

مثال على العقد

{
  "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_type": "official_purchase_schedule",
  "observation_type": "age_schedule",
  "period_type": "effective",
  "currency": "IDR",
  "unit": "kilogram",
  "observations": [
    {
      "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"
        }
      ]
    }
  ],
  "next_cursor": null
}

حقل	النوع	مطلوب	المعنى
`series_id / commodity / country / area`	سلاسل نصية	نعم	الهوية الثابتة ونطاق السوق المادية.
`producer_type / producer_arrangement`	سلاسل نصية أو قيمة فارغة	نعم	نطاق المنتج المشترك بين كل جدول مُعاد.
`price_type / observation_type / period_type`	سلاسل نصية	نعم	Shared typed value meaning and period convention.
`observations`	مصفوفة	نعم	Scalar or complete schedules ordered oldest first.
`next_cursor`	سلسلة نصية أو قيمة فارغة	نعم	رمز متابعة غير شفاف، أو قيمة فارغة في النهاية.

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

400 invalid_query — الرمز أو المنطقة أو نطاق التاريخ أو الحد أو المحدد غير صالح.
400 invalid_cursor — المؤشر غير صالح أو لا يطابق السلسلة والنطاق.
401 invalid_api_key — مفتاح Bearer مفقود أو مرفوض.
404 palmoil_series_not_found — لا توجد بيانات معتمدة كاملة تطابق الطلب.
429 rate_limit_exceeded أو quota_exhausted — استُنفدت الحصة المشتركة.
503 physical_price_unavailable — لا يستطيع إصدار كامل تلبية الواجهة بأمان.

لا تستهلك الطلبات المرفوضة وأخطاء الخادم الحصة الشهرية.

التغطية

History includes accepted revisions only and makes no promise for Malaysia or every Indonesian area.

متاح باستخدام مفتاح Narwhal API.