{ "openapi": "3.0.3", "info": { "title": "银行汇率查询", "description": "提供主流银行外汇牌价汇率查询，支持外汇币种列表查询、历史汇率查询。同时也支持币种之间的汇率转换。本数据为延迟数据。免责声明：此汇率表仅供数据统计、机器分析参考，不得用于终端展示，并以当地银行实际交易汇率为准。", "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2", "version": "1.0.0" }, "servers": [ { "url": "https://route.showapi.com" } ], "paths": { "/105-35": { "x-pointCode": 35, "x-mode": "mapping", "x-read-timeout": 30, "x-connect-timeout": 30, "post": { "summary": "外汇牌价币种列表", "description": "外汇牌价币种列表，能够提供所有支持的外汇币种的详细信息。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number" }, "exchange_list": { "type": "array", "items": { "type": "object", "properties": { "flag": { "type": "string", "description": "旗帜" }, "name": { "type": "string", "description": "货币名称" }, "code": { "type": "string", "description": "货币代码" } } } } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "105_35_POST", "parameters": [] } }, "/105-34": { "x-pointCode": 34, "x-mode": "mapping", "x-read-timeout": 15, "x-connect-timeout": 15, "post": { "summary": "查询历史汇率", "description": "外币历史汇率（100外币兑人民币），最早可查到2009年1月，支持英镑、港币、美元、瑞士法郎、新加坡元、瑞典克朗、林吉特、新台币、丹麦克朗、挪威克朗、日元、加拿大元、澳大利亚元、欧元、澳门元、菲律宾比索、泰国铢、新西兰元、韩国元、卢布、印尼卢比、巴西里亚尔、阿联酋迪拉姆、印度卢比、南非兰特、沙特里亚尔、土耳其里拉", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "startDate": { "type": "string", "description": "开始日期" }, "ret_code": { "type": "number", "description": "接口调用是否成功,0为成功,其他为失败" }, "currency_name": { "type": "string", "description": "货币名称" }, "remark": { "type": "string", "description": "提示信息" }, "month": { "type": "string", "description": "查询年月" }, "list": { "type": "array", "items": { "type": "object", "properties": { "0": { "type": "object", "properties": { "middle_rate": { "type": "string", "description": "中行折算价" }, "publish_time": { "type": "string", "description": "发布日期" }, "cash_selling_rate": { "type": "string", "description": "现钞卖出价" }, "buying_rate": { "type": "string", "description": "现汇买入价" }, "cash_buying_rate": { "type": "string", "description": "现钞买入价" }, "selling_rate": { "type": "string", "description": "现汇卖出价" } } } } }, "description": "返回列表" }, "endDate": { "type": "string", "description": "结束日期" }, "currency_code": { "type": "string", "description": "货币编号" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "105_34_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "货币编号" }, "name": { "type": "string", "description": "货币名称" }, "month": { "type": "string", "description": "查询年月（yyyyMM）与startDate和endDate互斥" }, "startDate": { "type": "string", "description": "查询起始时间yyyyMMdd，最大可查询区间为90天" }, "endDate": { "type": "string", "description": "查询结束时间yyyyMMdd，最大可查询区间为90天" } } } } } } } }, "/105-31": { "x-pointCode": 31, "x-mode": "mapping", "x-read-timeout": 15, "x-connect-timeout": 15, "post": { "summary": "汇率转换", "description": "汇率转换API能够根据实时汇率将指定金额的人民币兑换成美元或其他外币。比如金额人民币100元，可以转为多少美元（或其他外币）。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "money": { "type": "number", "description": "转换后的金额，单位元" }, "ret_code": { "type": "string", "description": "0为成功，其他失败" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "105_31_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "fromCode": { "type": "string", "description": "源货币类型" }, "toCode": { "type": "string", "description": "目标货币类型" }, "money": { "type": "string", "description": "转换的金额，单位元" } }, "required": [ "fromCode", "toCode", "money" ] } } } } } }, "/105-30": { "x-pointCode": 30, "x-mode": "mapping", "x-read-timeout": 15, "x-connect-timeout": 15, "post": { "summary": "汇率查询", "description": "包括常见国家货币的汇率：菲律宾比索，瑞典克朗，新加坡元，阿联酋迪拉姆，澳大利亚元，巴西里亚尔，加拿大元，瑞士法郎，丹麦克朗，欧元，英镑，港币，印尼卢比，印度卢比，日元，韩国元，澳门元，林吉特，挪威克朗，新西兰元，卢布，泰国铢，新台币，美元，南非兰特，人民币。数据来源网络，有数分钟延迟，不构成投资建议，仅供数据分析、统计参考。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "listSize": { "type": "number", "description": "返回的数据列表长度" }, "list": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "货币名称" }, "code": { "type": "string", "description": "货币简码" }, "hui_in": { "type": "string", "description": "现汇买入价" }, "chao_in": { "type": "string", "description": "现钞买入价" }, "hui_out": { "type": "string", "description": "现汇卖出价" }, "chao_out": { "type": "string", "description": "现钞卖出价" }, "zhesuan": { "type": "string", "description": "中行折算价" }, "day": { "type": "string", "description": "发布天" }, "time": { "type": "string", "description": "发布时间" } } }, "description": "数据列表" }, "ret_code": { "type": "string", "description": "0为成功，其他失败" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "105_30_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "需要查询的货币缩写。比如人民币是CNY，美元是USD，如果不输入，则返回全部。" } } } } } } } } }, "components": { "securitySchemes": { "AppKeyAuth": { "type": "apiKey", "in": "query", "name": "appKey", "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp" } }, "schemas": { "ShowapiResEnvelope": { "type": "object", "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）", "properties": { "showapi_res_code": { "type": "integer", "description": "API 返回的状态码" }, "showapi_res_error": { "type": "string", "description": "API 返回的错误信息" }, "showapi_res_id": { "type": "string", "description": "API 请求的唯一标识" }, "showapi_fee_num": { "type": "integer", "description": "API 调用计费次数" } } } } }, "security": [ { "AppKeyAuth": [] } ], "externalDocs": { "url": "https://www.showapi.com/apiGateway/view/105?tab=book" }, "x-apiCode": "105", "x-is-own": false, "x-is-op": true }