# 交通银行实时汇率查询 · 外汇实时汇率 > 本文档为机器可读 Markdown，便于 AI / SDK 自动对接。页面原文：https://www.wapi.cn/api_detail/75/192.html > 纯文本地址：`https://www.wapi.cn/api_detail/75/192.html?format=md` ## 概览 - **接口名称**：外汇实时汇率 - **子接口**：交通银行实时汇率查询（ID `192`） - **接口简介**：提供的数据供参数，与人民币的兑换汇率，单位是100元；每分钟更新一次。具体汇率以办理业务时的实时汇率为准。 - **计费说明**：按次 - **请求地址**：`https://uaqy.api.storeapi.net/pyi/75/192`（支持 http/https） - **请求方式**：`GET,POST` - **返回格式**：`json,xml` - **Content-Type（POST）**：`application/x-www-form-urlencoded;charset=utf-8` ## 子接口列表 - `188` 招商银行实时汇率查询 - `189` 中国银行实时汇率查询 - `190` 工商银行实时汇率查询 - `191` 光大银行实时汇率查询 - `192` 交通银行实时汇率查询 ← 当前 - `193` 农业银行实时汇率查询 ## 请求参数 | 名称 | 必填 | 类型 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `appid` | 是 | String | 应用ID，在后台我的应用查看或者添加 | 1 | | `format` | 否 | String | 返回数据格式类型，每个接口已经说明支持返回格式:json,xml, jsonp调用方法说明 | json | | `sign` | 是 | String | 1.使用Md5方式验证，参数按一定规则md5后返回的字符串，详情点击这里阅读 2.使用Hash验证方式，直接跟上密钥即可。如何设置hash验证 通过我的应用里面修改验证方式 | 52a9dbe274a5c537bbf7a53e2d66c09f | | `time` | 否 | String | 请求时传递的当前服务器时间戳 | 1545829466 | ## 签名（MD5） 按参数名排序后拼接「键名+值」，空值不参与；末尾直接追加 32 位密钥（密钥不写键名）： ``` sign = MD5(appid1formatjsontime1545829466{secret}) ``` 说明：示例中 `appid` 默认为 `1`，请替换为「我的应用」中的 appid；密钥为应用 Secret。 ## 返回参数 | 名称 | 必填 | 类型 | 说明 | 示例 | | --- | --- | --- | --- | --- | | `ZCcyNbr` | 否 | String | 币种类别 | 美元(USD/CNY) | | `ZCper` | 否 | String | 单位 | 100 | | `ZRatTim` | 否 | String | 当前时间 | 17:04:07 | | `ZRtcBid` | 否 | String | 现钞买入价 | 701.06 | | `ZRtcOfr` | 否 | String | 现钞卖出价 | 709.83 | | `ZRthBid` | 否 | String | 现汇买入价 | 706.87 | | `ZRthOfr` | 否 | String | 现汇卖出价 | 709.83 | | `codeid` | 否 | Integer | 状态码，返回10000状态都会进行计费。具体说明可查看状态码说明 | 10000 | | `message` | 否 | String | 请求状态说明 | 返回成功 | | `retdata` | 否 | Array | 回数据集合,可能是数据、对象或者字符串 | | | `time` | 否 | String | 请求时传递的当前服务器时间戳 | 1566551650 | ## JSON 返回示例 ```json { "codeid": "10000", "message": "返回成功", "retdata": [ { "ZCcyNbr": "澳大利亚元(AUD\/CNY)", "ZCper": "100", "ZRthBid": "477.10", "ZRtcBid": "463.45", "ZRthOfr": "480.44", "ZRtcOfr": "480.44", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "加拿大元(CAD\/CNY)", "ZCper": "100", "ZRthBid": "529.76", "ZRtcBid": "512.74", "ZRthOfr": "534.00", "ZRtcOfr": "534.00", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "瑞士法郎(CHF\/CNY)", "ZCper": "100", "ZRthBid": "714.67", "ZRtcBid": "691.71", "ZRthOfr": "720.41", "ZRtcOfr": "720.41", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "丹麦克郎(DKK\/CNY)", "ZCper": "100", "ZRthBid": "104.71", "ZRtcBid": "101.35", "ZRthOfr": "105.55", "ZRtcOfr": "105.55", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "欧元(EUR\/CNY)", "ZCper": "100", "ZRthBid": "781.03", "ZRtcBid": "755.56", "ZRthOfr": "786.51", "ZRtcOfr": "786.51", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "英镑(GBP\/CNY)", "ZCper": "100", "ZRthBid": "861.51", "ZRtcBid": "833.41", "ZRthOfr": "867.55", "ZRtcOfr": "867.55", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "港币(HKD\/CNY)", "ZCper": "100", "ZRthBid": "90.14", "ZRtcBid": "89.42", "ZRthOfr": "90.50", "ZRtcOfr": "90.50", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "日元(JPY\/CNY)", "ZCper": "100000", "ZRthBid": "6617.54", "ZRtcBid": "6405.04", "ZRthOfr": "6664.02", "ZRtcOfr": "6664.02", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "韩元(KRW\/CNY)", "ZCper": "100000", "ZRthBid": "-", "ZRtcBid": "563.94", "ZRthOfr": "606.04", "ZRtcOfr": "606.04", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "澳门元(MOP\/CNY)", "ZCper": "100", "ZRthBid": "87.52", "ZRtcBid": "86.82", "ZRthOfr": "87.86", "ZRtcOfr": "87.86", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "挪威克郎(NOK\/CNY)", "ZCper": "100", "ZRthBid": "78.57", "ZRtcBid": "76.05", "ZRthOfr": "79.19", "ZRtcOfr": "79.19", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "新西兰元(NZD\/CNY)", "ZCper": "100", "ZRthBid": "450.28", "ZRtcBid": "435.81", "ZRthOfr": "453.88", "ZRtcOfr": "453.88", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "菲律宾比索(PHP\/CNY)", "ZCper": "100", "ZRthBid": "-", "ZRtcBid": "13.06", "ZRthOfr": "-", "ZRtcOfr": "-", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "瑞典克郎(SEK\/CNY)", "ZCper": "100", "ZRthBid": "72.88", "ZRtcBid": "70.54", "ZRthOfr": "73.46", "ZRtcOfr": "73.46", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "新加坡元(SGD\/CNY)", "ZCper": "100", "ZRthBid": "508.90", "ZRtcBid": "492.30", "ZRthOfr": "512.46", "ZRtcOfr": "512.46", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "泰铢(THB\/CNY)", "ZCper": "100", "ZRthBid": "22.95", "ZRtcBid": "22.22", "ZRthOfr": "23.13", "ZRtcOfr": "23.13", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "新台币(TWD\/CNY)", "ZCper": "100", "ZRthBid": "-", "ZRtcBid": "21.70", "ZRthOfr": "-", "ZRtcOfr": "23.50", "ZRatTim": "17:04:07" }, { "ZCcyNbr": "美元(USD\/CNY)", "ZCper": "100", "ZRthBid": "706.87", "ZRtcBid": "701.06", "ZRthOfr": "709.83", "ZRtcOfr": "709.83", "ZRatTim": "17:04:07" } ], "time": 1566551650 } ``` ## 状态码说明 | 状态码 | 说明 | | --- | --- | | `10000` | 返回成功 | | `10001` | appid必须指定，可以我的应用里面查看 | | `10002` | sign值必须指定，加密规则请前往帮助中心查看 | | `10003` | sign值验证不通过，加密规则请前往帮助中心查看 | | `10004` | 时差不能超过10分钟，可以不传递这个参数，注意时间戳单位是秒 | | `10005` | appid错误，请检查appid值,前往会员中心->我的应用查看或添加 | | `10006` | 当前IP地址未授权，请前往用户中心->我的应用添加ip{@info} | | `10007` | 应用被禁用，请联系客服处理 | | `10008` | 应用内没有该接口，请到我的应用里面添加这个接口 | | `10009` | api接口不存在 | | `10010` | 您没有添加该api接口 | | `10011` | api已经到期 | | `10012` | 没有订购任何api,请前往购买后再操作 | | `10013` | 该接口已经暂停使用 | | `10014` | 未知的错误，可以联系客服处理 | | `10015` | 参数个数错误 | | `10019` | {@info} | | `10017` | time必须是整型 | | `10018` | 次数不足 | | `10020` | 子接口不存在,可能已经被关闭 | | `10021` | 服务器发生错误 | | `10022` | 帐户余额不足，请充值！ | | `10023` | 订单提交成功，等待回调结果 | | `10024` | 调试模式数据 | | `10025` | 查无数据 | ## 对接提示 1. 先在挖数据（wapi.cn）创建应用，获取 `appid` 与密钥。 2. 按上方参数组装请求，计算 `sign` 后调用接口地址。 3. 可用在线测试工具：`https://www.wapi.cn/api_debug/75/192.html`