# 农业银行实时汇率查询 · 外汇实时汇率 > 本文档为机器可读 Markdown，便于 AI / SDK 自动对接。页面原文：https://www.wapi.cn/api_detail/75/193.html > 纯文本地址：`https://www.wapi.cn/api_detail/75/193.html?format=md` ## 概览 - **接口名称**：外汇实时汇率 - **子接口**：农业银行实时汇率查询（ID `193`） - **接口简介**：提供的数据供参数，与人民币的兑换汇率，单位是100元；每分钟更新一次。具体汇率以办理业务时的实时汇率为准。 - **计费说明**：按次 - **请求地址**：`https://uaqy.api.storeapi.net/pyi/75/193`（支持 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) | | `ZRatTim` | 否 | String | 当前时间 | 17:54:02 | | `ZRtcBid` | 否 | String | 现钞买入价 | 701.02000000 | | `ZRthBid` | 否 | String | 现汇买入价 | 706.68000000 | | `ZRthOfr` | 否 | String | 现汇卖出价 | 708.10000000 | | `ZSellPrice` | 否 | String | 卖出汇率 | 709.52000000 | | `codeid` | 否 | Integer | 状态码，返回10000状态都会进行计费。具体说明可查看状态码说明 | 10000 | | `message` | 否 | String | 请求状态说明 | 返回成功 | | `retdata` | 否 | Array | 回数据集合,可能是数据、对象或者字符串 | | | `time` | 否 | String | 请求时传递的当前服务器时间戳 | 1566554294 | ## JSON 返回示例 ```json { "codeid": "10000", "message": "返回成功", "retdata": [ { "ZCcyNbr": "挪威克朗(NOK)", "ZRthBid": "78.50000000", "ZRtcBid": "75.97000000", "ZRthOfr": "78.81000000", "ZSellPrice": "79.13000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "澳大利亚元(AUD)", "ZRthBid": "476.55000000", "ZRtcBid": "461.24000000", "ZRthOfr": "478.47000000", "ZSellPrice": "480.38000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "瑞士法郎(CHF)", "ZRthBid": "714.56000000", "ZRtcBid": "691.60000000", "ZRthOfr": "717.43000000", "ZSellPrice": "720.30000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "英镑(GBP)", "ZRthBid": "861.28000000", "ZRtcBid": "833.19000000", "ZRthOfr": "864.31000000", "ZSellPrice": "867.33000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "日元(JPY)", "ZRthBid": "6.61700000", "ZRtcBid": "6.41200000", "ZRthOfr": "6.64000000", "ZSellPrice": "6.66300000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "瑞典克朗(SEK)", "ZRthBid": "72.77000000", "ZRtcBid": "70.43000000", "ZRthOfr": "73.06000000", "ZSellPrice": "73.35000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "澳门元(MOP)", "ZRthBid": "87.68000000", "ZRtcBid": "84.52000000", "ZRthOfr": "87.68000000", "ZSellPrice": "87.68000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "欧元(EUR)", "ZRthBid": "780.24000000", "ZRtcBid": "754.79000000", "ZRthOfr": "782.98000000", "ZSellPrice": "785.72000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "新加坡元(SGD)", "ZRthBid": "508.76000000", "ZRtcBid": "492.17000000", "ZRthOfr": "510.55000000", "ZSellPrice": "512.33000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "泰铢(THB)", "ZRthBid": "22.96000000", "ZRtcBid": "22.22000000", "ZRthOfr": "23.05000000", "ZSellPrice": "23.15000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "索莫尼(TJS)", "ZRthBid": "73.04000000", "ZRtcBid": "70.48000000", "ZRthOfr": "73.04000000", "ZSellPrice": "73.04000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "港元(HKD)", "ZRthBid": "90.11000000", "ZRtcBid": "89.39000000", "ZRthOfr": "90.29000000", "ZSellPrice": "90.47000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "丹麦克朗(DKK)", "ZRthBid": "104.61000000", "ZRtcBid": "101.24000000", "ZRthOfr": "105.03000000", "ZSellPrice": "105.45000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "韩国圆(KRW)", "ZRthBid": "0.56400000", "ZRtcBid": "0.56400000", "ZRthOfr": "0.58500000", "ZSellPrice": "0.60600000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "加拿大元(CAD)", "ZRthBid": "529.56000000", "ZRtcBid": "512.55000000", "ZRthOfr": "531.69000000", "ZSellPrice": "533.82000000", "ZRatTim": "17:54:02" }, { "ZCcyNbr": "美元(USD)", "ZRthBid": "706.68000000", "ZRtcBid": "701.02000000", "ZRthOfr": "708.10000000", "ZSellPrice": "709.52000000", "ZRatTim": "17:54:02" } ], "time": 1566554294 } ``` ## 状态码说明 | 状态码 | 说明 | | --- | --- | | `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/193.html`