## 汇率换算 >[danger]### 免费接口，每日100次免费调用，会员可不限次数调用，购买[API会员](https://market.topthink.com/product/210)  > 外汇报价，货币汇率，包含三个接口：常用汇率查询、货币列表和实时汇率查询换算 每日100次免费调用 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ## 接口1：常用汇率查询 > 汇率查询，数据仅供参考，交易时以银行柜台成交价为准 ### 请求地址 ``` GET https://api.topthink.com/exchange/query ``` ### 请求参数（无） ### SDK调用 ``` $client = new Client("YourAppCode"); // 常用汇率查询 $result = $client->exchangeQuery() ->request(); ``` 返回示例： ~~~ { "message": "查询成功", "data": { "update": "2016-07-22 10:32:31", "list": [ [ "美元", /*货币名称*/ "100", /*交易单位*/ "665.63", /*现汇买入价*/ "660.3", /*现钞买入价*/ "668.3", /*现钞卖出价*/ "666.69" /*中行折算价*/ ], [ "港币", "100", "85.83", "85.14", "86.15", "85.96" ], [ "日元", "100", "6.2771", "6.0834", "6.3211", "6.3014" ], [ "欧元", "100", "732.74", "710.13", "737.88", "735.79" ], [ "英镑", "100", "879.28", "852.15", "885.46", "879.01" ] ] }, "code": 0 } ~~~ ## 接口2：货币列表 > 支持的货币列表 ### 请求地址 ``` https://api.topthink.com/exchange/currency ``` ### 请求参数（无） ### SDK调用 ``` $client = new Client("YourAppCode"); // 获取货币列表 $result = $client->exchangeCurrency() ->request(); ``` 返回示例： ~~~ { "message": "查询成功", "data": { "list": [ { "name": "人民币", /*货币名称*/ "code": "CNY" /*货币代码*/ }, { "name": "美元", "code": "USD" }, { "name": "日元", "code": "JPY" }, { "name": "欧元", "code": "EUR" }, { "name": "英镑", "code": "GBP" }, ... ] }, "code": 0 } ~~~ ## 接口3：实时汇率查询 实时货币汇率查询换算，数据仅供参考，交易时以银行柜台成交价为准 ### 请求地址 ``` https://api.topthink.com/exchange/convert ``` ### 请求参数 |名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是 |string| 用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | |from | 是 | string | 转换汇率前的货币代码 | |to | 是 | string | 转换汇率成的货币代码 | ### SDK调用 ``` $client = new Client("YourAppCode"); // 查询实时汇率 $result = $client->exchangeConvert() ->withFrom() ->withTo() ->request(); ``` 返回示例： ~~~ { "message": "查询成功", "data": [ { "currencyF": "JPY", /*货币代码*/ "currencyF_Name": "日元", /*货币名称*/ "currencyT": "BHD", /*货币代码*/ "currencyT_Name": "巴林第纳尔", /*货币名称*/ "currencyFD": 1, "exchange": "0.0032685972", /*当前汇率*/ "result": "0.0032",/*当前汇率*/ "updateTime": "2014-11-07 13:58:02" }, { "currencyF": "BHD", "currencyF_Name": "巴林第纳尔", "currencyT": "JPY", "currencyT_Name": "日元", "currencyFD": 1, "exchange": "305.9416445623", "result": 305.9416, "updateTime": "2014-11-07 13:58:01" } ], "code": 0 } ~~~