汇率查询与转换

正常热门NEW

汇率查询与转换，支持最新汇率、历史汇率与时间序列查询，数据实时更新。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1696次

¥ 0.002 / 次

按次计费

购买次数包更优惠，低至 0.0016 元/次

100次调用包 100 次调用 ¥0.0020 /次

500次调用包 500 次调用 ¥0.0019 /次省 5%

1000次调用包 1,000 次调用 ¥0.0018 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.0017 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0016 /次省 20%

健康检查

服务存活探测

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/fx/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.version	string	数据版本
data.time	string	数据时间
data.batch_limit	integer	批量查询允许的最大条数

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-22 14:45:41","version":"1.0","batch_limit":10}}

货币列表

返回支持的货币代码列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/fx/currencies JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
force	boolean	否	为 true 时跳过缓存强制刷新（每分钟最多 5 次）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.currencies	array	货币列表
data.currencies[]	object	货币
data.currencies[].code	string	货币代码（ISO 4217，如 AUD）
data.currencies[].name_zh	string	中文名称
data.currencies[].name_en	string	英文名称
data.count	integer	数量
data.queried_at	string	数据查询时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"count":30,"currencies":[{"code":"AUD","name_en":"Australian Dollar","name_zh":"澳大利亚元"},{"code":"BRL","name_en":"Brazilian Real","name_zh":"巴西雷亚尔"},{"code":"CAD","name_en":"Canadian Dollar","name_zh":"加元"}],"queried_at":"2026-10-22T14:03:57Z"}}

货币转换

货币金额转换

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/fx/convert JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
from	string	是	源货币
to	string	是	目标货币
amount	number	否	转换金额，非负，上限 1e12；不传时按 1 处理
force	boolean	否	为 true 时跳过缓存强制刷新（每分钟最多 5 次）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.from	string	来源（源货币/单位）
data.to	string	目标（目标货币/单位）
data.amount	integer	金额
data.rate	number	汇率
data.converted	number	换算结果
data.date	string	日期
data.updated_at	string	更新时间
data.cached	boolean	是否命中缓存
data.queried_at	string	数据查询时间
data.elapsed_ms	integer	服务端处理耗时（毫秒）

请求示例

返回示例

{"msg":"success","code":200,"data":{"to":"CNY","date":"2026-10-22","from":"USD","rate":6.67565,"amount":100,"cached":false,"converted":667.565,"elapsed_ms":242,"queried_at":"2026-10-22T14:47:07Z","updated_at":"2026-10-22T14:47:01Z"}}

批量转换

批量货币转换

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/fx/convert-batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
items	array	是	转换项数组，最多 10 条，超出 → 400；单项非法（货币不存在 / 金额非法）只标记该条失败，其余照常返回（200 部分成功），结果含 error_count / errors
force	boolean	否	为 true 时跳过缓存强制刷新（每分钟最多 5 次）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].query	object	查询内容
data.list[].query.from	string	来源（源货币/单位）
data.list[].query.to	string	目标（目标货币/单位）
data.list[].query.amount	integer	金额
data.list[].code	integer	业务状态码，0 表示成功
data.list[].msg	string	提示信息
data.list[].data	object	业务数据
data.list[].data.from	string	来源（源货币/单位）
data.list[].data.to	string	目标（目标货币/单位）
data.list[].data.amount	integer	金额
data.list[].data.rate	number	汇率
data.list[].data.converted	number	换算结果
data.list[].data.date	string	日期
data.list[].data.updated_at	string	更新时间
data.total	integer	总条数
data.error_count	integer	错误数量
data.errors	array	错误列表
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）
data.max_limit	integer	允许返回的最大条数
data.queried_at	string	数据查询时间
data.elapsed_ms	integer	服务端处理耗时（毫秒）
data.list[].index	integer	对应请求 items 数组的下标

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"msg":"success","code":0,"data":{"to":"CNY","date":"2026-10-22","from":"USD","rate":6.67565,"amount":100,"converted":667.565,"updated_at":"2026-10-22T14:47:01Z"},"query":{"to":"CNY","from":"USD","amount":100}}],"total":1,"errors":[],"max_limit":10,"truncated":false,"elapsed_ms":0,"queried_at":"2026-10-22T14:47:09Z","error_count":0}}

