FrankfurterFrankfurter v2 汇率 API

GET/rates

获取汇率

返回跨数据提供方混合计算的汇率。不传日期参数时返回最新汇率，每条记录代表一个货币对。响应包含基准货币自身的恒等记录（base 与 quote 相同、rate 为 1），且与其他记录一样受 quotes 过滤。接口支持任意长度的日粒度日期区间及完整历史。限制：使用 providers 或 expand=providers 时会逐日重新计算混合值，日粒度超过 5 年的区间将返回 422；若 providers 最多指定 5 个提供方且 quotes 最多指定 5 种货币，则不受此限制。不指定 providers 时，expand=providers 会忽略 quotes 对计算量的缩减，因此应使用 group=week 或 group=month 聚合、指定 providers，或拆分日期区间。

无需 API Key 查询 84 家中央银行、201 种货币及 1948 年以来的汇率，支持数据源过滤与归因、时间序列降采样和流式输出。

请求

operationId: getRates
服务器: https://api.frankfurter.dev/v2
认证: 无

请求参数

`date`

querystringdate

指定日期（YYYY-MM-DD），不能与 from/to 同时使用。

2024-01-15

`from`

querystringdate

日期区间起点（YYYY-MM-DD）

2024-01-01

`to`

querystringdate

日期区间终点（YYYY-MM-DD），默认为今天。

2024-01-31

`base`

querystring

基准货币，默认为 EUR

USD

`quotes`

querystring

要包含的计价货币代码，以逗号分隔

USD,GBP,JPY

`providers`

querystring

要包含的数据提供方代码，以逗号分隔

ECB,TCMB

`group`

querystring

按时间周期对汇率降采样，仅适用于日期区间。

month

`expand`

querystring

每条记录要展开的可选字段，以逗号分隔。目前支持 `providers`：为每条记录增加 `{ key, date, rate }` 对象数组，展示各提供方的观测日期与汇率。因共识过滤被判为异常值，或因货币锚定关系而被覆盖的提供方，会标记 `excluded: true`。若锚定货币记录由系统合成且没有提供方直接发布该计价货币，则省略此字段。CSV 输出中，`providers` 列使用 `|` 连接 `KEY:RATE`，被排除的条目末尾附加 `*`（例如 `ECB:0.92|FED:1.50*`）。

providers

响应

`200`

Rateapplication/jsonapplication/x-ndjson

汇率列表

字段: datebasequoterateproviders

`404`

objectapplication/json

未找到数据

字段: message

`422`

objectapplication/json

请求参数无效

字段: message

`503`

objectapplication/json

响应计算完成前已超过请求时限。请缩小请求范围后重试：使用 quotes 过滤、使用 group 聚合，或将日期区间拆分为更短的请求。

字段: message

[
  {
    "date": "2024-01-15",
    "base": "EUR",
    "quote": "EUR",
    "rate": 1
  },
  {
    "date": "2024-01-15",
    "base": "EUR",
    "quote": "GBP",
    "rate": 0.8623
  },
  {
    "date": "2024-01-15",
    "base": "EUR",
    "quote": "USD",
    "rate": 1.089
  }
]