# 光大银行实时汇率查询 · 外汇实时汇率 > 本文档为机器可读 Markdown，便于 AI / SDK 自动对接。页面原文：https://www.wapi.cn/api_detail/75/191.html > 纯文本地址：`https://www.wapi.cn/api_detail/75/191.html?format=md` ## 概览 - **接口名称**：外汇实时汇率 - **子接口**：光大银行实时汇率查询（ID `191`） - **接口简介**：提供的数据供参数，与人民币的兑换汇率，单位是100元；每分钟更新一次。具体汇率以办理业务时的实时汇率为准。 - **计费说明**：按次 - **请求地址**：`https://uaqy.api.storeapi.net/pyi/75/191`（支持 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:53 | | `ZRtcBid` | 否 | String | 现钞买入价 | 0.5875 | | `ZRtcOfr` | 否 | String | 现钞卖出价 | 0.5641 | | `ZRthBid` | 否 | String | 现汇买入价 | 0.5875 | | `ZRthOfr` | 否 | String | 现汇卖出价 | 0.5829 | | `codeid` | 否 | Integer | 状态码，返回10000状态都会进行计费。具体说明可查看状态码说明 | 10000 | | `message` | 否 | String | 请求状态说明 | 返回成功 | | `retdata` | 否 | Array | 回数据集合,可能是数据、对象或者字符串 | | | `time` | 否 | String | 请求时传递的当前服务器时间戳 | 1566550692 | ## JSON 返回示例 ```json { "codeid": "10000", "message": "返回成功", "retdata": [ { "ZCcyNbr": "美元(USD)", "ZRthBid": "709.9348", "ZRtcBid": "709.9348", "ZRthOfr": "707.1018", "ZRtcOfr": "701.1527", "ZRatTim": "16:53" }, { "ZCcyNbr": "英镑(GBP)", "ZRthBid": "868.0930", "ZRtcBid": "868.0930", "ZRthOfr": "861.1760", "ZRtcOfr": "833.5077", "ZRatTim": "16:53" }, { "ZCcyNbr": "港币(HKD)", "ZRthBid": "90.5096", "ZRtcBid": "90.5096", "ZRthOfr": "90.1482", "ZRtcOfr": "89.4256", "ZRatTim": "16:53" }, { "ZCcyNbr": "瑞士法郎(CHF)", "ZRthBid": "720.5321", "ZRtcBid": "720.5321", "ZRthOfr": "714.7909", "ZRtcOfr": "691.8257", "ZRatTim": "16:53" }, { "ZCcyNbr": "瑞典克郎(SEK)", "ZRthBid": "73.4528", "ZRtcBid": "73.4528", "ZRthOfr": "72.8676", "ZRtcOfr": "70.5264", "ZRatTim": "16:53" }, { "ZCcyNbr": "丹麦克郎(DKK)", "ZRthBid": "105.5545", "ZRtcBid": "105.5545", "ZRthOfr": "104.7135", "ZRtcOfr": "101.3492", "ZRatTim": "16:53" }, { "ZCcyNbr": "挪威克郎(NOK)", "ZRthBid": "79.1755", "ZRtcBid": "79.1755", "ZRthOfr": "78.5447", "ZRtcOfr": "76.0211", "ZRatTim": "16:53" }, { "ZCcyNbr": "日元(JPY)", "ZRthBid": "6.6703", "ZRtcBid": "6.6703", "ZRthOfr": "6.6171", "ZRtcOfr": "6.4045", "ZRatTim": "16:53" }, { "ZCcyNbr": "加拿大元(CAD)", "ZRthBid": "534.0152", "ZRtcBid": "534.0152", "ZRthOfr": "529.7600", "ZRtcOfr": "512.7396", "ZRatTim": "16:53" }, { "ZCcyNbr": "澳大利亚元(AUD)", "ZRthBid": "480.6428", "ZRtcBid": "480.6428", "ZRthOfr": "476.8130", "ZRtcOfr": "461.4937", "ZRatTim": "16:53" }, { "ZCcyNbr": "新加坡元(SGD)", "ZRthBid": "512.7770", "ZRtcBid": "512.7770", "ZRthOfr": "508.6912", "ZRtcOfr": "492.3477", "ZRatTim": "16:53" }, { "ZCcyNbr": "欧元(EUR)", "ZRthBid": "786.9673", "ZRtcBid": "786.9673", "ZRthOfr": "780.6967", "ZRtcOfr": "755.6140", "ZRatTim": "16:53" }, { "ZCcyNbr": "澳门元(MOP)", "ZRthBid": "87.7847", "ZRtcBid": "87.7847", "ZRthOfr": "87.4343", "ZRtcOfr": "86.7334", "ZRatTim": "16:53" }, { "ZCcyNbr": "泰国铢(THB)", "ZRthBid": "23.1430", "ZRtcBid": "23.1430", "ZRthOfr": "22.9586", "ZRtcOfr": "22.2210", "ZRatTim": "16:53" }, { "ZCcyNbr": "新西兰元(NZD)", "ZRthBid": "453.8747", "ZRtcBid": "453.8747", "ZRthOfr": "450.2581", "ZRtcOfr": "435.7920", "ZRatTim": "16:53" }, { "ZCcyNbr": "韩圆(KRW)", "ZRthBid": "0.5875", "ZRtcBid": "0.5875", "ZRthOfr": "0.5829", "ZRtcOfr": "0.5641", "ZRatTim": "16:53" } ], "time": 1566550692 } ``` ## 状态码说明 | 状态码 | 说明 | | --- | --- | | `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/191.html`