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

阅读错误与配额说明 · 阅读方法说明