CurrencyBeaconCurrencyBeacon 汇率 API

GET/convert

换算货币金额

使用当前或指定历史日期的汇率换算金额。

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

请求

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

请求参数

`from`

querystring必填

待换算货币的三字母代码。

USD

`to`

querystring必填

目标货币的三字母代码。

USD

`amount`

querynumber必填

待换算的金额。

`date`

querystringdate

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

2025-01-02

响应

`200`

ConversionResponseapplication/json

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

字段: amountdatefrommetaresponsetimestamptovalue

`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

{
  "amount": 10,
  "date": "2026-08-15",
  "from": "USD",
  "meta": {
    "code": 200,
    "disclaimer": "Usage subject to terms: https://currencybeacon.com/terms"
  },
  "response": {
    "amount": 10,
    "date": "2026-08-15",
    "from": "USD",
    "timestamp": 1786770980,
    "to": "EUR",
    "value": 8.6426828
  },
  "timestamp": 1786770980,
  "to": "EUR",
  "value": 8.6426828
}