# 工商银行实时汇率查询 · 外汇实时汇率 > 本文档为机器可读 Markdown，便于 AI / SDK 自动对接。页面原文：https://www.wapi.cn/api_detail/75/190.html > 纯文本地址：`https://www.wapi.cn/api_detail/75/190.html?format=md` ## 概览 - **接口名称**：外汇实时汇率 - **子接口**：工商银行实时汇率查询（ID `190`） - **接口简介**：提供的数据供参数，与人民币的兑换汇率，单位是100元；每分钟更新一次。具体汇率以办理业务时的实时汇率为准。 - **计费说明**：按次 - **请求地址**：`https://uaqy.api.storeapi.net/pyi/75/190`（支持 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 | 币种类别 | 韩元(KRW) | | `ZRatTim` | 否 | String | 当前时间 | 16:24:38 | | `ZRtcBid` | 否 | String | 现钞买入价 | 0.5665 | | `ZRtcOfr` | 否 | String | 现钞卖出价 | 0.5875 | | `ZRthBid` | 否 | String | 现汇买入价 | -- | | `ZRthOfr` | 否 | String | 现汇卖出价 | 0.5875 | | `codeid` | 否 | Integer | 状态码，返回10000状态都会进行计费。具体说明可查看状态码说明 | 10000 | | `message` | 否 | String | 请求状态说明 | 返回成功 | | `retdata` | 否 | Array | 回数据集合,可能是数据、对象或者字符串 | | | `time` | 否 | String | 请求时传递的当前服务器时间戳 | 1566548753 | ## JSON 返回示例 ```json { "codeid": "10000", "message": "返回成功", "retdata": [ { "ZCcyNbr": "英镑(GBP)", "ZRthBid": "861.37", "ZRtcBid": "836.74", "ZRthOfr": "867.77", "ZRtcOfr": "867.77", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "港币(HKD)", "ZRthBid": "90.18", "ZRtcBid": "89.45", "ZRthOfr": "90.55", "ZRtcOfr": "90.55", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "美元(USD)", "ZRthBid": "706.99", "ZRtcBid": "701.33", "ZRthOfr": "709.97", "ZRtcOfr": "709.97", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "瑞士法郎(CHF)", "ZRthBid": "715.73", "ZRtcBid": "695.26", "ZRthOfr": "721.04", "ZRtcOfr": "721.04", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "新加坡元(SGD)", "ZRthBid": "509.07", "ZRtcBid": "494.51", "ZRthOfr": "512.85", "ZRtcOfr": "512.85", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "巴基斯坦卢比(PKR)", "ZRthBid": "4.4217", "ZRtcBid": "4.2832", "ZRthOfr": "4.4545", "ZRtcOfr": "4.4545", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "瑞典克朗(SEK)", "ZRthBid": "72.99", "ZRtcBid": "70.91", "ZRthOfr": "73.54", "ZRtcOfr": "73.54", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "丹麦克朗(DKK)", "ZRthBid": "104.83", "ZRtcBid": "101.83", "ZRthOfr": "105.61", "ZRtcOfr": "105.61", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "挪威克朗(NOK)", "ZRthBid": "78.65", "ZRtcBid": "76.40", "ZRthOfr": "79.24", "ZRtcOfr": "79.24", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "日元(JPY)", "ZRthBid": "6.6206", "ZRtcBid": "6.4313", "ZRthOfr": "6.6698", "ZRtcOfr": "6.6698", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "加拿大元(CAD)", "ZRthBid": "530.18", "ZRtcBid": "515.01", "ZRthOfr": "534.11", "ZRtcOfr": "534.11", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "澳大利亚元(AUD)", "ZRthBid": "477.13", "ZRtcBid": "463.49", "ZRthOfr": "480.68", "ZRtcOfr": "480.68", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "林吉特(MYR)", "ZRthBid": "168.42", "ZRtcBid": "--", "ZRthOfr": "169.67", "ZRtcOfr": "169.67", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "欧元(EUR)", "ZRthBid": "781.60", "ZRtcBid": "759.25", "ZRthOfr": "787.41", "ZRtcOfr": "787.41", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "卢布(RUB)", "ZRthBid": "10.76", "ZRtcBid": "10.43", "ZRthOfr": "10.84", "ZRtcOfr": "10.84", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "澳门元(MOP)", "ZRthBid": "87.54", "ZRtcBid": "86.84", "ZRthOfr": "87.91", "ZRtcOfr": "87.91", "ZRatTim": "16:24:37" }, { "ZCcyNbr": "泰国铢(THB)", "ZRthBid": "22.97", "ZRtcBid": "22.25", "ZRthOfr": "23.14", "ZRtcOfr": "23.14", "ZRatTim": "16:24:38" }, { "ZCcyNbr": "新西兰元(NZD)", "ZRthBid": "450.59", "ZRtcBid": "437.70", "ZRthOfr": "453.93", "ZRtcOfr": "453.93", "ZRatTim": "16:24:38" }, { "ZCcyNbr": "南非兰特(ZAR)", "ZRthBid": "46.59", "ZRtcBid": "44.32", "ZRthOfr": "46.93", "ZRtcOfr": "46.93", "ZRatTim": "16:24:38" }, { "ZCcyNbr": "哈萨克斯坦 坚戈(KZT)", "ZRthBid": "1.8264", "ZRtcBid": "1.7692", "ZRthOfr": "1.8399", "ZRtcOfr": "1.8399", "ZRatTim": "16:24:38" }, { "ZCcyNbr": "韩元(KRW)", "ZRthBid": "--", "ZRtcBid": "0.5665", "ZRthOfr": "0.5875", "ZRtcOfr": "0.5875", "ZRatTim": "16:24:38" } ], "time": 1566548753 } ``` ## 状态码说明 | 状态码 | 说明 | | --- | --- | | `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/190.html`