货币换算 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.