جميع واجهات API

FX API

الأسعار الحالية وتحويل العملات وبيانات FX التاريخية بمفتاح واحد.

الطلب الأول

البدء السريع
curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "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
    }
  ]
}

نقاط النهاية

GETالأسعار الحالية/v1/fx/rates/{base}
GETتحويل العملات/v1/fx/convert
GETالأسعار التاريخية/v1/fx/rates/{base}/observations

المصادر والمنهجية

الحداثة

لكل سعر طابع زمني وحالة قديمة خاصان به.

سياق السوق

توضح حالات الفتح أو عطلة نهاية الأسبوع أو إغلاق التعاملات بين البنوك سياق السوق.

العملات والتواريخ والحدود والفجوات.

أدلة المطورين

الأسئلة الشائعة

ماذا يعني سعر FX؟

تعادل وحدة واحدة من الأساس المبلغ المُعاد من عملة التسعير.

هل تتضمن API أسعارًا تاريخية؟

نعم. يستخدم السجل تواريخ مخزنة حقيقية وصفحات محدودة ومؤشرات معتمة.

ماذا يحدث في عطلات نهاية الأسبوع؟

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

هل هذه أسعار متعاملين قابلة للتنفيذ؟

لا. الأسعار والتحويلات إرشادية وليست أسعار متعاملين أو تثبيتات رسمية.

أجرِ أول طلب لك

احصل على مفتاح API مجاني