التوثيق /

أسعار الصرف التاريخية

استخدم التاريخ في المسار ليوم واحد أو `/v1/range` لسلسلة يومية. تبدأ البيانات المنشورة من 1999-01-04.

اطلب تاريخًا واحدًا

في عطلة نهاية الأسبوع أو إغلاق السوق، تعيد endpoint آخر fixing منشور وتضبط `is_forward_filled` إلى true. لا تُنشئ مشاهدة وهمية.

bash · one date
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP"

اطلب نطاقًا زمنيًا

أرسل `symbols` و`start_date` و`end_date`. يعيد JSON حتى 366 صفًا في الصفحة؛ مرّر `next_cursor` عندما تكون `has_more` true.

bash · date range
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30"

نزّل CSV أو Parquet

أضف `format=csv` أو `format=parquet`. يحتوي الملف كامل النطاق المطلوب ولا يستخدم مؤشر JSON.

bash · CSV
curl -L "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-12-31&format=csv"   --output usd-rates-2024.csv

احفظ المصدر مع الأرقام

احتفظ بـ`source` و`is_forward_filled` و`derived_symbols` مع كل مشاهدة كي تستطيع تفسيرها لاحقًا.

source · is_forward_filled · derived_symbols