汇率查询与换算

接口标识: exratequery 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

汇率查询与换算接口基于人民币基准的银行牌价数据，一个接口三种用法：查询实时牌价（可指定币种或不传返回全部支持币种，含折算价、现汇买入卖出、现钞买入卖出五档价格，传入金额自动折算人民币）、查询历史每日牌价（单日、整月或区间三选一，区间最长90天，周末与节假日不发布）、查询支持币种列表。牌价为100外币兑人民币口径，同时给出1外币的单位换算价；不提供币种间交叉查询。适合跨境支付、留学差旅、外贸报价与财务记账换算场景。参考牌价非交易价，实际兑换以银行或持牌机构报价为准。

详细介绍

![汇率查询与换算接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_exratequery__1794363415_657d4c2812b4.png)

跨境收款、留学换汇、外贸报价都要盯汇率，人工查牌价再按计算器换算既慢又容易错。汇率查询与换算接口一次调用即得银行牌价与折算结果。

## 接口概述
面向跨境支付、留学差旅、外贸与财务记账场景，接口基于人民币基准的银行牌价数据，覆盖三种查询动作：rate查实时牌价，可指定币种或不传返回全部支持币种，每种货币给出100外币基准的折算价、现汇买入卖出、现钞买入卖出五档价格，并附1外币的单位换算价；history查历史每日牌价，支持单日、整月或日期区间（最长90天）三种时间口径；currencies查支持的币种列表。传入换算金额时直接返回折算后的人民币金额。牌价数据非交易价，响应固定附带免责声明。

## 核心能力
1. **实时牌价**：指定币种单查或不传全查，五档价格与单位换算价一次返回，附牌价日期与时间。
2. **金额换算**：rate动作下传入amount（外币金额），按单位换算价直接返回converted_amount人民币金额。
3. **历史回溯**：按单日、整月或区间查历史每日牌价，区间跨度最长90天，返回每日折算价与现汇现钞四价。
4. **币种清单**：currencies动作返回全部支持币种的代码与名称，便于前端做下拉选择。
5. **输入宽容**：货币代码自动转大写，日期支持YYYY-MM-DD或YYYYMMDD，月份支持YYYYMM或YYYY-MM。

## 产品优势
1. **接入简单**：单次POST同步返回，action一个参数切换三种查询，无需对接多个数据源。
2. **口径规范**：统一人民币基准银行牌价，字段结构固定，五档价格语义清晰。
3. **合规稳妥**：响应固定携带免责声明，明确参考牌价非交易价，实际兑换以银行或持牌机构报价为准。
4. **数据可靠**：周末与节假日上游不发布牌价时明确提示无数据，不返回过期牌价充数。
5. **生态开放**：支持MCP生态接入，与平台其余金融数据查询类接口共用签名与响应结构。

## 效果展示
一句话理解：它就像银行大厅的电子牌价屏加一台换算计算器——你报币种和金额，它把牌价和折算结果一起报给你。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| action | `"rate"` | 查询动作：rate实时牌价 / history历史牌价 / currencies币种列表 |
| currency | `"USD"` | 货币ISO 4217代码，自动转大写；rate不传则返回全部币种 |
| amount | `100` | 外币换算金额，传入即返回折算后的人民币金额，仅rate生效 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 查询动作回显 | `"rate"` | `action` |
| 牌价基准 | `"CNY"` | `base_currency`，固定人民币基准 |
| 货币与名称 | `"USD"` / `"美元"` | `list[].currency`、`list[].name` |
| 单位换算价 | `7.1234` | `list[].rate`，1外币兑人民币 |
| 五档牌价（100外币基准） | 折算价、现汇买入卖出、现钞买入卖出 | `list[].price_per_100` |
| 换算金额 | `100` | `amount`，回显传入的外币金额 |
| 折算结果 | `712.34` | `list[].converted_amount`，人民币金额 |
| 牌价日期时间 | `"2026-11-12"` / `"10:30:00"` | `list[].date`、`list[].time` |

API请求示例：

```text
POST /api/exratequery
action=rate&currency=USD&amount=100
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "action": "rate",
    "base_currency": "CNY",
    "amount": 100,
    "list": [
      {
        "currency": "USD",
        "name": "美元",
        "rate": 7.1234,
        "price_per_100": {
          "middle": 712.34,
          "spot_buying": 709.12,
          "spot_selling": 715.01,
          "cash_buying": 686.55,
          "cash_selling": 717.9
        },
        "converted_amount": 712.34,
        "date": "2026-11-12",
        "time": "10:30:00"
      }
    ],
    "total": 1,
    "disclaimer": "参考银行牌价，非交易价，实际兑换以银行或持牌机构报价为准，不构成交易建议。"
  },
  "request_id": "req-exratequery-demo01"
}
```

rate为单位换算价（折算价除以100），converted_amount等于amount乘以rate；改传action=history并给currency加时间范围，即可查该币种的历史每日牌价。

