## 匯率換算 >[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 } ~~~