[DEMO] 国际货币汇率

查询货币对汇率，支持最新公布数据与指定历史日期。汇率方向为 1 单位源币对应的目标币金额；不是盘中实时行情。latest 接受当前 UTC 日期至前两日的公布数据，历史日期需精确匹配。支持范围随来源与日期变化，目标不存在或数据损坏返回 503，不补零。一小时缓存读取不延长有效期；不提供更旧备用结果。全量查询 dataTotalCount 仍为顶层对象数量 1，不是币种数量。示例输入 source=EUR&target=CNY&date=latest，通过同一查询服务读取当前有效公布数据。

当前接口契约

接口详情：https://www.gugudata.com/api/details/currencyexchange

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

正常响应

HTTP 200，application/json。

字段	类型	说明
dataStatus	object
dataStatus.requestParameter	string / null	真实可读的归一化 source、target、date，不含凭据。
dataStatus.statusCode	integer
dataStatus.status	string
dataStatus.statusDescription	string
dataStatus.responseDateTime	string
dataStatus.dataTotalCount	integer
data	object

业务状态说明

业务状态码	业务状态码解释	备注
200	成功	SUCCESS
500	内部错误	FAILED
503	解析或鉴权服务暂时不可用	UPSTREAM_UNAVAILABLE / AUTH_SERVICE_UNAVAILABLE

返回响应

🟢200成功

application/json

返回一个汇率对象，targetCurrency 为数组。

Bodyapplication/json

示例

{
  "dataStatus": {
    "requestParameter": "source=EUR&target=CNY&date=latest",
    "statusCode": 200,
    "status": "SUCCESS",
    "statusDescription": "successfully / 成功",
    "responseDateTime": "2026-10-10 17:28:49",
    "dataTotalCount": 1
  },
  "data": {
    "sourceCurrency": "EUR",
    "targetCurrency": [
      {
        "sourceCurrency": "EUR",
        "targetCurrency": "CNY",
        "exchangeRate": 7.52694217,
        "lastUpdateTimestamp": "1791504000000"
      }
    ],
    "lastUpdateTimestamp": "1791504000000"
  }
}

🔴500业务错误；结合六字段 dataStatus 判断。

🔴503业务错误；结合六字段 dataStatus 判断。

当前接口契约

正常响应

业务状态说明

请求参数

请求示例代码

返回响应

[DEMO] 国际货币汇率

当前接口契约#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

正常响应

业务状态说明