當前匯率 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

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