历史汇率

获取指定日期汇率

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/fx/historical JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
date	string	是	日期
base	string	否	基准货币
symbols	string	否	目标货币，多个用空格或逗号分隔（如 CNY EUR / CNY,EUR）；去重后最多 10 个，超出 → 400；全部格式非法 → 400；格式合法但不存在 → 200，未命中代码列在 data.missing；全部不存在 → 400
force	boolean	否	为 true 时跳过缓存强制刷新（每分钟最多 5 次）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.base	string	基准货币
data.date	string	日期
data.rates	object	汇率表，键为货币代码；不传 symbols 时返回全部 30 种币种，传 symbols 时只返回指定币种
data.rates.AUD	number	澳元汇率（以 base 为基准）
data.rates.BGN	number	保加利亚列弗汇率（以 base 为基准）
data.rates.BRL	number	巴西雷亚尔汇率（以 base 为基准）
data.rates.CAD	number	加拿大元汇率（以 base 为基准）
data.rates.CHF	number	瑞士法郎汇率（以 base 为基准）
data.rates.CNY	number	人民币汇率（以 base 为基准）
data.rates.CZK	number	捷克克朗汇率（以 base 为基准）
data.rates.DKK	number	丹麦克朗汇率（以 base 为基准）
data.rates.EUR	number	欧元汇率（以 base 为基准）
data.rates.GBP	number	英镑汇率（以 base 为基准）
data.rates.HKD	number	港元汇率（以 base 为基准）
data.rates.HUF	number	匈牙利福林汇率（以 base 为基准）
data.rates.IDR	integer	印尼盾汇率（以 base 为基准）
data.rates.ILS	number	以色列新谢克尔汇率（以 base 为基准）
data.rates.INR	number	印度卢比汇率（以 base 为基准）
data.rates.ISK	number	冰岛克朗汇率（以 base 为基准）
data.rates.JPY	number	日元汇率（以 base 为基准）
data.rates.KRW	number	韩元汇率（以 base 为基准）
data.rates.MXN	number	墨西哥比索汇率（以 base 为基准）
data.rates.MYR	number	马来西亚林吉特汇率（以 base 为基准）
data.rates.NOK	number	挪威克朗汇率（以 base 为基准）
data.rates.NZD	number	新西兰元汇率（以 base 为基准）
data.rates.PHP	number	菲律宾比索汇率（以 base 为基准）
data.rates.PLN	number	波兰兹罗提汇率（以 base 为基准）
data.rates.RON	number	罗马尼亚列伊汇率（以 base 为基准）
data.rates.SEK	number	瑞典克朗汇率（以 base 为基准）
data.rates.SGD	number	新加坡元汇率（以 base 为基准）
data.rates.THB	number	泰铢汇率（以 base 为基准）
data.rates.TRY	number	土耳其里拉汇率（以 base 为基准）
data.rates.ZAR	number	南非兰特汇率（以 base 为基准）
data.rate_count	integer	汇率数量
data.cached	boolean	是否命中缓存
data.queried_at	string	数据查询时间
data.elapsed_ms	integer	服务端处理耗时（毫秒）
data.missing	array	请求但未找到的货币代码列表；全部正常时为空数组
data.rates.{currency}	number	货币代码对应的汇率；基准货币自身为 1

请求示例

返回示例

{"msg":"success","code":200,"data":{"base":"USD","date":"2025-12-31","rates":{"AUD":1.4963,"BGN":1.6645,"BRL":5.4778,"CAD":1.3692,"CHF":0.79268,"CNY":7.001,"CZK":20.627,"DKK":6.3565,"EUR":0.85106,"GBP":0.74264,"HKD":7.7842,"HUF":327.79,"IDR":16716,"ILS":3.189,"INR":89.87,"ISK":125.28,"JPY":156.67,"KRW":1444.2,"MXN":17.9728,"MYR":4.058,"NOK":10.0791,"NZD":1.7345,"PHP":58.95,"PLN":3.5923,"RON":4.3377,"SEK":9.2098,"SGD":1.2855,"THB":31.675,"TRY":42.965,"ZAR":16.548},"cached":true,"missing":[],"elapsed_ms":0,"queried_at":"2026-10-22T14:47:11Z","rate_count":30}}

