التوثيق /

أول استدعاء إلى API أسعار الصرف

افتح الطرفية والصق أمرًا واحدًا. لا تحتاج إلى مفتاح لتجربة endpoint البيانات.

1. اطلب سعرين

USD في المسار هو عملة الأساس، وEUR وGBP في `symbols` هما العملتان المطلوبتان. بدّل الرموز حسب حاجتك.

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

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

افتح البداية السريعة
curl -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"
مثال على الاستجابة
{
  "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

2. اقرأ الاستجابة

تتغير الأرقام وتبقى البنية. اقرأ `rates.EUR` واحفظ `source` و`market_session` و`data_updated_at` مع السعر.

json · exact example
{
  "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."
}

3. أضف مفتاحًا عند الحاجة إلى حصة الحساب

أنشئ مفتاحًا مجانيًا وأرسله بصيغة `Authorization: Bearer YOUR_KEY`. احتفظ به على الخادم، لا في JavaScript عام.

bash · authenticated
curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"   -H "Authorization: Bearer YOUR_KEY"
أسعار إرشادية
مناسبة للتطبيقات والنماذج والتحليل، وليست عرض تداول قابلًا للتنفيذ أو سعر تسوية.