API 文档
接口地址: https://api.gugudata.com/v2/finance/currency-exchange
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/v2/finance/currency-exchange?appkey=YOUR_APPKEY&source=EUR&target=CNY&date=latest
数据预览: https://www.gugudata.com/preview/currencyexchange
接口测试: https://api.gugudata.com/v2/finance/currency-exchange/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
支持 appkey/appKey Query、X-GUGUDATA-APPKEY/X-API-Key Header 或 Bearer;多处提供须一致,同名参数不得重复。 |
| source |
string |
是 |
无 |
必填源币种代码,如 EUR、USD。忽略首尾空白并转大写,最多 20 个字符,允许字母、数字、$、.;是否支持以指定日期来源数据为准。 |
| target |
string |
否 |
无 |
目标币种代码,如 CNY;不传或留空返回全部目标币种,代码规则与 source 相同。 |
| date |
string |
否 |
latest |
默认 latest,空字符串同 latest;或 YYYY-MM-DD,如 2024-03-06。历史可用性以来源实际提供为准,历史结果必须匹配请求日期。 |
| 参数名 |
参数类型 |
备注 |
| dataStatus.requestParameter |
string |
真实可读的 source、target、date,不含凭据。 |
| dataStatus.statusCode |
integer |
成功 200;参数错误 400;依赖失败 503。公共鉴权错误保持。 |
| dataStatus.status |
string |
成功为 SUCCESS,错误为相应业务状态。 |
| dataStatus.statusDescription |
string |
业务状态说明。 |
| dataStatus.responseDateTime |
string |
接口响应时间,不是汇率公布时间。 |
| dataStatus.dataTotalCount |
integer |
成功顶层对象数量为 1,含全量查询;不是目标币种数量。 |
| data.sourceCurrency |
string |
归一化后的源币种代码。 |
| data.targetCurrency |
array |
目标汇率数组,保持来源顺序。 |
| data.targetCurrency[].sourceCurrency |
string |
源币种代码。 |
| data.targetCurrency[].targetCurrency |
string |
目标币种代码。 |
| data.targetCurrency[].exchangeRate |
number |
1 单位源币对应的目标币金额,有限正数;不代表交易成交价。 |
| data.targetCurrency[].lastUpdateTimestamp |
string |
来源公布日期的 UTC 零点毫秒时间戳字符串,不是请求时间或盘中更新时间。 |
| data.lastUpdateTimestamp |
string |
来源公布日期的 UTC 零点毫秒时间戳字符串,不是请求时间或盘中更新时间。 |