时间序列

获取时间段内汇率

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/fx/timeseries JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
start	string	是	开始日期
end	string	是	结束日期
base	string	否	基准货币
symbols	string	否	目标货币，多个用空格或逗号分隔（如 CNY EUR / CNY,EUR）；去重后最多 10 个，超出 → 400；全部格式非法 → 400；格式合法但不存在 → 200，未命中代码列在 data.missing；全部不存在 → 400
force	boolean	否	为 true 时跳过缓存强制刷新（每分钟最多 5 次）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.base	string	基准货币
data.start_date	string	开始日期
data.end_date	string	结束日期
data.rates	object	汇率表
data.cached	boolean	是否命中缓存
data.day_count	integer	时间序列覆盖的天数
data.elapsed_ms	integer	服务端处理耗时（毫秒）
data.queried_at	string	数据查询时间
data.missing	array	请求但未找到的货币代码列表；全部正常时为空数组
data.rates.{date}	object	某一天的汇率表，键为日期（YYYY-MM-DD）
data.rates.{date}.{currency}	number	该日期、该货币的汇率

请求示例

返回示例

{"msg":"success","code":200,"data":{"base":"USD","rates":{"2025-12-31":{"AUD":1.4963,"BGN":1.6645,"BRL":5.4778,"CAD":1.3692,"CHF":0.79268,"CNY":7.001,"CZK":20.627,"DKK":6.3565,"EUR":0.85106,"GBP":0.74264,"HKD":7.7842,"HUF":327.79,"IDR":16716,"ILS":3.189,"INR":89.87,"ISK":125.28,"JPY":156.67,"KRW":1444.2,"MXN":17.9728,"MYR":4.058,"NOK":10.0791,"NZD":1.7345,"PHP":58.95,"PLN":3.5923,"RON":4.3377,"SEK":9.2098,"SGD":1.2855,"THB":31.675,"TRY":42.965,"ZAR":16.548},"2026-01-02":{"AUD":1.4937,"BRL":5.4384,"CAD":1.3733,"CHF":0.79311,"CNY":6.9937,"CZK":20.627,"DKK":6.3727,"EUR":0.85317,"GBP":0.74388,"HKD":7.7919,"HUF":327.26,"IDR":16716,"ILS":3.175,"INR":90.2,"ISK":125.76,"JPY":156.93,"KRW":1444.87,"MXN":17.9396,"MYR":4.054,"NOK":10.0661,"NZD":1.7334,"PHP":58.847,"PLN":3.5938,"RON":4.3422,"SEK":9.2215,"SGD":1.2863,"THB":31.39,"TRY":43.028,"ZAR":16.514},"2026-01-05":{"AUD":1.4997,"BRL":5.4415,"CAD":1.3792,"CHF":0.79638,"CNY":6.9854,"CZK":20.743,"DKK":6.4039,"EUR":0.85734,"GBP":0.74383,"HKD":7.7865,"HUF":329.69,"IDR":16740,"ILS":3.1593,"INR":90.29,"ISK":126.37,"JPY":156.83,"KRW":1449.28,"MXN":18.0101,"MYR":4.0725,"NOK":10.099,"NZD":1.7401,"PHP":59.079,"PLN":3.6161,"RON":4.3617,"SEK":9.2481,"SGD":1.2876,"THB":31.375,"TRY":43.042,"ZAR":16.4839},"2026-01-06":{"AUD":1.4882,"BRL":5.3986,"CAD":1.3777,"CHF":0.79329,"CNY":6.9844,"CZK":20.667,"DKK":6.3831,"EUR":0.85419,"GBP":0.73998,"HKD":7.7878,"HUF":328.89,"IDR":16770,"ILS":3.1626,"INR":90.15,"ISK":125.74,"JPY":156.44,"KRW":1448.65,"MXN":17.9576,"MYR":4.047,"NOK":10.0184,"NZD":1.7282,"PHP":59.21,"PLN":3.5966,"RON":4.3471,"SEK":9.1954,"SGD":1.2799,"THB":31.27,"TRY":43.042,"ZAR":16.3963},"2026-01-07":{"AUD":1.4864,"BRL":5.3916,"CAD":1.3809,"CHF":0.7963,"CNY":6.9912,"CZK":20.789,"DKK":6.3955,"EUR":0.85587,"GBP":0.74153,"HKD":7.7864,"HUF":329.49,"IDR":16768,"ILS":3.1766,"INR":89.85,"ISK":125.98,"JPY":156.55,"KRW":1447.68,"MXN":17.981,"MYR":4.058,"NOK":10.0638,"NZD":1.7289,"PHP":59.316,"PLN":3.6073,"RON":4.3551,"SEK":9.1891,"SGD":1.2814,"THB":31.33,"TRY":43.043,"ZAR":16.4543},"2026-01-08":{"AUD":1.4932,"BRL":5.38,"CAD":1.3861,"CHF":0.7976,"CNY":6.9818,"CZK":20.781,"DKK":6.4,"EUR":0.85653,"GBP":0.74407,"HKD":7.7928,"HUF":329.55,"IDR":16836,"ILS":3.1694,"INR":89.93,"ISK":126.08,"JPY":156.72,"KRW":1452.31,"MXN":17.964,"MYR":4.0625,"NOK":10.1015,"NZD":1.7399,"PHP":59.163,"PLN":3.6054,"RON":4.3583,"SEK":9.2214,"SGD":1.2844,"THB":31.54,"TRY":43.048,"ZAR":16.5149},"2026-01-09":{"AUD":1.4981,"BRL":5.3885,"CAD":1.3883,"CHF":0.80003,"CNY":6.9823,"CZK":20.904,"DKK":6.4185,"EUR":0.85896,"GBP":0.74532,"HKD":7.7962,"HUF":331.58,"IDR":16860,"ILS":3.1562,"INR":90.22,"ISK":126.61,"JPY":157.64,"KRW":1459.84,"MXN":18.0278,"MYR":4.0735,"NOK":10.1155,"NZD":1.747,"PHP":59.212,"PLN":3.6195,"RON":4.3723,"SEK":9.2321,"SGD":1.2871,"THB":31.465,"TRY":43.106,"ZAR":16.575}},"cached":true,"missing":[],"end_date":"2026-01-09","day_count":7,"elapsed_ms":0,"queried_at":"2026-10-22T14:47:12Z","start_date":"2025-12-31"}}

