目前匯率 API

按基準貨幣和報價貨幣請求當前匯率。

每單位基準貨幣可兌換的報價貨幣金額，就是各筆回傳的匯率。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

閱讀錯誤與配額說明 · 查看涵蓋範圍