تعيد نقطة النطاق المشاهدات المحفوظة مع الصفحات والمصدر وعلامة الملء.
- تضم صفحة JSON حتى 366 مشاهدة. تابع next_cursor ما دام has_more يساوي true.
- Free: آخر 30 يومًا؛ Basic: سنة؛ Plus وPro: السجل الكامل. الحد 1,830 يومًا لكل طلب؛ يعتمد العمق على الزوج.
- يغيب السبت 2026-06-13 لأن النطاق يعيد المشاهدات المحفوظة ولا ينشئ صفاً لكل يوم.
- لا. هي أسعار إرشادية؛ راجع notice و source.
استخدم نقطة النطاق
يشمل start_date وend_date الحدين. القيمة الافتراضية لـ base هي USD، وتُفصل symbols بفواصل. تتوفر أداة التاريخ بالإنجليزية.
يحتوي data على الصفوف المحفوظة. تابع has_more و next_cursor؛ ويغطي CSV وParquet النافذة المدعومة.
$ curl -G "https://api.exchangerate.dev/v1/range" \ -H "Authorization: Bearer exr_live_..." \ --data-urlencode "base=USD" \ --data-urlencode "symbols=EUR,GBP" \ --data-urlencode "start_date=2026-06-10" \ --data-urlencode "end_date=2026-06-13"اقرأ استجابة JSON
يحتوي data على الصفوف المحفوظة. تابع has_more و next_cursor؛ ويغطي CSV وParquet النافذة المدعومة.
{ "result": "success", "base": "USD", "start_date": "2026-06-10", "end_date": "2026-06-13", "data": [ { "date": "2026-06-10", "rates": { "EUR": 0.86663, "GBP": 0.74727 }, "source": "ecb_daily", "is_forward_filled": false }, { "date": "2026-06-11", "rates": { "EUR": 0.86678, "GBP": 0.74829 }, "source": "ecb_daily", "is_forward_filled": false }, { "date": "2026-06-12", "rates": { "EUR": 0.86453, "GBP": 0.74613 }, "source": "ecb_daily", "is_forward_filled": false } ], "has_more": false, "next_cursor": null}التواريخ الغائبة
يغيب السبت 2026-06-13 لأن النطاق يعيد المشاهدات المحفوظة ولا ينشئ صفاً لكل يوم.
التصفح باستخدام Python
تتبع هذه الحلقة كل مؤشر.
import requestsAPI = "https://api.exchangerate.dev/v1"KEY = "exr_live_..." # Basic or higher: https://exchangerate.dev/pricingparams = { "base": "USD", "symbols": "EUR,GBP", "start_date": "2026-06-10", "end_date": "2026-06-13",}rows = []while True: resp = requests.get( f"{API}/range", headers={"Authorization": f"Bearer {KEY}"}, params=params, timeout=10, ) resp.raise_for_status() data = resp.json() rows.extend(data["data"]) if not data["has_more"]: break cursor = data.get("next_cursor") if not cursor or cursor <= params.get("cursor", ""): raise RuntimeError("Incomplete historical response") params["cursor"] = cursorfor row in rows: filled = row["is_forward_filled"] print(row["date"], row["rates"]["EUR"], row["rates"]["GBP"], "filled" if filled else "")ميّز المشاهدة عن القيمة المنقولة
تحمل مشاهدات النطاق is_forward_filled false؛ وقد يعيد طلب تاريخ محدد القيمة السابقة مع true.
يحذف النطاق السبت 2026-06-13. وقد يعيد الطلب المباشر القيمة السابقة مع is_forward_filled true.
اختر تاريخاً أو نطاقاً
يناسب التاريخ الواحد الفحص المنفرد، بينما يناسب النطاق الرسوم والملء والتحليل الجماعي.
| البعد | تاريخ محدد | نطاق |
|---|---|---|
| الطلب | طلب لكل تاريخ | طلب واحد مع صفحات |
| الاستجابة | يوم واحد | مصفوفة data |
تحقق من التغطية
Free: آخر 30 يومًا؛ Basic: سنة؛ Plus وPro: السجل الكامل. الحد 1,830 يومًا لكل طلب؛ يعتمد العمق على الزوج.
pandas
حمّل الصفوف إلى pandas ورتبها حسب التاريخ واستبعد القيم المنقولة قبل الحساب.
import pandas as pd# rows contains every page from the loop abovedf = pd.json_normalize(rows)df["date"] = pd.to_datetime(df["date"])df = df.set_index("date").sort_index()# keep only rows that were actually published that daydf = df[~df["is_forward_filled"]]print(df[["rates.EUR", "rates.GBP"]].tail())pandas اختياري؛ يمكن معالجة الصفوف نفسها بأداة أخرى.