الأسعار بعملتك
حوّل سعر سلعة إلى عملتك باستخدام سعر صرف.
اقرأ الدليل ←جميع واجهات API
واجهة أسعار السلع التاريخية API
A commodity prices API for 70 monthly series from the World Bank Pink Sheet. Read copper price history, fertilizer prices and agricultural benchmarks in USD, with units as published. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
الطلب الأول
ابحث عن سلاسل المعادن
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/physical/series?category=metals" \
--header "Authorization: Bearer $NARWHAL_API_KEY"استجابة نموذجية
{
"series": [
{
"series_id": "worldbank-cmo-copper",
"commodity": "copper",
"commodity_key": "copper",
"category": "metals",
"product": "copper",
"country": "WLD",
"price_type": "international_benchmark",
"basis": "settlement price",
"currency": "USD",
"unit": "metric_ton",
"unit_key": "tonne",
"unit_quantity": "1",
"frequency": "monthly",
"description": "Grade A copper, minimum 99.9935% purity, cathodes and wire bar shapes, exchange settlement price.",
"attribution": "The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0",
"coverage_start": "1960-01-01",
"coverage_end": "2026-09-30"
}
]
}نقاط النهاية
GETاكتشاف سلاسل الأسعار الفعلية/v1/commodities/physical/series
اكتشف أسعار الوقود الأسبوعية بالتجزئة في الولايات المتحدة، وأسعار النفط والغاز الفورية اليومية، والمؤشرات المرجعية الشهرية للسلع.
المعلمات
commodityاختياريصفِّ حسب السلعة، مثل gasoline أو diesel أو copper أو urea أو rice أو crude-oil أو coffee. استخدم قيمة commodity التي يعيدها الاكتشاف.
categoryاختياريالفئات المشمولة هي softs وoils-oilseeds وmetals وgrains وenergy وfertilizers وforestry وlivestock-dairy. تستخدم سلاسل الوقود energy.
countryاختيارياستخدم WLD للأسعار المرجعية العالمية أو EUU للاتحاد الأوروبي. رموز البلدان المشمولة هي USA وTHA وJPN وAUS وZAF وMYS وCMR وVNM وMEX وLKA وIND وKEN. يستخدم الوقود الأمريكي USA.
price_typeاختيارييستخدم الوقود retail_average. تستخدم سلاسل EIA الفورية اليومية وسلاسل World Bank القيمة international_benchmark، باستثناء التبغ الذي يستخدم import_unit_value.
currencyاختياريصفِّ حسب عملة التسعير. يستخدم كلا المصدرين USD حاليًا.
limitاختياريالحد الأقصى للعناصر في كل صفحة. القيمة الافتراضية 100.
cursorاختيارياستخدم next_cursor من الصفحة السابقة مع عوامل التصفية نفسها وlimit نفسه. تعني null عدم وجود صفحات أخرى.
حقول الاستجابة
seriesمصفوفةسلاسل تتضمن commodity وproduct وcountry وarea وأساس السعر basis وcurrency وunit وfrequency وattribution وتواريخ التغطية. تعني المصفوفة الفارغة عدم وجود سلسلة مطابقة.
series[].series_idسلسلة نصيةمعرّف ثابت يعيده اكتشاف السلاسل.
series[].currencyسلسلة نصيةعملة التسعير. تستخدم سلاسل الوقود الأمريكي والأسعار المرجعية الشهرية USD.
series[].unit / series[].unit_quantityسلاسل نصيةالوحدة المنشورة والكمية التي يُحسب السعر على أساسها. يستخدم الوقود us_gallon. تستخدم الأسعار المرجعية الشهرية metric_ton أو kilogram أو barrel أو cubic_meter أو troy_ounce أو mmbtu أو dry_metric_ton_unit أو sheet. الكمية هي 1، باستثناء الخشب الرقائقي الذي يستخدم USD لكل 100 لوح. لا تُحوّل القيم.
series[].unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
series[].attributionسلسلة نصيةاحتفظ بنسب البيانات إلى مصدرها الوارد في الاستجابة مع البيانات. المصدر: إدارة معلومات الطاقة الأمريكية. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
series[].commodity / series[].category / series[].productسلاسل نصيةتعريف السلعة والفئة والمنتج. تشمل الأمثلة gasoline / energy / regular-gasoline وcopper / metals / copper. يعيد الاكتشاف القيم الخاصة بكل سلسلة.
series[].commodity_keyسلسلة نصيةيسمّي commodity_key السلعة بالطريقة نفسها في الأسعار الفورية والآجلة وأسعار التوقعات والأسعار الفعلية، مثل gold أو crude-oil. ويحمل النفط الخام أيضاً benchmark (القيمة wti أو brent أو urals أو dubai)، وتحمل العقود الآجلة exchange_mic، وهو الرمز القياسي للبورصة.
series[].areaسلسلة نصيةيحدد area النطاق الإقليمي ويُحذف في السلاسل الوطنية.
series[].countryسلسلة نصيةيعني WLD معيارًا عالميًا. يعني EUU الاتحاد الأوروبي. تستخدم البلدان رموز ISO alpha-3. يستخدم الوقود الأمريكي الرمز USA للمتوسط الوطني.
series[].price_typeسلسلة نصيةيستخدم الوقود retail_average. تستخدم سلاسل EIA الفورية اليومية والسلاسل الشهرية international_benchmark، باستثناء التبغ الذي يستخدم import_unit_value.
series[].basisسلسلة نصيةيصف basis تعريف السعر ويُحذف عندما لا يقدمه المصدر.
المرجع الكامل ←
GETالحصول على تفاصيل سلسلة أسعار فعلية/v1/commodities/physical/series/{series_id}
اقرأ تعريف سلسلة واحدة من سلاسل الوقود الأسبوعية أو المؤشرات المرجعية الشهرية ووحداتها وتغطيتها.
المعلمات
series_idمطلوباستخدم معرّفًا ثابتًا يعيده الاكتشاف، مثل fuel-eia-usa-regular-gasoline أو worldbank-cmo-copper.
حقول الاستجابة
series_idسلسلة نصيةمعرّف ثابت يعيده اكتشاف السلاسل.
currencyسلسلة نصيةعملة التسعير. تستخدم سلاسل الوقود الأمريكي والأسعار المرجعية الشهرية USD.
unit / unit_quantityسلاسل نصيةالوحدة المنشورة والكمية التي يُحسب السعر على أساسها. يستخدم الوقود us_gallon. تستخدم الأسعار المرجعية الشهرية metric_ton أو kilogram أو barrel أو cubic_meter أو troy_ounce أو mmbtu أو dry_metric_ton_unit أو sheet. الكمية هي 1، باستثناء الخشب الرقائقي الذي يستخدم USD لكل 100 لوح. لا تُحوّل القيم.
unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
attributionسلسلة نصيةاحتفظ بنسب البيانات إلى مصدرها الوارد في الاستجابة مع البيانات. المصدر: إدارة معلومات الطاقة الأمريكية. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
commodity / category / productسلاسل نصيةتعريف السلعة والفئة والمنتج. تشمل الأمثلة gasoline / energy / regular-gasoline وcopper / metals / copper. يعيد الاكتشاف القيم الخاصة بكل سلسلة.
commodity_keyسلسلة نصيةيسمّي commodity_key السلعة بالطريقة نفسها في الأسعار الفورية والآجلة وأسعار التوقعات والأسعار الفعلية، مثل gold أو crude-oil. ويحمل النفط الخام أيضاً benchmark (القيمة wti أو brent أو urals أو dubai)، وتحمل العقود الآجلة exchange_mic، وهو الرمز القياسي للبورصة.
areaسلسلة نصيةيحدد area النطاق الإقليمي ويُحذف في السلاسل الوطنية.
countryسلسلة نصيةيعني WLD معيارًا عالميًا. يعني EUU الاتحاد الأوروبي. تستخدم البلدان رموز ISO alpha-3. يستخدم الوقود الأمريكي الرمز USA للمتوسط الوطني.
price_typeسلسلة نصيةيستخدم الوقود retail_average. تستخدم سلاسل EIA الفورية اليومية والسلاسل الشهرية international_benchmark، باستثناء التبغ الذي يستخدم import_unit_value.
basisسلسلة نصيةيصف basis تعريف السعر ويُحذف عندما لا يقدمه المصدر.
frequencyسلسلة نصيةيوميًا لأسعار EIA الفورية للنفط والغاز، وأسبوعيًا للوقود الأمريكي، وشهريًا للأسعار المرجعية من World Bank.
المرجع الكامل ←
GETالحصول على أحدث سعر فعلي/v1/commodities/physical/series/{series_id}/latest
اقرأ أحدث سعر متاح للوقود الأسبوعي أو للمؤشر المرجعي الشهري مع فترة الرصد.
المعلمات
series_idمطلوباستخدم معرّفًا ثابتًا يعيده الاكتشاف، مثل fuel-eia-usa-regular-gasoline أو worldbank-cmo-copper.
حقول الاستجابة
series_idسلسلة نصيةمعرّف ثابت يعيده اكتشاف السلاسل.
currencyسلسلة نصيةعملة التسعير. تستخدم سلاسل الوقود الأمريكي والأسعار المرجعية الشهرية USD.
unit / unit_quantityسلاسل نصيةالوحدة المنشورة والكمية التي يُحسب السعر على أساسها. يستخدم الوقود us_gallon. تستخدم الأسعار المرجعية الشهرية metric_ton أو kilogram أو barrel أو cubic_meter أو troy_ounce أو mmbtu أو dry_metric_ton_unit أو sheet. الكمية هي 1، باستثناء الخشب الرقائقي الذي يستخدم USD لكل 100 لوح. لا تُحوّل القيم.
unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
attributionسلسلة نصيةاحتفظ بنسب البيانات إلى مصدرها الوارد في الاستجابة مع البيانات. المصدر: إدارة معلومات الطاقة الأمريكية. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
period_start / period_endالتواريختواريخ المشاهدة شاملة البداية والنهاية. يستخدم الوقود تاريخ مسح يوم الاثنين لكليهما. تمتد المشاهدة الشهرية على الشهر بأكمله، مثل 2026-09-01 إلى 2026-09-30.
priceسلسلة نصية لعدد عشريالسعر المنشور بعملة السلسلة لكل عدد من الوحدات تحدده unit_quantity. اقرأه مع نوع سعر السلسلة وbasis.
published_onالتاريختاريخ النشر. يُحذف عندما لا يقدمه المصدر.
revisionعدد صحيحيبدأ من 1 ويزداد عندما يغيّر إصدار لاحق القيمة الخاصة بتلك الفترة.
المرجع الكامل ←
GETالحصول على سجل الأسعار الفعلية/v1/commodities/physical/series/{series_id}/observations
اقرأ تاريخ أسعار الوقود الأسبوعية أو السلع الشهرية مع الفترات والوحدات المنشورة والمراجعات.
المعلمات
series_idمطلوباستخدم معرّفًا ثابتًا يعيده الاكتشاف، مثل fuel-eia-usa-regular-gasoline أو worldbank-cmo-copper.
startاختياريتاريخ بداية مشمول. قدّم start وend معًا، أو احذفهما معًا.
endاختياريتاريخ نهاية غير مشمول، ويجب أن يكون لاحقًا لـ start. تُعاد المشاهدات التي تتداخل مع نطاق التواريخ.
limitاختياريالحد الأقصى للعناصر في كل صفحة. القيمة الافتراضية 100.
cursorاختيارياستخدم next_cursor من الصفحة السابقة مع عوامل التصفية نفسها وlimit نفسه. تعني null عدم وجود صفحات أخرى.
حقول الاستجابة
series_idسلسلة نصيةمعرّف ثابت يعيده اكتشاف السلاسل.
currencyسلسلة نصيةعملة التسعير. تستخدم سلاسل الوقود الأمريكي والأسعار المرجعية الشهرية USD.
unit / unit_quantityسلاسل نصيةالوحدة المنشورة والكمية التي يُحسب السعر على أساسها. يستخدم الوقود us_gallon. تستخدم الأسعار المرجعية الشهرية metric_ton أو kilogram أو barrel أو cubic_meter أو troy_ounce أو mmbtu أو dry_metric_ton_unit أو sheet. الكمية هي 1، باستثناء الخشب الرقائقي الذي يستخدم USD لكل 100 لوح. لا تُحوّل القيم.
unit_keyسلسلة نصيةunit_key هي الوحدة بصيغة كتابة قياسية واحدة، مثل troy_ounce أو barrel أو tonne؛ أما unit فتحتفظ بصياغة المصدر. عندما يُعرض السعر بالسنتات تكون price_scale تساوي 0.01: اضرب السعر فيها لتحصل على المبلغ بالعملة.
attributionسلسلة نصيةاحتفظ بنسب البيانات إلى مصدرها الوارد في الاستجابة مع البيانات. المصدر: إدارة معلومات الطاقة الأمريكية. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
observationsمصفوفةمشاهدات مرتبة من الأقدم إلى الأحدث. تتضمن كل منها period_start وperiod_end وprice كسلسلة نصية عشرية وrevision. الحقل published_on اختياري.
observations[].period_start / observations[].period_endالتواريختواريخ المشاهدة شاملة البداية والنهاية. يستخدم الوقود تاريخ مسح يوم الاثنين لكليهما. تمتد المشاهدة الشهرية على الشهر بأكمله، مثل 2026-09-01 إلى 2026-09-30.
observations[].priceسلسلة نصية لعدد عشريالسعر المنشور بعملة السلسلة لكل عدد من الوحدات تحدده unit_quantity. اقرأه مع نوع سعر السلسلة وbasis.
observations[].published_onالتاريختاريخ النشر. يُحذف عندما لا يقدمه المصدر.
observations[].revisionعدد صحيحيبدأ من 1 ويزداد عندما يغيّر إصدار لاحق القيمة الخاصة بتلك الفترة.
next_cursorسلسلة نصية أو nullرمز متابعة لا يلزم تفسير بنيته الداخلية. تشير null إلى الصفحة الأخيرة.
المرجع الكامل ←
حالات الاستخدام
استرجع تاريخاً كاملاً
اقرأ كل السجل صفحة بصفحة واحفظه في ملف واستأنف إذا توقف.
اقرأ الدليل ←سحب يومي للبيانات
شغّل سكربتًا صغيرًا مرة في اليوم وأضف النتيجة إلى ملف CSV.
اقرأ الدليل ←التغطية
المصادر
واجهات API ذات صلة
واجهة أسعار الوقود الأمريكية API
أسعار البنزين والديزل الأسبوعية في أمريكا بالدولار للغالون الأمريكي.
استكشف API ←API لأسعار زيت النخيل
أسعار زيت النخيل الخام وعناقيد الثمار الطازجة من إندونيسيا وماليزيا.
استكشف API ←واجهة API لأسعار السلع الفعلية
زيت النخيل وأسعار النفط والغاز اليومية وأسعار الوقود الأسبوعية للتجزئة في أمريكا والمؤشرات السلعية الشهرية، بالوحدات كما نُشرت.
استكشف API ←واجهة API لأسعار المعادن الفورية
أسعار الذهب والفضة والبلاتين والبلاديوم الفورية، إضافة إلى أسعار WTI وبرنت والنحاس المرجعية.
استكشف API ←الأسعار
رصيد مجاني بقيمة 10 دولارات شهريًا، ثم ابتداءً من 2 دولار لكل 1,000 استدعاء.
عرض الأسعار ←الأسئلة الشائعة
كيف أحصل على تاريخ أسعار النحاس؟
استخدم worldbank-cmo-copper مع نقطة نهاية observations. مرّر start وend معاً لتحديد نافذة تواريخ. أسعار النحاس شهرية وهي نصوص عشرية بالدولار الأمريكي USD لكل طن متري.
هل تشمل واجهة API للسلع هذه أسعار الأسمدة وأسعار الأرز؟
نعم. استخدم category=fertilizers لأسعار الأسمدة، أو commodity=urea لسلسلة سعر اليوريا، أو commodity=rice لمعايير أسعار الأرز. يعيد الاكتشاف معرّفات السلاسل لأحدث الأسعار والتاريخ.
إلى أي مدى يعود التاريخ؟
تبدأ أقدم السلاسل الشهرية في يناير 1960. وتبدأ غيرها لاحقاً، وبعضها انتهى. اقرأ coverage_start وcoverage_end لكل سلسلة.
ما الوحدات والترخيص المطبَّقان؟
All prices use USD and the published unit and quantity. No unit conversion is applied. Keep the attribution with the data, which is licensed under CC BY 4.0. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
ما الذي يجب أن أتحقق منه قبل استخدام البيانات؟
A new month is added after each monthly publication. Individual series can lag or have ended. Barley and sorghum end in August 2020; Mexican shrimp ends in October 2023. Check coverage_end before treating a value as current. Most series use WLD for a world benchmark. Others identify a country or the European Union. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.