現在の為替レート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個の換算先通貨のカンマ区切りリスト。基準通貨はリストに含められません。省略すると、対応するすべての換算先通貨を返します。MCPツールはJSON配列を受け取ります。

レスポンス

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のいずれかです。週末のレスポンスも、タイムスタンプと鮮度の状態が明確なら利用できます。

Freeでは、前日の終値として本日00:00 UTC時点の為替レートを表示します。BasicとProではリアルタイムの為替レートを利用できます。両プランの価格ストリームは、各レートが変わるたびに同じ形式で送信します。価格ストリームリファレンス

エラー

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

通貨コードの形式が不正な場合は400を返します。形式が正しくてもNarwhalが対応していない通貨コードは404を返します。

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