2026年以来，外汇市场波动明显加大。日元对美元一度触及历史低位区间，人民币对美元在关键点位反复拉扯，新兴市场货币各自的行情也受资本流动影响频繁调整。做跨境结算、外贸收款、海外电商的团队，这段时间的感受应该最深——系统里的汇率还停在昨天，用户那边已经按新价付了款，差额谁来担？

这个问题在财务对账和商品定价两个场景里尤其突出。财务系统靠汇率算成本和利润，差几个基点，月底对账就对不上。电商平台给商品标本地货币价格，汇率旧一点，价格就虚高或者虚低，直接影响转化率。

探数API的汇率查询接口，提供实时汇率换算、单货币全币种列表和货币基础列表三个子接口，覆盖上百种币种。数据每分钟更新一次，接入以后系统里的汇率数字不用再靠人工维护。

接口能力一览

三个子接口各有侧重，先看一张表搞清楚各自的用途：

三个接口共用同一套 key 鉴权，返回格式统一为 JSON，请求方式不限 GET 或 POST。

实时汇率查询换算：返回数据完整解读

请求方式

接口地址：https://www.tanshuapi.com/market/detail-84

两个必填参数：from（源币种代码）和 to（目标币种代码），可选参数 money（换算金额，不传则只返回汇率）。

返回示例

以 1 人民币兑换美元为例：

{
    "code": 1,
    "msg": "操作成功",
    "data": {
        "from": "CNY",
        "from_name": "人民币",
        "to": "USD",
        "to_name": "美元",
        "exchange": "0.147669",
        "money": "0.147669",
        "updatetime": "2026-07-24 18:34:02"
    }
}

字段说明

🤔 updatetime 字段值得关注——接口每分钟刷新一次数据，但底层数据源本身会有不同程度的延迟，部分币种的更新时间可能落后于当前时间。updatetime 告诉你这份汇率数据到底是几点钟的，比接口刷新频率更有参考价值。如果业务对汇率时效性要求高，调用后先判断 updatetime 是否在可接受范围内。

货币列表：上百种币种一次拉取

请求方式

接口地址：https://www.tanshuapi.com/market/detail-84

只需传入 key 一个参数。

返回结构

{
    "code": 1,
    "msg": "操作成功",
    "data": {
        "list": [
            {
                "currency": "CNY",
                "name": "人民币",
                "logo": "e9194120119fe795abc39e775f86a608.png"
            },
            {
                "currency": "USD",
                "name": "美元",
                "logo": "44aaa827691c01da179ffa62ed4de86a.png"
            }
        ]
    }
}

字段说明

📌 注意接口icon 图片资源包需要开通会员后联系客服获取。如果只需要币种名称和代码做下拉选项，logo 字段不是必须的。

这个接口适合在页面初始化时一次性加载全部币种列表，前端渲染下拉选择器。返回的币种数量在百种以上，覆盖了主流交易货币和大部分新兴市场货币。

单货币列表：一种币对全部币种的汇率

请求方式

接口地址：https://www.tanshuapi.com/market/detail-84

一个必填参数：from（需要查询的货币代码）。

返回结构

以查询美元（USD）对所有币种的汇率为例：

