当前汇率 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

阅读错误与配额说明 · 查看覆盖范围