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

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

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

curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP" \  -H "Authorization: Bearer YOUR_API_KEY"

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

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

curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30" \  -H "Authorization: Bearer YOUR_API_KEY"

نزّل CSV أو Parquet

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

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" \  -H "Authorization: Bearer YOUR_API_KEY" \  --output usd-rates-2024.csv

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

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

source, is_forward_filled, derived_symbols

السلاسل خلال اليوم والتغطية

يدعم /v1/timeseries الفواصل 1m و5m و15m و1h و4h، والبيانات المرجعية اليومية 1d. لا يدعم 2h. تقاطعات SGD التي لا تشمل USD غير متاحة عند 4h، لكن USD/SGD والاتجاه العكسي متاحان. بدأ جمع بيانات السوق في 2026-09-14. تُحفظ بيانات 1m لمدة 30 يومًا، ولا يوجد حذف مجدول للفواصل الأكبر. مدة الاحتفاظ لا تعني توفر تاريخ كامل بهذه المدة. تغطي الفواصل خلال اليوم من 1m إلى 1h عدد 221 زوجًا فريدًا: 143 زوجًا مع USD و78 زوجًا متقاطعًا.

تتطلب التقاطعات التاريخية مشاهدات إغلاق فعلية ضمن الفترة نفسها بتوقيت UTC، بفارق لا يتجاوز 5 ثوانٍ. يستخدم effective_at وقت المشاهدة الأقدم. لا تُملأ الفجوات، وقد تتغير الفترة المفتوحة. يستخدم 1d البيانات المرجعية اليومية لجميع عملات الكتالوج. يُحسب كل زوج مرة واحدة في الجدول، مع دعم الاتجاهين.

curl "https://api.exchangerate.dev/v1/timeseries?base=EUR&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T13:00:00Z" \  -H "Authorization: Bearer YOUR_API_KEY"

الفترة المدعومة التي لا تحتوي على مشاهدات تعيد HTTP 200 مع data: [] وhas_more: false وnext_cursor: null. الفاصل غير المعروف يعيد unsupported_interval، والزوج خارج التغطية يعيد unsupported_pair_interval وrejected_pairs مع HTTP 400. يُرفض الطلب المختلط بالكامل.

تفاصيل التغطية والحدود

واجهة أسعار الصرف خلال اليوم