CurrencyBeacon/getTimeseries

仅预览 · 原因见下方

CurrencyBeaconCurrencyBeacon 汇率 API

GET/timeseries

查询汇率时间序列

返回给定日期范围内的每日汇率。

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

请求

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

请求参数

start_date

querystringdate必填

时间序列起始日期,格式为 YYYY-MM-DD。

2025-01-02

end_date

querystringdate必填

时间序列结束日期,格式为 YYYY-MM-DD,且不得早于起始日期。

2025-01-02

base

querystring

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

USD

symbols

querystring

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

EUR,GBP

响应

200

TimeseriesResponseapplication/json

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

字段: metaresponse

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

{
  "meta": {
    "code": 200,
    "disclaimer": "Usage subject to terms: https://currencybeacon.com/terms"
  },
  "response": {}
}