واجهة 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 عملة تسعير فريدة. لا يمكن إدراج العملة الأساسية في القائمة. احذفها للحصول على جميع عملات التسعير المدعومة. تقبل أداة MCP مصفوفة JSON.

الاستجابة

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. قد تظل استجابة عطلة نهاية الأسبوع قابلة للاستخدام إذا كان طابعها الزمني وحالة تقادم بياناتها واضحين.

في Free، تُعرض أسعار الصرف عند إغلاق اليوم السابق، كما كانت عند 00:00 UTC اليوم. توفر Basic وPro أسعار صرف مباشرة. ويرسل تدفق الأسعار فيهما كل سعر صرف عند تغيره، بالتنسيق نفسه. مرجع تدفق الأسعار

الأخطاء

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

يُرجع رمز العملة غير الصحيح الصيغة 400. ويُرجع رمز العملة الصحيح الصيغة الذي لا تقدمه Narwhal القيمة 404.

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