{ "swagger": "2.0", "info": { "title": "股票智能分析系统 API", "description": "股票智能分析系统的REST API文档", "version": "2.1.0" }, "host": "localhost:8888", "basePath": "/", "schemes": ["http", "https"], "paths": { "/analyze": { "post": { "summary": "分析股票", "description": "分析单只或多只股票", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_codes": { "type": "array", "items": { "type": "string" }, "example": ["600519", "000858"] }, "market_type": { "type": "string", "example": "A" } } } } ], "responses": { "200": { "description": "成功分析股票" }, "400": { "description": "请求参数错误" }, "500": { "description": "服务器内部错误" } } } }, "/api/start_stock_analysis": { "post": { "summary": "启动股票分析任务", "description": "启动异步股票分析任务", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_code": { "type": "string", "example": "600519" }, "market_type": { "type": "string", "example": "A" } } } } ], "responses": { "200": { "description": "成功启动分析任务" } } } }, "/api/analysis_status/{task_id}": { "get": { "summary": "获取分析任务状态", "description": "获取异步分析任务的状态和结果", "parameters": [ { "name": "task_id", "in": "path", "required": true, "type": "string" } ], "responses": { "200": { "description": "成功获取任务状态和结果" }, "404": { "description": "找不到指定的任务" } } } }, "/api/stock_data": { "get": { "summary": "获取股票数据", "description": "获取股票历史数据和技术指标", "parameters": [ { "name": "stock_code", "in": "query", "required": true, "type": "string" }, { "name": "market_type", "in": "query", "required": false, "type": "string", "default": "A" }, { "name": "period", "in": "query", "required": false, "type": "string", "enum": ["1m", "3m", "6m", "1y"], "default": "1y" } ], "responses": { "200": { "description": "成功获取股票数据" }, "400": { "description": "请求参数错误" }, "500": { "description": "服务器内部错误" } } } }, "/api/start_market_scan": { "post": { "summary": "启动市场扫描任务", "description": "启动异步市场扫描任务", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_list": { "type": "array", "items": { "type": "string" }, "example": ["600519", "000858"] }, "min_score": { "type": "integer", "example": 60 }, "market_type": { "type": "string", "example": "A" } } } } ], "responses": { "200": { "description": "成功启动扫描任务" } } } }, "/api/scan_status/{task_id}": { "get": { "summary": "获取扫描任务状态", "description": "获取异步扫描任务的状态和结果", "parameters": [ { "name": "task_id", "in": "path", "required": true, "type": "string" } ], "responses": { "200": { "description": "成功获取任务状态和结果" }, "404": { "description": "找不到指定的任务" } } } }, "/api/index_stocks": { "get": { "summary": "获取指数成分股", "description": "获取指定指数的成分股列表", "parameters": [ { "name": "index_code", "in": "query", "required": true, "type": "string", "example": "000300" } ], "responses": { "200": { "description": "成功获取指数成分股" }, "400": { "description": "请求参数错误" }, "500": { "description": "服务器内部错误" } } } }, "/api/industry_stocks": { "get": { "summary": "获取行业成分股", "description": "获取指定行业的成分股列表", "parameters": [ { "name": "industry", "in": "query", "required": true, "type": "string", "example": "银行" } ], "responses": { "200": { "description": "成功获取行业成分股" }, "400": { "description": "请求参数错误" }, "500": { "description": "服务器内部错误" } } } }, "/api/fundamental_analysis": { "post": { "summary": "基本面分析", "description": "获取股票的基本面分析结果", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_code": { "type": "string", "example": "600519" } } } } ], "responses": { "200": { "description": "成功获取基本面分析结果" } } } }, "/api/capital_flow": { "post": { "summary": "资金流向分析", "description": "获取股票的资金流向分析结果", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_code": { "type": "string", "example": "600519" }, "days": { "type": "integer", "example": 10 } } } } ], "responses": { "200": { "description": "成功获取资金流向分析结果" } } } }, "/api/scenario_predict": { "post": { "summary": "情景预测", "description": "获取股票的多情景预测结果", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_code": { "type": "string", "example": "600519" }, "market_type": { "type": "string", "example": "A" }, "days": { "type": "integer", "example": 60 } } } } ], "responses": { "200": { "description": "成功获取情景预测结果" } } } }, "/api/qa": { "post": { "summary": "智能问答", "description": "获取股票相关问题的智能回答", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_code": { "type": "string", "example": "600519" }, "question": { "type": "string", "example": "这只股票的主要支撑位是多少？" }, "market_type": { "type": "string", "example": "A" } } } } ], "responses": { "200": { "description": "成功获取智能回答" } } } }, "/api/risk_analysis": { "post": { "summary": "风险分析", "description": "获取股票的风险分析结果", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "stock_code": { "type": "string", "example": "600519" }, "market_type": { "type": "string", "example": "A" } } } } ], "responses": { "200": { "description": "成功获取风险分析结果" } } } }, "/api/portfolio_risk": { "post": { "summary": "投资组合风险分析", "description": "获取投资组合的整体风险分析结果", "parameters": [ { "name": "body", "in": "body", "required": true, "schema": { "type": "object", "properties": { "portfolio": { "type": "array", "items": { "type": "object", "properties": { "stock_code": { "type": "string" }, "weight": { "type": "number" }, "market_type": { "type": "string" } } }, "example": [ { "stock_code": "600519", "weight": 30, "market_type": "A" }, { "stock_code": "000858", "weight": 20, "market_type": "A" } ] } } } } ], "responses": { "200": { "description": "成功获取投资组合风险分析结果" } } } }, "/api/index_analysis": { "get": { "summary": "指数分析", "description": "获取指数的整体分析结果", "parameters": [ { "name": "index_code", "in": "query", "required": true, "type": "string", "example": "000300" }, { "name": "limit", "in": "query", "required": false, "type": "integer", "example": 30 } ], "responses": { "200": { "description": "成功获取指数分析结果" } } } }, "/api/industry_analysis": { "get": { "summary": "行业分析", "description": "获取行业的整体分析结果", "parameters": [ { "name": "industry", "in": "query", "required": true, "type": "string", "example": "银行" }, { "name": "limit", "in": "query", "required": false, "type": "integer", "example": 30 } ], "responses": { "200": { "description": "成功获取行业分析结果" } } } }, "/api/industry_compare": { "get": { "summary": "行业比较", "description": "比较不同行业的表现", "parameters": [ { "name": "limit", "in": "query", "required": false, "type": "integer", "example": 10 } ], "responses": { "200": { "description": "成功获取行业比较结果" } } } } }, "definitions": { "Stock": { "type": "object", "properties": { "stock_code": { "type": "string" }, "stock_name": { "type": "string" }, "price": { "type": "number" }, "price_change": { "type": "number" } } }, "AnalysisResult": { "type": "object", "properties": { "score": { "type": "number" }, "recommendation": { "type": "string" } } } } }