واجهة 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",
"amount": "100.00",
"rate": "147.23",
"converted": "14723",
"market_session": "open",
"timestamp": "2026-08-22T06:29:39Z",
"stale": false
}التقريب
يستخدم Narwhal الحساب العشري ويجري التقريب مرة واحدة إلى الوحدة الفرعية لعملة الهدف وفق ISO 4217 باستخدام تقريب نصف إلى الزوجي.
الأخطاء
تعيد الأزواج أو المبالغ غير الصالحة 400 invalid_queryتعيد العملات غير المدعومة 404 currency_not_supported.