جميع واجهات API

واجهة API لأسعار السلع الفعلية

تابع زيت النخيل والفحم وأسعار التجزئة الأسبوعية للوقود في الولايات المتحدة والأسعار المرجعية الشهرية للسلع. تحتفظ كل سلسلة بسوقها ووحداتها المنشورة وفترة المشاهدة.

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"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
  "currency": "IDR",
  "unit": "kilogram",
  "period_start": "2026-08-26",
  "period_end": "2026-09-01",
  "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"
    }
  ]
}

نقاط النهاية

GETاكتشف سلاسل زيت النخيل./v1/commodities/palmoil/physical
GETافحص سلسلة زيت النخيل./v1/commodities/palmoil/physical/{series_id}
GETاسترجع قراءات زيت النخيل./v1/commodities/palmoil/physical/{series_id}/observations

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

حافظ على المعنى المحلي

يحتفظ كل من السعر المرجعي الحكومي وجدول أسعار المُنتِج وقيمة الوحدة في التجارة بتعريفه الخاص.

تتبّع التغييرات بمرور الوقت

اطّلع على قراءات السلسلة المحددة مع الحفاظ على الوحدات الأصلية والتواريخ التي يسري فيها كل سعر.

قارن أسعارًا ذات خصائص متطابقة: فالعملة والوحدة والدرجة والموقع ونوع السعر والفترة كلها مهمة. أسعار الوقود الأسبوعية هي متوسطات أسعار التجزئة. المصدر: إدارة معلومات الطاقة الأمريكية. تشمل الأسعار المرجعية الشهرية 70 سلسلة بسجل يعود إلى عام 1960. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0

استكشف الصفحات ذات الصلة

واجهة API لأسعار المعادن الفورية

احصل على الأسعار الفورية للذهب والفضة والبلاتين والبلاديوم، إضافةً إلى أسعار مرجعية لخام WTI وخام برنت والنحاس مشتقة من أسواق العقود الآجلة، وليست أسعارًا فورية لشحنات فعلية.

استكشف API ‏←

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

ما السلع المشمولة؟

تشمل التغطية زيت النخيل والفحم ومتوسطات أسعار التجزئة الأسبوعية للبنزين والديزل في الولايات المتحدة والأسعار المرجعية الشهرية للسلع. لكل سلسلة سوقها ووحدتها وتواريخ تغطيتها.

هل يمكنني دمج السلاسل في سعر واحد؟

استخدم تعريفات السلاسل أولًا. الأسعار ذات درجات الجودة أو الوحدات أو أسس التسليم أو فترات السريان المختلفة لا يمكن استخدام بعضها بدلًا من بعض.

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

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