```json
{
“code”: 1,
“msg”: “操作成功”,
“data”: {
“currency”: “USD”,
“name”: “美元”,
“list”: {
“CNY”: {
“name”: “人民币”,
“rate”: “6.770200”,
“updatetime”: “2026-07-25 02:59:01”
},
“EUR”: {
“name”: “欧元”,
“rate”: “0.879600”,
“updatetime”: “2026-07-25 04:59:58”
},
“JPY”: {
“name”: “日元”,
“rate”: “163.840000”,
“updatetime”: “2026-07-25 04:59:55”
}
}
}
}

字段说明

和实时换算接口的区别：这个接口一次返回某一种货币对所有其他币种的汇率，不需要逐个币种发起请求。适合做汇率面板、行情展示页这类需要同时展示多个币对的场景。

三个接口怎么选

做跨境业务的团队，大概率会同时用到币种列表和汇率查询。这里的问题是：什么时候用哪个接口？

先想清楚你的页面需要什么数据：

• 页面需要一个币种下拉框 → 调用货币列表接口，一次拿到全部币种名称和代码，渲染选择器。
• 用户选了人民币和美元，要算 100 元等于多少美元 → 调用实时汇率查询换算接口，传入 from、to 和 money，直接拿到换算结果。
• 页面要展示一张汇率面板，人民币对美元、欧元、日元、英镑的牌价同时显示 → 调用单货币列表接口，传入 from=CNY，一次拿到所有币对的汇率。

简单讲：选接口的逻辑不是哪个功能强就用哪个，而是看你的页面一次需要几组数据。只需要两个币种之间的换算，用实时换算接口就够了；需要一张对照表，用单货币列表。

应用场景

💱 跨境电商多币种定价

做独立站或平台的跨境商家，商品价格需要展示为买家本地货币。用户浏览商品页时，后台根据用户所在地区选择对应的目标币种，调用实时换算接口，将标价人民币实时换算成美元、欧元或日元展示。

这里的难点在于汇率更新频率。商品页访问量大，每次请求都调接口不现实。做法是服务端定时（比如每 5 分钟）拉一次汇率，缓存到本地，页面展示用缓存数据。缓存过期后自动刷新，保证价格数字不会偏差太大。

🏦 财务系统跨境对账

财务团队做跨境供应商结算或海外子公司报表合并时，需要把外币金额按统一时点的汇率换算成本位币。调用单货币列表接口，拉取当天的全部币对汇率，批量换算账单金额。

updatetime 字段在这里的作用是确认汇率数据的时点——如果月末对账用的是 25 号的汇率，而财务系统记录的是 24 号的数据，updatetime 能帮你发现这个差异。

📊 金融行情展示页

做外汇交易平台或金融信息产品的团队，需要在页面展示主要货币对的实时牌价。调用单货币列表接口，传入基准货币代码，一次返回该货币对所有其他币种的汇率，前端渲染成汇率面板。

如果要展示的币对非常多（比如几十对），单货币列表接口比逐个调用实时换算接口效率更高——一次请求搞定。

🛒 结算页汇率转换

电商结算页显示”应付金额”时，如果买家所在地区的币种和商品标价币种不同，需要做实时换算。调用实时换算接口，传入结算金额，返回换算后的本地货币金额，展示在支付确认页。

使用提示：结算页的汇率数据对准确性要求高，建议调用后检查 updatetime 是否在 5 分钟以内。如果数据过期，可以提示用户”汇率已更新，请刷新页面”，避免用旧汇率完成结算。

错误码速查

实时汇率查询换算

货币列表 / 单货币列表

系统级通用

📌 from 和 to 参数要求传入 ISO 4217 三位字母代码（如 USD、EUR、JPY），传中文名称或数字代码会返回参数错误。不确定代码的时候，可以先调用货币列表接口拿到全部币种的 code 字段，对照使用。

常见问题 FAQ

Q1：汇率数据多久更新一次？

接口数据每分钟刷新一次。但底层数据源（公开信息发布平台）本身存在不同程度的延迟，部分币种的 updatetime 可能落后于当前时间。换句话说，要以 updatetime 字段为准判断数据时效，而不是单纯依赖接口刷新频率。如果业务对实时性要求较高，建议调用后先判断 updatetime 是否在 5 分钟以内再使用。

Q2：支持哪些币种？

实时汇率查询换算接口支持任意两种 ISO 4217 标准币种之间的换算。货币列表接口目前返回 160+ 种币种，覆盖了主要国际货币和大部分新兴市场货币。CNH（中国离岸人民币）也在支持列表中。如果需要的币种不在列表中，可以联系平台客服咨询是否支持。

Q3：汇率数据来源是什么？是否可靠？

数据来源于公开的信息发布平台，平台定期更新维护。汇率行情仅供参考，旨在提供市场动态和信息，不构成任何形式的投资建议。对于金融交易类应用，建议结合多个数据源做交叉验证。

Q4：怎么选三个子接口？需要都接入吗？

不一定。如果只需要做币种之间的金额换算，接入实时汇率查询换算接口就够了。如果需要展示币种选择器或汇率面板，额外接入货币列表和单货币列表接口。三个接口的数据是互补的，不是互斥的，按需选用即可。

接口速查

三个接口统一入口：https://www.tanshuapi.com/market/detail-84，鉴权方式相同，前端和后端均可直接调用。有技术对接问题可以联系平台客服获取支持。

注册探数API即可免费调试，接入以后系统里的汇率数字不用再靠人工维护。有定制需求或技术对接问题，平台提供专人答疑和对接服务。