通貨換算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 | 次までの正の10進数文字列： 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 は10進演算を使用し、銀行丸めによって対象通貨の ISO 4217 最小単位へ1回だけ丸めます。
エラー
無効なペアまたは金額は次を返します： 400 invalid_query。対応していない通貨は 404 currency_not_supported.