## 应用场景
1. **跨境电商**：商品定价与结算页实时展示人民币折算价。
2. **留学差旅**：行前换汇估算与费用报销折算。
3. **外贸报价**：合同报价单按当日牌价折算外币金额。
4. **财务记账**：外币收支入账时取历史某日牌价折算本位币。

## 应用案例
一家跨境电商的财务每月底要按当日牌价把外币应收折算成人民币记账，此前逐个币种查银行网页再手工换算；接入接口后记账系统按历史牌价动作取数自动折算，月结效率明显提升。

一个留学服务机构的顾问要给家长估算学费与生活费换汇成本，过去翻牌价截图发群常过期；现在小程序实时调用接口展示牌价与折算金额，并附免责声明，沟通更规范。

一家外贸公司的业务员报价时要在美元与人民币之间换算，手算经常把折算价与现汇价用混；报价工具接入接口后按五档牌价明细展示，报价口径统一不再有争议。

常见问题

Q：支持哪些币种？

A：传action=currencies即返回全部支持币种的代码与名称列表；实时与历史牌价查询覆盖同一币种范围，牌价以人民币为基准（100外币兑人民币口径）。

Q：能直接查美元兑欧元这类交叉汇率吗？

A：不能。数据为人民币基准的银行牌价，不提供币种间交叉查询；如需交叉汇率，可分别查询两个币种对人民币的牌价后自行折算。

Q：历史牌价能查多久以前的？

A：支持单日（date）、整月（month）或日期区间（start_date+end_date）三种时间口径，区间跨度最长90天；周末与节假日上游不发布牌价，查询这些日期会返回无牌价数据提示。

Q：牌价可以直接当交易价用吗？

A：不可以。接口返回的是参考性银行牌价，非交易价，实际兑换以银行或持牌机构报价为准；响应中的disclaimer字段固定携带该免责声明，建议在产品展示时同步呈现。

汇率查询汇率换算银行牌价外汇数据跨境支付财务工具历史汇率

接口地址： https://www.phpwc.cn/api/exratequery

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`action`	string	选填	`rate`	查询动作：rate（实时银行牌价，默认）/ history（历史每日牌价）/ currencies（支持的币种列表）
`currency`	string	选填	-	货币 ISO 4217 代码，如 USD / EUR / JPY / GBP / HKD，本站自动转大写；action=rate 选填（不传返回全部支持币种牌价），action=history 必填。上游为人民币基准牌价，不提供币种成对交叉查询
`amount`	float	选填	-	换算金额（外币数量），传入时按单位换算价（折算价/100）返回换算结果 converted_amount（人民币），仅 action=rate 生效
`date`	string	选填	-	历史单日，YYYY-MM-DD，仅 action=history 生效；与 month、start_date+end_date 三者互斥
`month`	string	选填	-	历史月份，YYYYMM 如 202610，仅 action=history 生效；与其余时间范围互斥
`start_date`	string	选填	-	历史区间起始，YYYY-MM-DD，须与 end_date 成对，仅 action=history 生效；与 date、month 互斥
`end_date`	string	选填	-	历史区间结束，YYYY-MM-DD；区间跨度上限 90 天（上游硬限，本站前置拦截）

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`action`	string	回显查询动作：rate / history / currencies
`base_currency`	string	牌价基准币种，固定 CNY（上游为人民币基准银行牌价）
`quote_currency`	string	查询币种（仅 action=history）
`range`	string	回显历史时间范围（仅 action=history），object：date 或 month 或 start_date/end_date/days
`amount`	float	回显换算金额（仅 action=rate 且传入 amount 时）
`list`−	array	牌价列表
`currency`	string	货币代码
`name`	string	货币名称（action=rate / currencies）
`rate`	float	单位换算价：1 外币 = rate 元人民币（rate=折算价/100；history 档按当日折算价计算）
`price_per_100`	string	100 外币基准六档牌价（仅 action=rate），object：middle 折算价 / spot_buying 现汇买入 / spot_selling 现汇卖出 / cash_buying 现钞买入 / cash_selling 现钞卖出
`converted_amount`	float	换算结果（人民币，= amount × rate；仅 action=rate 且传入 amount 时）
`date`	string	牌价日期（rate=牌价当日；history=发布日期 publish_time）
`time`	string	牌价时间 HH:MM:SS（仅 action=rate）
`middle_rate`	float	折算价（100 外币基准，仅 action=history）
`buying_rate`	float	现汇买入价（仅 action=history）
`selling_rate`	float	现汇卖出价（仅 action=history）
`cash_buying_rate`	float	现钞买入价（仅 action=history）
`cash_selling_rate`	float	现钞卖出价（仅 action=history）
`total`	int	列表条数
`disclaimer`	string	免责声明：参考银行牌价，非交易价，实际兑换以银行或持牌机构报价为准，不构成交易建议
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试