現在の為替レートAPI

基準通貨と換算先通貨を指定して現在のレートをリクエストします。

1基準単位は、返される各換算先通貨に相当します。REST と fx_get_rates 同じスキーマを使用します。

リクエスト

REST

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

パラメータ	規則
`base`	流通中の大文字 ISO 4217 コードが必須です。
`currencies`	1～64個の重複しない換算先通貨を指定する任意のリスト。サポート対象のすべての換算先通貨を取得する場合は省略します。

レスポンス

200 OK

{
  "base": "USD",
  "market_session": "open",
  "rates": [
    {
      "currency": "EUR",
      "rate": "0.9200",
      "timestamp": "2026-08-22T06:29:41Z",
      "stale": false
    },
    {
      "currency": "JPY",
      "rate": "147.23",
      "timestamp": "2026-08-22T06:29:39Z",
      "stale": false
    }
  ]
}

レートは動的キーではなく、順序付けされたレコードです。各レートは固有のタイムスタンプと古い状態を保持します。

鮮度

market_session 次のもの： open, weekend、または interbank_closed。週末のレスポンスも、タイムスタンプと古い状態が明確なら利用できます。

エラー

400 invalid_query · 401 invalid_api_key · 404 currency_not_supported · 429 quota_exhausted · 503 upstream_unavailable

エラーとクォータを読む · カバレッジを表示