الأدلةأدلة

أسعار الصرف التاريخية والسلاسل الزمنية

استخدم /v1/range للحصول على تاريخ عدة عملات وتحميله إلى pandas أو أداة أخرى.

1 أكتوبر 2026 · قراءة خلال 6 دقائق

تعيد نقطة النطاق المشاهدات المحفوظة مع الصفحات والمصدر وعلامة الملء.

  • تضم صفحة 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 النافذة المدعومة.

GET /v1/range
$ 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 النافذة المدعومة.

JSON
{  "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

تتبع هذه الحلقة كل مؤشر.

Python · requests
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 ورتبها حسب التاريخ واستبعد القيم المنقولة قبل الحساب.

Python · 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 اختياري؛ يمكن معالجة الصفوف نفسها بأداة أخرى.

ابحث عن تاريخ في أداة الأسعار التاريخية بالإنجليزية

أسئلة

ما صيغة التاريخ؟

استخدم YYYY-MM-DD، وتشمل النافذة الحدين.

كيف أطلب عملة واحدة؟

استخدم symbols=EUR وافصل العملات بفواصل.

كيف تعالج العطل؟

لا ينشئ النطاق صفوفاً مفقودة؛ وقد يعيد طلب التاريخ القيمة السابقة.

هل تصلح للتسوية؟

لا. هي أسعار إرشادية؛ راجع notice و source.

تابع القراءة

ابدأ بمفتاح API مجاني

5,000 طلب شهريًا ضمن الخطة المجانية. لا حاجة إلى بطاقة ائتمان.

احصل على مفتاح مجاني