واجهة API لتحويل العملات

حوّل مبلغًا عشريًا موجبًا واحدًا باستخدام سعر محدد واحد.

REST و fx_convert_currency يعيدان السعر والنتيجة والطابع الزمني وحداثة البيانات وجلسة السوق نفسها.

طلب

REST

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/convert?from=USD&to=JPY&amount=100.00" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

معلمة	قاعدة
`from`	عملة المصدر المطلوبة.
`to`	عملة الهدف المطلوبة. ويجب أن تختلف عن `from`.
`amount`	سلسلة نصية لعدد عشري موجب لا يتجاوز `1000000000000`.

الاستجابة

200 OK

{
  "from": "USD",
  "to": "JPY",
  "rate": "147.23",
  "converted": "14723",
  "market_session": "open",
  "timestamp": "2026-08-22T06:29:39Z",
  "stale": false
}

التقريب

يستخدم Narwhal الحساب العشري ويجري التقريب مرة واحدة إلى الوحدة الفرعية للعملة الهدف وفق ISO 4217، باستخدام التقريب إلى الزوجي عند التعادل. أما النتائج غير الصفرية التي ستصبح صفرًا عند التقريب، فتُقرّب بدلًا من ذلك إلى ما يصل إلى خمسة أرقام معنوية، مع ترجيح العدد الزوجي عند التعادل، دون إضافة أصفار.

الأخطاء

يُرجع 400 invalid_pair عندما تكون from وto العملة نفسها. تُرجع العملات أو المبالغ غير الصالحة الأخرى 400 invalid_query. وتُرجع العملات غير المدعومة 404 currency_not_supported.

اقرأ شرح الأخطاء وحصة الاستخدام · اقرأ المنهجية