واجهة API لأسعار الصرف الحالية

اطلب الأسعار الحالية حسب عملة الأساس وعملات التسعير.

تعادل كل وحدة أساسية كل عرض سعر مُعاد. وتبقى REST و fx_get_rates استخدم المخطط نفسه.

طلب

REST

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

معلمة	قاعدة
`base`	رمز ISO 4217 متداول مطلوب بالأحرف الكبيرة.
`currencies`	قائمة اختيارية من 1 إلى 64 عملة تسعير فريدة. اتركها محذوفة لجميع العملات المدعومة.

الاستجابة

200 OK

{
  "base": "USD",
  "market_session": "open",
  "rates": [
    {
      "currency": "EUR",
      "rate": "0.9200",
      "timestamp": "2026-08-22T06:29:41Z",
      "stale": false
    },
    {
      "currency": "JPY",
      "rate": "147.23",
      "timestamp": "2026-08-22T06:29:39Z",
      "stale": false
    }
  ]
}

الأسعار سجلات مرتبة وليست مفاتيح ديناميكية. ويحتفظ كل سعر بطابعه الزمني وحالة تقادمه.

الحداثة

market_session هو open, weekend، أو interbank_closedقد تظل استجابة عطلة نهاية الأسبوع صالحة عندما يكون طابعها الزمني وحالتها القديمة واضحين.

الأخطاء

400 invalid_query · 401 invalid_api_key · 404 currency_not_supported · 429 quota_exhausted · 503 upstream_unavailable

اقرأ شرح الأخطاء وحصة الاستخدام · عرض التغطية