مرجع API | exchangerate.dev

المصادقة والحدود

تدعم endpoints البيانات تجربة مجهولة: 12 طلبًا في الدقيقة و100 في الساعة لكل IP. يستخدم الطلب بالمفتاح الحصة الشهرية للحساب.

bash · header

Authorization: Bearer YOUR_KEY
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1788220800

حقول تشرح حداثة البيانات

يحدد `source` فئة المصدر، ويصف `market_session` حالة السوق، ويبيّن `data_updated_at` وقت كتابة الرقم. احتفظ بالثلاثة.

نقاط النهاية

GET /v1/latest[/{BASE}]الأسعار الحالية، كلها أو مفلترة عبر symbols.

GET /v1/{YYYY-MM-DD}[/{BASE}]لقطة تاريخية لتاريخ وعملة أساس.

GET /v1/convert/{FROM}/{TO}[/{AMOUNT}] · POST /v1/convertتحويل مبلغ عبر GET أو دفعة عبر POST.

GET /v1/rate/{slug}سعر زوج واحد بواسطة slug.

GET /v1/rangeسلسلة يومية مع ترقيم وتنزيلات.

GET /v1/currenciesقائمة العملات المدعومة دون معاملات.

GET /v1/accountالحساب والخطة والمفتاح النشط واستهلاك الشهر.

الأخطاء

كل خطأ يستخدم `{ result: "error", code, message }`. تضيف 429 ترويسة `Retry-After`، ولا تُستخدم بيانات وهمية عند تعطل المصدر.

json · error

{
  "result": "error",
  "code": "missing_parameter",
  "message": "missing required parameter: symbols"
}

English complete field-by-field reference →

استخدمه مع أدواتك

يعمل الطلب نفسه مع curl وPython وJavaScript. لا تحتاج إلى مفتاح API للتقييم.

افتح البداية السريعة →

curl -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

from urllib.request import Request, urlopen
import json

request = Request("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP")
with urlopen(request, timeout=10) as response:
    data = json.load(response)

print(data["rates"]["EUR"])

const response = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", {
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data.rates.EUR);

مثال على الاستجابة

{
  "result": "success",
  "base": "USD",
  "source": "live",
  "sources": {
    "EUR": "live",
    "GBP": "live"
  },
  "market_session": "open",
  "timestamp": "2026-06-15T12:00:00Z",
  "data_updated_at": "2026-06-15T12:00:00Z",
  "effective_at": {
    "EUR": "2026-06-15T12:00:00Z",
    "GBP": "2026-06-15T12:00:00Z"
  },
  "rates": {
    "EUR": 0.86207,
    "GBP": 0.74627
  },
  "derived_symbols": [],
  "notice": "Indicative rates, not for settlement."
}

يمثل rates.EUR قيمة اليورو مقابل 1 USD. يحدد effective_at.EUR وقت الرصد، ويحدد sources.EUR فئة المصدر. القيم والأوقات للتوضيح.

افتح استجابة JSON ↗مرجع API →