---
title: "أسعار الصرف التاريخية والسلاسل الزمنية"
description: "استخدم /v1/range للحصول على تاريخ عدة عملات وتحميله إلى pandas أو أداة أخرى."
canonical: "https://exchangerate.dev/ar/learn/historical-fx-time-series"
---

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

استخدم /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 النافذة المدعومة.

```getvrange title="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

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

```pythonrequests title="Python · requests"
import requests

API = "https://api.exchangerate.dev/v1"
KEY = "exr_live_..."   # Basic or higher: https://exchangerate.dev/pricing

params = {
    "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"] = cursor

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

```pythonpandas title="Python · pandas"
import pandas as pd

# rows contains every page from the loop above
df = 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 day
df = df[~df["is_forward_filled"]]

print(df[["rates.EUR", "rates.GBP"]].tail())
```

pandas اختياري؛ يمكن معالجة الصفوف نفسها بأداة أخرى.

[ابحث عن تاريخ في أداة الأسعار التاريخية بالإنجليزية](https://exchangerate.dev/historical-exchange-rates)

## أسئلة

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

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

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

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

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

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

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

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

## تابع القراءة

- [كيفية الحصول على أسعار الصرف في Python](https://exchangerate.dev/ar/learn/python-exchange-rates)

Source: https://exchangerate.dev/ar/learn/historical-fx-time-series
