جرّب مشاهدة USD/JPY بفاصل 15 دقيقة
curl "https://api.exchangerate.dev/v1/timeseries?base=USD&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T12:00:00Z" -H "Authorization: Bearer YOUR_API_KEY"{ "result": "success", "base": "USD", "symbols": ["JPY"], "interval": "15m", "from": "2026-09-14T12:00:00Z", "to": "2026-09-14T12:00:00Z", "data": [{ "timestamp": "2026-09-14T12:00:00Z", "effective_at": { "JPY": "2026-09-14T12:14:58.972181Z" }, "rates": { "JPY": 154.582 }, "source": "live", "source_type": "market", "market_session": "open", "derived_symbols": [] }], "next_cursor": null, "has_more": false, "notice": "Indicative rates, not for settlement."}مثال ثابت تحققنا منه في 2026-09-15 لفترة 2026-09-14 عند 12:00 UTC. السعر إرشادي. timestamp بداية الفترة وeffective_at وقت المشاهدة.
الفواصل والتاريخ المتاح
يدعم /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 زوجًا متقاطعًا.
| interval | الأزواج الفريدة | أقصى فترة للطلب |
|---|---|---|
1m | 221 | 7 d |
5m | 221 | 31 d |
15m | 221 | 93 d |
1h | 221 | 366 d |
4h | 209 | 1830 d |
1d | 10296 | 1830 d |
المشاهدات المفقودة والأزواج المتقاطعة
تتطلب التقاطعات التاريخية مشاهدات إغلاق فعلية ضمن الفترة نفسها بتوقيت UTC، بفارق لا يتجاوز 5 ثوانٍ. يستخدم effective_at وقت المشاهدة الأقدم. لا تُملأ الفجوات، وقد تتغير الفترة المفتوحة. يستخدم 1d البيانات المرجعية اليومية لجميع عملات الكتالوج. يُحسب كل زوج مرة واحدة في الجدول، مع دعم الاتجاهين.
الفترة المدعومة التي لا تحتوي على مشاهدات تعيد HTTP 200 مع data: [] وhas_more: false وnext_cursor: null. الفاصل غير المعروف يعيد unsupported_interval، والزوج خارج التغطية يعيد unsupported_pair_interval وrejected_pairs مع HTTP 400. يُرفض الطلب المختلط بالكامل.
المصادقة والاستخدام التجاري
Plus: الفاصلان 1h و4h لمدة 30 يومًا. Pro: بيانات 1m لآخر 30 يومًا، والسجل الكامل للفواصل من 5m إلى 4h. تتطلب الخطتان مفتاحًا.
تدعم endpoints البيانات تجربة مجهولة: 10 طلبات في الدقيقة و100 في الساعة لكل IP. يستخدم الطلب بالمفتاح الحصة الشهرية للحساب. تتأخر أسعار Free بمقدار 15 دقيقة (الترويسة X-Price-Delay-Seconds: 900).
| الخطة | الطلبات شهريًا | الاستخدام التجاري |
|---|---|---|
| Free | 5,000 | عرض مع إسناد مرتبط |
| Basic | 100,000 | نعم |
| Plus | 300,000 | نعم |
| Pro | 1,000,000 | نعم |