实时汇率查询 API 怎么用？从接口调用到实时汇率获取的完整教程

一、需求背景在做跨境电商、国际结算、外汇展示或多币种报价时经常需要接入一个稳定的汇率查询接口。本文以实时汇率查询换算接口为例演示如何通过 Java 发起请求并解析汇率数据。二、接口信息参数必填说明from是源币种代码如 CNYto是目标币种代码如 USDmoney否要换算的金额默认 1接口返回当前汇率和换算后的金额。三、Java 接入实战接口地址https://market.aliyun.com/detail/cmapi00065831 public static void main(String[] args) { String host https://market.aliyun.com/detail/cmapi00065831; String path /list; String method GET; String appcode 你自己的AppCode; MapString, String headers new HashMapString, String(); //最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105 headers.put(Authorization, APPCODE appcode); MapString, String querys new HashMapString, String(); try { /** * 重要提示如下: * HttpUtils请从 * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java * 下载 * * 相应的依赖请参照 * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml */ HttpResponse response HttpUtils.doGet(host, path, method, headers, querys); System.out.println(response.toString()); //获取response的body //System.out.println(EntityUtils.toString(response.getEntity())); } catch (Exception e) { e.printStackTrace(); } }四、返回结果{ code: 1, msg: 操作成功, data: { list: [ { currency: CNY, name: 人民币, logo: e9194120119fe795abc39e775f86a608.png }, { currency: USD, name: 美元, logo: 44aaa827691c01da179ffa62ed4de86e.png }, { currency: EUR, name: 欧元, logo: dec96feacabfca2c3609ba1a4d110da0.png }, { currency: JPY, name: 日元, logo: d1d23646f3358a27996ccacfe476f90a.png }, { currency: HKD, name: 港币, logo: 2a50f4517252f970db32311a995894e0.png }, { currency: KRW, name: 韩元, logo: f9667664f298b303817b1845195bf55f.png }, { currency: RUB, name: 卢布, logo: 0eb7eed2968577ef0af1500ad8b823f1.png }, { currency: GBP, name: 英镑, logo: 1a5b98637ca9fd951f9db3cf1cda7dbb.png }, { currency: SGD, name: 新加坡元, logo: ccb8f3b271635032ae5be56b169ae5a3.png }, { currency: TWD, name: 新台币, logo: 50c8ae652443b7745014ee17ee67ac37.png }, { currency: CAD, name: 加拿大元, logo: fd047bb5caeddd5469a0d23235eba8a9.png }, { currency: AUD, name: 澳大利亚元, logo: c58b8cd3658101ef5bbeaf90e008e967.png }, { currency: BRL, name: 巴西雷亚尔, logo: 96a8be3c9a0dc0b2c1d5c3ff2d73bb9e.png }, { currency: INR, name: 印度卢比, logo: fe08d31c60f89a7e46d3d6f047c6093d.png }, { currency: CHF, name: 瑞士法郎, logo: b29ca1dc01db9166bf2c9db53a32e1c6.png }, { currency: THB, name: 泰国铢, logo: 39e227361049f1bd2a208c4be301dc88.png }, { currency: MOP, name: 澳门元, logo: 5e67df8556fbf093b05e395979c4cd12.png }, { currency: NZD, name: 新西兰元, logo: 9493314c18f81c75f6273822b640c1ac.png }, { currency: ZAR, name: 南非兰特, logo: dfbd6bad644a1e564effd31a28118c63.png }, { currency: SEK, name: 瑞典克朗, logo: f73df70c3ede7cb9333a0eb12c1284dc.png }, { currency: IDR, name: 印尼卢比, logo: 406381ecc00f2eb744691d447feda372.png }, { currency: MXN, name: 墨西哥比索, logo: facd56f62a8cfde8acdce249ec1a1e55.png }, { currency: ARS, name: 阿根廷比索, logo: b516fc98bc3b63db771d7af12c6a0dcb.png }, { currency: MYR, name: 林吉特, logo: db2bd9c979410a5ddc57fb11d51f0609.png }, { currency: OMR, name: 阿曼里亚尔, logo: 87baf630887723a837faeff071854319.png }, { currency: EGP, name: 埃及镑, logo: 8e91c88e765d995d7745dcbbc6d314ec.png }, { currency: PKR, name: 巴基斯坦卢比, logo: c7e68bd00646480886b238ebd193975f.png }, { currency: PYG, name: 巴拉圭瓜拉尼, logo: c372752b80945c7bd3fd6142b5d87c70.png }, { currency: BHD, name: 巴林第纳尔, logo: c2701d4d7804f969bc58fa74fc1b2efd.png }, { currency: PAB, name: 巴拿马巴尔博亚, logo: e4d09db23f68ce9e122508a27c3532bb.png }, { currency: BMD, name: 百慕大元, logo: 383f9d33bb7fb318c121a7fd4f32ca86.png }, { currency: BGN, name: 保加利亚列弗, logo: 0d0982ed7310b2130f70a60771a4feeb.png }, { currency: ISK, name: 冰岛克朗, logo: 007d15ce54a6d434083f3ef9b1b660dc.png }, { currency: PLN, name: 波兰兹罗提, logo: 9889b0054eef5b96ec57e4cda4f72fee.png }, { currency: BOB, name: 玻利维亚诺, logo: 64e889091549c747da502c06488273d9.png }, { currency: BWP, name: 博茨瓦纳普拉, logo: 1b7f7f2821653c75ca4480ca3d7a456c.png }, { currency: DKK, name: 丹麦克朗, logo: 8ad9f49b35be81ad98e8f33f6b6edfb4.png }, { currency: PHP, name: 菲律宾比索, logo: 42fc0981bcdcc55cc1d86f2f3973a971.png }, { currency: COP, name: 哥伦比亚比索, logo: 5cf432fab4078450076096cf0a07bd05.png }, { currency: CUP, name: 古巴比索, logo: d90530a1e25a37be227cb9fd7f0dff2c.png }, { currency: KZT, name: 哈萨克斯坦坚戈, logo: 674116566fa787979b7816a408947de3.png }, { currency: ANG, name: 荷兰盾, logo: a33cd44fd67df6e175e99eee87f3988b.png }, { currency: GHS, name: 加纳塞地, logo: 16609755728f550d106a09fc696b0c6b.png }, { currency: CZK, name: 捷克克朗, logo: 5075222f3ab835fa0de84ede01c523d7.png }, { currency: ZWL, name: 津巴布韦元, logo: }, { currency: QAR, name: 卡塔尔里亚尔, logo: 08697ebaf839863b25c20aae5f511730.png }, { currency: KWD, name: 科威特第纳尔, logo: 172f50d2275e967b392725c806c28098.png }, { currency: HRK, name: 克罗地亚库纳, logo: 737633f5ab8882e5915e527e261f19fa.png }, { currency: KES, name: 肯尼亚先令, logo: 895f7cf4dd6656df6049e33f39a5c402.png }, { currency: LVL, name: 拉脱维亚拉特, logo: }, { currency: LAK, name: 老挝基普, logo: 87b1a1a1a96ef676824f4234db74c112.png }, { currency: LBP, name: 黎巴嫩镑, logo: f75ef373621155f7334532410a706931.png }, { currency: LTL, name: 立陶宛立特, logo: }, { currency: RON, name: 罗马尼亚列伊, logo: 91e73bc05f00b3c30cb1aa3bba870fba.png }, { currency: MUR, name: 毛里求斯卢比, logo: a070311efb9a5f6f082d11156d298a9b.png }, { currency: MNT, name: 蒙古图格里克, logo: 34142c9e735597a45215f07bc113fdab.png }, { currency: BDT, name: 孟加拉塔卡, logo: de614578d1d4451571c9f464bbcffca0.png }, { currency: PEN, name: 秘鲁新索尔, logo: f5192483f101f30c823f8b88299f3aae.png }, { currency: MAD, name: 摩洛哥迪拉姆, logo: 2e23fb23d3d95c75a290f3c7b5d0a923.png }, { currency: NOK, name: 挪威克朗, logo: 20c64ee84efc1ac61a44bae392510d12.png }, { currency: SAR, name: 沙特里亚尔, logo: ae790d83444d9d89eb351338d1e071c8.png }, { currency: LKR, name: 斯里兰卡卢比, logo: 94c1e9e5e4e627b7e7f5273ba6bbfbd7.png }, { currency: SOS, name: 索马里先令, logo: e2bf08c4abe9b1c6a62889ed59a5a4b8.png }, { currency: TZS, name: 坦桑尼亚先令, logo: 9aa648cd1c90e6e33f7a7003ff826cf6.png }, { currency: TND, name: 突尼斯第纳尔, logo: 73dfda31da8a1576d5a2e8865018b3a0.png }, { currency: TRY, name: 土耳其里拉, logo: c6c4ffcb30356aec448c6547e7ed71c2.png }, { currency: GTQ, name: 危地马拉格查尔, logo: 5df275ed8e94a11f889a9e693240d94c.png }, { currency: UYU, name: 乌拉圭比索, logo: 2ec2b7bac3ce97e5eb4809eb02afa242.png }, { currency: HUF, name: 匈牙利福林, logo: 6bcf806c058ed291a2e3f31c77593a89.png }, { currency: JMD, name: 牙买加元, logo: c9965ccf1832dade53452de63dad7a82.png }, { currency: ILS, name: 以色列谢克尔, logo: fce9d8cd0a270600867fbd802babc46d.png }, { currency: JOD, name: 约旦第纳尔, logo: e9f47d9ab4cc1cbfe08996b3abce971f.png }, { currency: VND, name: 越南盾, logo: d43ea055b93fb7db63fae5edaca85af5.png }, { currency: CLP, name: 智利比索, logo: 552d5b1cbd002baad8f7748f2433f65c.png }, { currency: PGK, name: 巴布亚新几内亚基那, logo: cdec8c9336003857ff86dae457470eb9.png }, { currency: KPW, name: 朝鲜圆, logo: cae5fa1499a8dd554edb6cf446f87909.png }, { currency: LSL, name: 莱索托洛提, logo: cce62c1167d462f1c527e53de9345e0e.png }, { currency: LYD, name: 利比亚第纳尔, logo: 5f2cee374ead86e0657987d0eb8aa8e7.png }, { currency: RWF, name: 卢旺达法郎, logo: 6f6409344da97e1dbb4860694adda556.png }, { currency: MMK, name: 缅甸元, logo: }, { currency: MWK, name: 马拉维克瓦查, logo: d3fefcdd020d6fc9c2e9dff9f23f3efb.png }, { currency: NIO, name: 尼加拉瓜科多巴, logo: 24e6435fec642c504b34e0b695f84fd9.png }, { currency: NPR, name: 尼泊尔卢比, logo: 6c6f34582e9918b3d611d1aee940a331.png }, { currency: SBD, name: 所罗门群岛元, logo: 5c475e41f32ec71444e7e693ba37adbd.png }, { currency: SCR, name: 塞舌尔法郎, logo: e71277a8b2fda662fdac8a40abfbd50e.png }, { currency: BND, name: 文莱元, logo: 36e87e3e9c6a04fbc13a5ef3ee815978.png }, { currency: SYP, name: 叙利亚镑, logo: 3b4dcdf5cbb953ad8cac1e50f0b8aeda.png }, { currency: DZD, name: 阿尔及利亚第纳尔, logo: a2d57abd4787138c0a80c25c0b3b4c30.png }, { currency: AED, name: 阿联酋迪拉姆, logo: 8db5d4b2e445e8fd183a2bea39739db3.png }, { currency: BBD, name: 巴巴多斯元, logo: fc0ed46a664a8365550f7de8ca1fe855.png }, { currency: AFN, name: 阿富汗尼, logo: ba82790a19ff3735357f7d3f9fe5048f.png }, { currency: ALL, name: 阿尔巴尼亚勒克, logo: 3823f018be866dcfd120177e38d15759.png }, { currency: AMD, name: 亚美尼亚德拉姆, logo: 5b54e00f8de9d39bb79b47af85d82890.png }, { currency: AOA, name: 安哥拉宽扎, logo: 76884e9b4a5808fb3a808b9546dc1e7f.png }, { currency: AWG, name: 阿鲁巴盾弗罗林, logo: 897d810a6c5a87c201196864bec703af.png }, { currency: AZN, name: 阿塞拜疆新马纳特, logo: 4867925f85a8e14e3c2fa66fb28772ca.png }, { currency: BAM, name: 波斯尼亚马尔卡, logo: 91581dd97c2afac4b06a5482df6d4c04.png }, { currency: BIF, name: 布隆迪法郎, logo: a8b270f5c46829ab8c9977e7787e89ca.png }, { currency: BSD, name: 巴哈马元, logo: 1decbccf02cfa7ee672f6550f12dab9f.png }, { currency: BTN, name: 不丹努扎姆, logo: 544da218217b4e8d5d9058c42e7457ab.png }, { currency: BYN, name: 白俄罗斯卢布, logo: }, { currency: BZD, name: 伯利兹美元, logo: b6e2d011d9989cf021878a267dc1b5f1.png }, { currency: CDF, name: 刚果法郎, logo: ac0a7fb56bb5f98b76a940d1641ab781.png }, { currency: CRC, name: 哥斯达黎加科朗, logo: d3227f3dc9343294629390c5597164f1.png }, { currency: CUC, name: 古巴可兑换比索, logo: }, { currency: CVE, name: 佛得角埃斯库多, logo: d5971b4d3c0322f8d6cfacb7eef22a08.png }, { currency: DJF, name: 吉布提法郎, logo: 437f5c4b15dda3e438f5a26e7436612a.png }, { currency: DOP, name: 多明尼加比索, logo: 22eb1117789f810fb9b274c8d5e87943.png }, { currency: NGN, name: 尼日利亚奈拉, logo: afdc52a56aa19598c2a18b2c3535ebe5.png }, { currency: ERN, name: 厄立特里亚纳克法, logo: 20a6a17fdb952453776064de968d2fc8.png }, { currency: ETB, name: 埃塞俄比亚比尔, logo: 065795b0203834dd6acf0119c2044a23.png }, { currency: FJD, name: 斐济元, logo: 6237faebdd2e552ed43edd1d1a1541c8.png }, { currency: FKP, name: 福克兰镑, logo: c93a7d273c2dff58b12157ce4280a132.png }, { currency: GEL, name: 格鲁吉亚拉里, logo: 9d7653a9a8f9ab4868054da9c26c5650.png }, { currency: GIP, name: 直布罗陀镑, logo: e0c1af911f8d40aef5e1c44a99d431b6.png }, { currency: GMD, name: 冈比亚达拉西, logo: db9e665b727021c2fe5d45fdde8d403f.png }, { currency: GNF, name: 几内亚法郎, logo: 66c763edfc7e296975472e9dd32e199d.png }, { currency: GYD, name: 圭亚那元, logo: 6a77c7114a32168ad238d5f91445830b.png }, { currency: HNL, name: 洪都拉斯伦皮拉, logo: 6a26ed8c939d4040ee7452c687e733c0.png }, { currency: HTG, name: 海地古德, logo: ba00ce23744443f971040b267e7149ba.png }, { currency: IQD, name: 伊拉克第纳尔, logo: a42e764dd8a0757ea0f58a619bba1610.png }, { currency: IRR, name: 伊朗里亚尔, logo: 4bcd6d84b7f0449580ba7991c9f25dab.png }, { currency: KGS, name: 吉尔吉斯斯坦索姆, logo: 88c561891dcdc97e7899eed202f3222f.png }, { currency: KHR, name: 柬埔寨瑞尔, logo: f34fd890b6de7ac3f0c680c15fe0a94c.png }, { currency: KMF, name: 科摩罗法郎, logo: }, { currency: KYD, name: 开曼群岛元, logo: 83f2f83c6a17a4ce30813fa2e3916cef.png }, { currency: LRD, name: 利比里亚元, logo: f0a85c5670b3dc7e97698ea36960450a.png }, { currency: MDL, name: 摩尔多瓦列伊, logo: 2c7edaf4772bfd63aadca64d5d8cb2f2.png }, { currency: MGA, name: 马尔加什阿里亚, logo: e5d9c12445b776de71d5ee9a5011e85a.png }, { currency: MKD, name: 马其顿第纳尔, logo: f97bc71a683c9c8cfeefd72cc92d63a2.png }, { currency: MVR, name: 马尔代夫拉菲亚, logo: c5ba6ffa8d22b48892574eec7e58072f.png }, { currency: MZN, name: 新莫桑比克梅蒂卡尔, logo: 1308b925b980030a44ac4da88e4d8a1d.png }, { currency: NAD, name: 纳米比亚元, logo: f67a0095fe720b4e3a55a5ae7b8e4169.png }, { currency: RSD, name: 塞尔维亚第纳尔, logo: 8601bf8b55edc422b98a898fdff8ffa1.png }, { currency: SDG, name: 苏丹镑, logo: e6e0a2763c5e933f5608187cdcbab475.png }, { currency: SHP, name: 圣圣赫勒拿镑, logo: 6bff3538f439deac118138731bd6550c.png }, { currency: SLL, name: 塞拉利昂利昂, logo: 017a3b623efa758d12ee2e93338bad70.png }, { currency: SRD, name: 苏里南元, logo: 641bf9c2f7f233fcbd9cec594915f8bb.png }, { currency: STD, name: 圣多美多布拉, logo: c84b5764851cf50e54bba0b923221dbd.png }, { currency: STN, name: 圣多美多布拉, logo: }, { currency: SZL, name: 斯威士兰里兰吉尼, logo: 0af3a2bf6c6eef8bcef6bb9ce5514578.png }, { currency: TJS, name: 塔吉克斯坦索莫尼, logo: ae3679583bf9c61794e0be2e30f0b238.png }, { currency: TMT, name: 土库曼斯坦马纳特, logo: }, { currency: TOP, name: 汤加潘加, logo: a5be94e998e450b112391ba784cda78a.png }, { currency: TTD, name: 特立尼达多巴哥元, logo: 2cac25b21fa24b2e15257d6dd4f483cc.png }, { currency: UAH, name: 乌克兰格里夫纳, logo: 7d1f901ed3fdc9c1d37d296b35d51fc1.png }, { currency: UGX, name: 乌干达先令, logo: 80ac66ccca5c8f7a15439423e9230552.png }, { currency: UZS, name: 乌兹别克斯坦苏姆, logo: 6b411678ed9ca9c666185aa0bc5321bb.png }, { currency: VEF, name: 委内瑞拉玻利瓦尔, logo: }, { currency: VES, name: 委内瑞拉主权玻利瓦尔, logo: 97e2fef0914e849d5c0f417ba9c3777e.png }, { currency: VUV, name: 瓦努阿图瓦图, logo: 605f56478f78751e843d8b8fcd744c19.png }, { currency: WST, name: 萨摩亚塔拉, logo: c1e810e330cfa39be8235dd18acf39e0.png }, { currency: XAF, name: 中非法郎, logo: 883931d6c11162ac1a1d90cfee4c49af.png }, { currency: XCD, name: 东加勒比元, logo: b7b716289285449ab14386c7651dc534.png }, { currency: XOF, name: 西非法郎, logo: 74e7ba4c7e47c28ec16a42cba8b5f55f.png }, { currency: XPF, name: 太平洋法郎, logo: 44e21cffcb004fdbcbd4b9fa1c5eedfc.png }, { currency: YER, name: 也门里亚尔, logo: ec9230c26ed466e5bd826953ba36f97f.png }, { currency: ZMW, name: 赞比亚克瓦查, logo: }, { currency: SVC, name: 萨尔瓦多科朗, logo: 9550357cb67bcf06562fd8e1264bf8f2.png }, { currency: MRU, name: 毛里塔尼亚乌吉亚, logo: }, { currency: CNH, name: 中国离岸人民币, logo: 595c79a79883924200c7e004ac612e58.png } ] } }字段说明from / from_name源币种代码 / 名称to / to_name目标币种代码 / 名称exchange当前汇率1 单位源币 多少目标币updatetime数据更新时间money换算后的金额五、应用场景跨境电商平台自动将商品价格换算成用户所在国的货币。旅行换汇助手用户输入外币金额实时显示对应人民币价格。金融投资分析监控汇率波动辅助外汇投资决策。企业财务系统自动计算跨境应收/应付账款的本币金额。六、工程建议精度处理金额计算使用 BigDecimal避免 double 精度丢失缓存策略汇率数据缓存 5 分钟减少接口调用量异常处理接口超时、币种不支持、网络异常都要有兜底逻辑数据延迟注意 updatetime 字段判断数据新鲜度七、总结汇率查询接口在跨境业务中是一个平时感觉不到出问题时很痛的隐性依赖。接入时做好精度处理、缓存和异常处理日常使用基本不会有太大问题。