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": {}
}