查询历史汇率

返回指定日期的历史汇率，可按 symbols 限制返回货币。

查询最新、历史、换算、时间序列与支持货币数据；调用方以自己的 CurrencyBeacon 凭据直连服务。

请求

operationId: getHistoricalRates
服务器: https://api.currencybeacon.com/v1
认证: apiKey

请求参数

`date`

querystringdate必填

历史查询或换算使用的日期，格式为 YYYY-MM-DD。

2025-01-02

`base`

querystring

基准货币的三字母代码；未提供时服务默认使用 USD。

USD

`symbols`

querystring

可选的逗号分隔货币代码列表，用于限制返回汇率。

EUR,GBP

响应

`200`

HistoricalRatesResponseapplication/json

请求成功，返回该 Endpoint 定义的 JSON 响应。

字段: basedatemetaratesresponse

`400`

ErrorResponseapplication/json

请求参数无效。

字段: messagemetaresponse

`401`

ErrorResponseapplication/json

调用方凭据缺失、无效或尚未激活。

字段: messagemetaresponse

`403`

ErrorResponseapplication/json

调用方套餐或权限不允许此请求。

字段: messagemetaresponse

`404`

ErrorResponseapplication/json

请求的 Endpoint 或资源不存在。

字段: messagemetaresponse

`429`

ErrorResponseapplication/json

调用方超过服务调用额度或速率限制。

字段: messagemetaresponse

`500`

ErrorResponseapplication/json

上游服务发生内部错误。

字段: messagemetaresponse

{
  "base": "USD",
  "date": "2025-01-02",
  "meta": {
    "code": 200,
    "disclaimer": "Usage subject to terms: https://currencybeacon.com/terms"
  },
  "rates": {},
  "response": {
    "base": "USD",
    "date": "2025-01-02",
    "rates": {}
  }
}