通貨換算API

選択した1つのレートで正の小数金額を換算します。

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 は10進演算を使用し、銀行丸めによって対象通貨の ISO 4217 最小単位へ1回だけ丸めます。丸めるとゼロになる非ゼロの結果は、代わりに偶数丸めで有効数字を最大5桁まで保持し、ゼロを補いません。

エラー

fromとtoが同じ通貨の場合は400 invalid_pairを返します。それ以外の無効な通貨や金額は400 invalid_queryを返します。対応していない通貨は404 currency_not_supportedを返します。

エラーとクォータを読む · 方法論を読む