获取汇率时间序列

返回指定日期区间内的汇率变化。

无需 API Key，查询欧洲央行参考汇率、货币列表及历史时间序列；当前集合对应仍可用的 v1。

请求

operationId: getTimeSeriesRates
服务器: https://api.frankfurter.dev/v1
认证: 无

请求参数

`start_date`

pathstringdate必填

ISO 8601 格式的起始日期（YYYY-MM-DD）

2024-01-01

`end_date`

pathstringdate必填

ISO 8601 格式的结束日期（YYYY-MM-DD）。可使用 "start_date.." 格式省略结束日期，以获取从 start_date 起的所有汇率。

2024-01-31

`amount`

querynumberdouble

要换算的金额（默认为 1）

`base`

querystring

基准货币代码（三位 ISO 4217 代码）

EUR

`symbols`

querystring

以逗号分隔的货币代码列表，用于限制响应范围

响应

`200`

TimeSeriesResponseapplication/json

成功返回时间序列汇率

字段: amountbasestart_dateend_daterates

`404`

Errorapplication/json

指定日期范围没有可用数据

字段: message

`422`

Errorapplication/json

无法处理日期或查询参数，例如日历日期或金额无效

字段: message

{
  "amount": 1,
  "base": "EUR",
  "start_date": "2023-12-29",
  "end_date": "2024-01-31",
  "rates": {
    "2024-01-01": {
      "USD": 1.1047,
      "GBP": 0.8692
    },
    "2024-01-02": {
      "USD": 1.1023,
      "GBP": 0.8671
    }
  }
}