سعر النفط للتر والغالون
حوّل برنت أو WTI من دولارات للبرميل إلى لترات وغالونات.
اقرأ الدليل ←أسعار المعادن الفورية والسلع الفعلية بوحداتها الأصلية وتعريفات سلاسلها.
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/palmoil/physical?product=ffb&country=IDN" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"series": [
{
"series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
"product": "ffb",
"observation_type": "age_schedule",
"period_type": "effective",
"country": "IDN",
"area": "ID-RI",
"producer_arrangement": "purchase_agreement",
"price_type": "official_purchase_schedule",
"currency": "IDR",
"unit": "kilogram",
"unit_key": "kilogram",
"coverage_start": "2026-08-19",
"coverage_end": "2026-09-01",
"frequency": "weekly"
}
],
"next_cursor": null
}/v1/commodities/spot/{commodity}/{currency}احصل على سعر فوري أو سعر مرجعي مشتق من العقود الآجلة.
commodityمطلوبXAU وXAG وXPT وXPD وWTI (خام WTI) وBRENT (خام برنت) أو XCU (النحاس).
currencyمطلوبعملة التسعير بالأحرف الكبيرة. للذهب 31 عملة، وتُسعَّر البقية بالدولار الأمريكي فقط.
symbolسلسلة نصيةالسلعة وعملة التسعير، مثل XAU-USD.
currencyسلسلة نصيةعملة التسعير.
unitسلسلة نصيةtroy_ounce للمعادن الثمينة، وbarrel لـ WTI وBRENT، وpound لـ XCU.
priceسلسلة نصيةسعر إرشادي واحد موجب بصيغة سلسلة نصية لعدد عشري.
timestampتاريخ ووقتوقت السعر بتوقيت UTC.
staleمنطقيهل السعر قديم. السوق المغلق لا يجعل السعر قديمًا أبدًا.
/v1/commodities/spot/{commodity}/{currency}/barsأشرطة الافتتاح والأعلى والأدنى والإغلاق للذهب والفضة والبلاتين والبلاديوم والنحاس وWTI وBRENT.
commodityمطلوبXAU وXAG وXPT وXPD وWTI (خام WTI) وBRENT (خام برنت) أو XCU (النحاس).
currencyمطلوبعملة التسعير بالأحرف الكبيرة. للذهب 31 عملة، وتُسعَّر البقية بالدولار الأمريكي فقط.
intervalاختياري1m أو 5m أو 15m أو 1h أو 4h أو 1d. القيمة الافتراضية 1d.
startمطلوبالشريط الأول، بتوقيت UTC عند حدّ فاصل زمني. شاملة.
endمطلوبالشريط الأخير، بتوقيت UTC عند حدّ فاصل زمني. غير شاملة.
limitاختياريعدد الأشرطة في الصفحة. القيمة الافتراضية 100 والحد الأقصى 500.
cursorاختياريأعد استخدام next_cursor من الصفحة السابقة مع الاستعلام نفسه.
barsمصفوفةأشرطة مغلقة من الأقدم إلى الأحدث، ولكل منها طابع زمني وسعر الافتتاح والأعلى والأدنى والإغلاق كنصوص عشرية. الذهب بعملات غير USD له سعر الإغلاق فقط.
next_cursorسلسلة نصيةالمؤشر للصفحة التالية. يكون Null عندما لا تبقى أشرطة.
/v1/commodities/palmoil/physicalابحث عن سلاسل زيت النخيل المادية المعتمدة حسب المنتج والدولة.
productاختياريالتصفية حسب المنتج الفعلي.
countryاختياريالتصفية حسب البلد، مثل IDN.
areaاختيارياستخدم معرّف منطقة تعيده واجهة الاكتشاف: ISO 3166-2 حيث ينطبق، أو معرّف nwl-* يحدده Narwhal مثل nwl-mys-north.
price_typeاختياريofficial_purchase_schedule أو government_reference أو market_average. يجب أن تتوافق القيمة مع المنتج.
currencyاختياريالتصفية حسب العملة الأصلية، مثل IDR أو USD أو MYR. لا يؤدي ذلك إلى تحويل الأسعار.
producer_typeاختياريينطبق على جداول شراء FFB الإندونيسية، ولا يُقبل مع product=cpo.
producer_arrangementاختياريpurchase_agreement أو supported_scheme. ينطبق على جداول FFB الإندونيسية، ولا يُقبل مع product=cpo.
limitاختياريالحد الأقصى لعدد السلاسل في الصفحة. القيمة الافتراضية 100.
cursorاختياريتابع باستخدام next_cursor المعاد، مع إبقاء كل المرشحات الأصلية وlimit دون تغيير.
seriesمصفوفةسلاسل كاملة معتمدة مرتبة حسب series_id الثابت.
series[].series_idسلسلة نصيةالهوية الثابتة المستخدمة في عملية السجل التاريخي.
series[].product / series[].countryسلاسل نصيةنطاق المنتج والنطاق الجغرافي.
series[].areaسلسلة نصيةتُحذف area في السلاسل الوطنية. قد تستخدم المعرّفات الإقليمية نطاق الأسماء nwl-*.
series[].observation_type / series[].period_typeالتعداداتscalar أو age_schedule؛ وeffective أو observation. تحدد هذه القيم شكل الاستجابة ومعنى التواريخ.
series[].price_type / series[].currency / series[].unitسلاسل نصيةنوع السعر الذي يحدده المصدر، والعملة، والوحدة الأصلية.
series[].unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
series[].producer_arrangementسلسلة نصيةيظهر فقط في سلاسل جداول أسعار FFB الإندونيسية حسب عمر النخيل عندما يحدد المصدر ترتيبًا. ويُحذف في غير ذلك.
series[].frequency / series[].coverage_start / series[].coverage_endسلسلة نصية وتواريخوتيرة النشر وحدود البيانات التاريخية المقبولة، دون ضمان خلو الفترة من الفجوات.
next_cursorسلسلة نصية أو nullرمز لمتابعة الصفحات، أو null إذا لم توجد سلاسل أخرى.
/v1/commodities/palmoil/physical/{series_id}احصل على أحدث قراءة معتمدة لزيت النخيل.
series_idمطلوباستخدم معرّفًا تعيده واجهة الاكتشاف.
price_monthاختياريخاص بـMPOB CPO. يحدد شهرًا واحدًا للأسعار؛ ويستخدم افتراضيًا الشهر الذي ينتمي إليه كل تقرير.
series_idسلسلة نصيةمعرّف ثابت لسلسلة الأسعار الفعلية.
currency / unitسلاسل نصيةالعملة والوحدة الأصلية: kilogram لجداول FFB الإندونيسية، وmetric_ton لأسعار CPO، وone_percent_oer لمراجع FFB الماليزية.
unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
period_start / period_endالتواريختشمل فترات سريان الأسعار يومي البداية والنهاية. أما MPOB فيستخدم فترة تبدأ بيوم التقرير وتنتهي في اليوم التالي، دون أن تشمل ذلك اليوم التالي.
revisionعدد صحيحرقم مراجعة السعر أو جدول الأسعار الكامل.
price or pricesسلسلة نصية عشرية أو مصفوفة كاملةسعر موجب بصيغة سلسلة نصية عشرية، أو مصفوفة prices كاملة تضم tree_age_min_years وtree_age_max_years وprice. يشمل نطاق العمر الحدين الأدنى والأقصى. وتبقى وحدة FFB الماليزي هي one_percent_oer.
price_monthYYYY-MMمطلوب لأسعار MPOB CPO ويحدد شهر السعر. ويحدد period_start وperiod_end فترة القراءة الخاصة بيوم التقرير.
/v1/commodities/palmoil/physical/{series_id}/observationsاحصل على قراءات زيت النخيل بدءًا من الأقدم.
series_idمطلوبالسلسلة التي تعيدها واجهة الاكتشاف.
startاختياريبداية نطاق البحث، مع شمول هذا اليوم. يجب تقديمها مع end. تُدرج فترات السريان الإندونيسية إذا تداخلت مع النطاق، وتُختار الأسعار اليومية الماليزية حسب تاريخ التقرير.
endاختياريحد أعلى غير مشمول. يجب أن يكون لاحقًا لـstart.
limitاختياريالحد الأقصى لعدد القراءات المعادة. القيمة الافتراضية 100، وتبقى جداول الأعمار كاملة.
cursorاختياريتابع دون تغيير أي من المعلمات الأصلية، بما فيها series_id والتواريخ وlimit وprice_month. قد يؤدي تغيير البيانات المنشورة إلى انتهاء صلاحية المؤشر.
price_monthاختياريخاص بـMPOB CPO. يحدد شهرًا واحدًا للأسعار؛ ويستخدم افتراضيًا الشهر الذي ينتمي إليه كل تقرير.
series_idسلسلة نصيةمعرّف ثابت لسلسلة الأسعار الفعلية.
currency / unitسلاسل نصيةالعملة والوحدة الأصلية المشتركتان بين جميع القراءات.
unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
observationsمصفوفةالفترة ورقم المراجعة والقيمة السعرية المفردة أو جدول الأسعار الكامل، مرتبة من الأقدم إلى الأحدث. تحتفظ صفوف MPOB CPO بالحقل price_month، وصفوف CPO وFFB الماليزية بالفترة period_start/period_end الخاصة بيوم التقرير.
next_cursorسلسلة نصية أو nullرمز متابعة غير قابل للتفسير، أو null في النهاية.
حوّل برنت أو WTI من دولارات للبرميل إلى لترات وغالونات.
اقرأ الدليل ←حوّل النحاس من دولارات للرطل إلى كيلوغرامات وأطنان متريّة.
اقرأ الدليل ←اقسم الذهب على الفضة لتواريخ أو أوقات متطابقة.
اقرأ الدليل ←أرسل تنبيهًا عندما يتجاوز الذهب الحد الذي تحدده.
اقرأ الدليل ←نزّل سجل سعر الذهب اليومي في ملف CSV.
اقرأ الدليل ←احصل على سعر سلعة بعملتك، مثل الروبية للغرام.
اقرأ الدليل ←أسعار الذهب والفضة والبلاتين والبلاديوم الفورية، إضافة إلى أسعار WTI وبرنت والنحاس المرجعية.
استكشف API ←زيت النخيل وأسعار النفط والغاز اليومية وأسعار الوقود الأسبوعية للتجزئة في أمريكا والمؤشرات السلعية الشهرية، بالوحدات كما نُشرت.
استكشف API ←أسعار الصرف الحالية وتحويل العملات وسجل الأسعار المخزَّن.
استكشف API ←البدء مجاني. رصيد مجاني بقيمة 10 دولارات كل شهر، ثم 2 دولار لكل 1,000 استدعاء.
عرض الأسعار ←يغطي الإصدار المتاح حاليًا المعادن الفورية والسلع الفعلية. العقود الآجلة غير متاحة للعامة.
نعم. اطلب قراءات لسلسلة زيت نخيل مقبولة؛ وتحافظ الاستجابة على الوحدات الأصلية وتواريخ السريان والمراجعات والفجوات في بيانات المصدر.
تبقى الوحدات وأنواع الأسعار والجغرافيا والفترات السارية مرتبطة بكل سلسلة معتمدة. منتجات العقود الآجلة غير متاحة للعموم حاليًا.
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.