产品说明

产品概述

汇率查询与转换，支持最新汇率、历史汇率与时间序列查询，数据实时更新。

使用场景

数据查询：快速集成汇率查询与转换到您的应用中

业务系统：将汇率查询与转换数据嵌入业务流程

开发工具：通过 API 接口获取金融财税数据

数据分析：基于汇率查询与转换数据进行分析和决策

费用计算

按次计费单价

¥0.002 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.2	¥0.0020/次	-	365 天
500次调用包	500 次	¥0.95	¥0.0019/次	省5%	365 天
1000次调用包	1000 次	¥1.8	¥0.0018/次	省10%	365 天
5000次调用包	5000 次	¥8.5	¥0.0017/次	省15%	365 天
10000次调用包	10000 次	¥16	¥0.0016/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.002/次
个人版	5000 次	5000 次	10%	¥0.0018/次
专业版	30000 次	30000 次	20%	¥0.0016/次
企业版推荐	200000 次	200000 次	30%	¥0.0014/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.002 × 1000 = ¥2.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.002 × (1 - 10%) × 1000 ≈ ¥1.80

示例3：购买「500次调用包」次数包

支付 ¥0.95，获得 500 次调用，折算单价 ¥0.0019/次

同等次数按次付费需 ¥1.00，次数包可节省 ¥0.05

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志