{ "openapi": "3.0.3", "info": { "title": "ValueFrontier API", "description": "价值前沿 - 股票投资分析平台完整API文档", "version": "1.0.0", "contact": { "name": "ValueFrontier", "url": "https://valuefrontier.cn" } }, "servers": [ { "url": "https://valuefrontier.cn", "description": "生产环境" } ], "tags": [ {"name": "认证", "description": "用户认证相关接口"}, {"name": "账户管理", "description": "用户账户信息管理"}, {"name": "自选股", "description": "自选股管理"}, {"name": "投资计划", "description": "投资计划与复盘"}, {"name": "事件", "description": "投资事件相关"}, {"name": "帖子评论", "description": "社区帖子与评论"}, {"name": "股票行情", "description": "股票实时行情"}, {"name": "股票信息", "description": "股票基本信息"}, {"name": "财务报表", "description": "财务数据查询"}, {"name": "市场数据", "description": "市场行情与统计"}, {"name": "财经日历", "description": "财经事件日历"}, {"name": "行业分类", "description": "行业分类查询"}, {"name": "概念板块", "description": "概念板块数据"}, {"name": "公司分析", "description": "公司深度分析"}, {"name": "模拟交易", "description": "模拟盘交易"}, {"name": "会员订阅", "description": "订阅与支付"} ], "paths": { "/api/auth/session": { "get": { "tags": ["认证"], "summary": "获取当前登录用户信息", "responses": { "200": {"description": "成功", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserSession"}}}} } } }, "/api/auth/login": { "post": { "tags": ["认证"], "summary": "用户登录", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "required": ["password"], "properties": { "username": {"type": "string", "description": "用户名/手机号/邮箱"}, "email": {"type": "string"}, "phone": {"type": "string"}, "password": {"type": "string"} } } } } }, "responses": { "200": {"description": "登录成功"}, "401": {"description": "密码错误"}, "404": {"description": "用户不存在"} } } }, "/api/auth/logout": { "post": { "tags": ["认证"], "summary": "用户登出", "responses": {"200": {"description": "已登出"}} } }, "/api/auth/register": { "post": { "tags": ["认证"], "summary": "用户注册（用户名+邮箱）", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "required": ["username", "email", "password"], "properties": { "username": {"type": "string"}, "email": {"type": "string"}, "password": {"type": "string"} } } } } }, "responses": { "201": {"description": "注册成功"}, "400": {"description": "用户名或邮箱已存在"} } } }, "/api/auth/send-verification-code": { "post": { "tags": ["认证"], "summary": "发送验证码（手机/邮箱）", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["credential", "type"], "properties": { "credential": {"type": "string", "description": "手机号或邮箱"}, "type": {"type": "string", "enum": ["phone", "email"]}, "purpose": {"type": "string", "enum": ["login", "register"], "default": "login"} } } } } }, "responses": {"200": {"description": "验证码已发送"}} } }, "/api/auth/login-with-code": { "post": { "tags": ["认证"], "summary": "验证码登录", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["credential", "verification_code", "login_type"], "properties": { "credential": {"type": "string"}, "verification_code": {"type": "string"}, "login_type": {"type": "string", "enum": ["phone", "email"]} } } } } }, "responses": {"200": {"description": "登录成功"}} } }, "/api/auth/register/phone": { "post": { "tags": ["认证"], "summary": "手机号注册", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["phone", "code", "password", "username"], "properties": { "phone": {"type": "string"}, "code": {"type": "string"}, "password": {"type": "string"}, "username": {"type": "string"} } } } } }, "responses": {"201": {"description": "注册成功"}} } }, "/api/auth/register/email": { "post": { "tags": ["认证"], "summary": "邮箱注册", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["email", "code", "password", "username"], "properties": { "email": {"type": "string"}, "code": {"type": "string"}, "password": {"type": "string"}, "username": {"type": "string"} } } } } }, "responses": {"201": {"description": "注册成功"}} } }, "/api/auth/wechat/qrcode": { "get": { "tags": ["认证"], "summary": "获取微信登录二维码", "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "auth_url": {"type": "string"}, "session_id": {"type": "string"}, "expires_in": {"type": "integer"} } } } } } } } }, "/api/auth/wechat/check": { "post": { "tags": ["认证"], "summary": "检查微信扫码状态", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["session_id"], "properties": {"session_id": {"type": "string"}} } } } }, "responses": {"200": {"description": "成功"}} } }, "/api/account/change-password": { "post": { "tags": ["账户管理"], "summary": "修改密码", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["newPassword"], "properties": { "currentPassword": {"type": "string"}, "newPassword": {"type": "string"}, "isFirstSet": {"type": "boolean"} } } } } }, "responses": {"200": {"description": "密码修改成功"}} } }, "/api/account/password-status": { "get": { "tags": ["账户管理"], "summary": "获取密码状态", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/account/profile-completeness": { "get": { "tags": ["账户管理"], "summary": "获取资料完整度", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/account/phone/send-code": { "post": { "tags": ["账户管理"], "summary": "发送绑定手机验证码", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["phone"], "properties": {"phone": {"type": "string"}} } } } }, "responses": {"200": {"description": "验证码已发送"}} } }, "/api/account/phone/bind": { "post": { "tags": ["账户管理"], "summary": "绑定手机号", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["phone", "code"], "properties": { "phone": {"type": "string"}, "code": {"type": "string"} } } } } }, "responses": {"200": {"description": "绑定成功"}} } }, "/api/account/phone/unbind": { "post": { "tags": ["账户管理"], "summary": "解绑手机号", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "解绑成功"}} } }, "/api/account/email/send-bind-code": { "post": { "tags": ["账户管理"], "summary": "发送绑定邮箱验证码", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["email"], "properties": {"email": {"type": "string"}} } } } }, "responses": {"200": {"description": "验证码已发送"}} } }, "/api/account/email/bind": { "post": { "tags": ["账户管理"], "summary": "绑定邮箱", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["email", "code"], "properties": { "email": {"type": "string"}, "code": {"type": "string"} } } } } }, "responses": {"200": {"description": "绑定成功"}} } }, "/api/account/email/unbind": { "post": { "tags": ["账户管理"], "summary": "解绑邮箱", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "解绑成功"}} } }, "/api/account/wechat/qrcode": { "get": { "tags": ["账户管理"], "summary": "获取微信绑定二维码", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/account/wechat/unbind": { "post": { "tags": ["账户管理"], "summary": "解绑微信", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "解绑成功"}} } }, "/api/account/watchlist": { "get": { "tags": ["自选股"], "summary": "获取自选股列表", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} }, "post": { "tags": ["自选股"], "summary": "添加自选股", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["stock_code"], "properties": { "stock_code": {"type": "string", "description": "支持多种格式：600519、600519.SH、贵州茅台(600519)"}, "stock_name": {"type": "string"} } } } } }, "responses": {"200": {"description": "添加成功"}} } }, "/api/account/watchlist/{stock_code}": { "delete": { "tags": ["自选股"], "summary": "删除自选股", "security": [{"cookieAuth": []}], "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "删除成功"}} } }, "/api/account/watchlist/realtime": { "get": { "tags": ["自选股"], "summary": "获取自选股实时行情", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/account/investment-plans": { "get": { "tags": ["投资计划"], "summary": "获取投资计划列表", "security": [{"cookieAuth": []}], "parameters": [ {"name": "type", "in": "query", "schema": {"type": "string", "enum": ["plan", "review"]}}, {"name": "start_date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "end_date", "in": "query", "schema": {"type": "string", "format": "date"}} ], "responses": {"200": {"description": "成功"}} }, "post": { "tags": ["投资计划"], "summary": "创建投资计划", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["date", "title", "type"], "properties": { "date": {"type": "string", "format": "date"}, "title": {"type": "string"}, "content": {"type": "string"}, "type": {"type": "string", "enum": ["plan", "review"]}, "stocks": {"type": "array", "items": {"type": "string"}}, "tags": {"type": "array", "items": {"type": "string"}}, "status": {"type": "string", "default": "active"} } } } } }, "responses": {"200": {"description": "创建成功"}} } }, "/api/account/investment-plans/{plan_id}": { "put": { "tags": ["投资计划"], "summary": "更新投资计划", "security": [{"cookieAuth": []}], "parameters": [ {"name": "plan_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "date": {"type": "string", "format": "date"}, "title": {"type": "string"}, "content": {"type": "string"}, "stocks": {"type": "array", "items": {"type": "string"}}, "tags": {"type": "array", "items": {"type": "string"}}, "status": {"type": "string"} } } } } }, "responses": {"200": {"description": "更新成功"}} }, "delete": { "tags": ["投资计划"], "summary": "删除投资计划", "security": [{"cookieAuth": []}], "parameters": [ {"name": "plan_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "删除成功"}} } }, "/api/account/events/following": { "get": { "tags": ["投资计划"], "summary": "获取关注的事件", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/account/future-events/following": { "get": { "tags": ["投资计划"], "summary": "获取关注的未来事件", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/account/calendar/events": { "get": { "tags": ["投资计划"], "summary": "获取日历事件（投资计划+关注的未来事件）", "security": [{"cookieAuth": []}], "parameters": [ {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "year", "in": "query", "schema": {"type": "integer"}}, {"name": "month", "in": "query", "schema": {"type": "integer"}}, {"name": "start_date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "end_date", "in": "query", "schema": {"type": "string", "format": "date"}} ], "responses": {"200": {"description": "成功"}} }, "post": { "tags": ["投资计划"], "summary": "创建日历事件", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["title", "event_date"], "properties": { "title": {"type": "string"}, "event_date": {"type": "string", "format": "date"}, "type": {"type": "string", "default": "plan"}, "description": {"type": "string"}, "stocks": {"type": "array", "items": {"type": "string"}} } } } } }, "responses": {"200": {"description": "创建成功"}} } }, "/api/account/calendar/events/{event_id}": { "delete": { "tags": ["投资计划"], "summary": "删除日历事件", "security": [{"cookieAuth": []}], "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "删除成功"}} } }, "/api/events": { "get": { "tags": ["事件"], "summary": "获取事件列表", "parameters": [ {"name": "page", "in": "query", "schema": {"type": "integer", "default": 1}}, {"name": "per_page", "in": "query", "schema": {"type": "integer", "default": 10}}, {"name": "type", "in": "query", "schema": {"type": "string"}}, {"name": "status", "in": "query", "schema": {"type": "string", "default": "active"}}, {"name": "importance", "in": "query", "schema": {"type": "string"}}, {"name": "sort", "in": "query", "schema": {"type": "string", "enum": ["hot", "new", "returns", "importance", "view_count"]}}, {"name": "start_date", "in": "query", "schema": {"type": "string"}}, {"name": "end_date", "in": "query", "schema": {"type": "string"}}, {"name": "recent_days", "in": "query", "schema": {"type": "integer"}}, {"name": "q", "in": "query", "schema": {"type": "string"}, "description": "搜索关键词"}, {"name": "industry_classification", "in": "query", "schema": {"type": "string"}}, {"name": "industry_code", "in": "query", "schema": {"type": "string"}} ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": {"$ref": "#/components/schemas/EventsResponse"} } } } } } }, "/api/events/hot": { "get": { "tags": ["事件"], "summary": "获取热点事件", "parameters": [ {"name": "days", "in": "query", "schema": {"type": "integer", "default": 3}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 4}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/keywords/popular": { "get": { "tags": ["事件"], "summary": "获取热门关键词", "parameters": [ {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}": { "get": { "tags": ["事件"], "summary": "获取事件详情", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": {"$ref": "#/components/schemas/EventDetail"} } } } } } }, "/api/events/{event_id}/stocks": { "get": { "tags": ["事件"], "summary": "获取事件相关股票（需要Pro订阅）", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": { "200": {"description": "成功"}, "403": {"description": "需要Pro订阅"} } }, "post": { "tags": ["事件"], "summary": "添加相关股票", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["stock_code", "relation_desc"], "properties": { "stock_code": {"type": "string"}, "stock_name": {"type": "string"}, "sector": {"type": "string"}, "relation_desc": {"type": "string"}, "correlation": {"type": "number"}, "momentum": {"type": "string"} } } } } }, "responses": {"200": {"description": "添加成功"}} } }, "/api/events/{event_id}/concepts": { "get": { "tags": ["事件"], "summary": "获取相关概念（需要Pro订阅）", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": { "200": {"description": "成功"}, "403": {"description": "需要Pro订阅"} } } }, "/api/events/{event_id}/historical": { "get": { "tags": ["事件"], "summary": "获取历史事件对比", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/historical-events/{event_id}/stocks": { "get": { "tags": ["事件"], "summary": "获取历史事件相关股票", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}/expectation-score": { "get": { "tags": ["事件"], "summary": "获取超预期得分", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}/follow": { "post": { "tags": ["事件"], "summary": "关注/取消关注事件", "security": [{"cookieAuth": []}], "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}/transmission": { "get": { "tags": ["事件"], "summary": "获取传导链分析（需要Max订阅）", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": { "200": {"description": "成功"}, "403": {"description": "需要Max订阅"} } } }, "/api/events/{event_id}/sankey-data": { "get": { "tags": ["事件"], "summary": "获取桑基图数据", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}/chain-analysis": { "get": { "tags": ["事件"], "summary": "获取产业链分析", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}/chain-node/{node_id}": { "get": { "tags": ["事件"], "summary": "获取链节点详情", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}}, {"name": "node_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/events/{event_id}/posts": { "get": { "tags": ["帖子评论"], "summary": "获取事件帖子列表", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}}, {"name": "sort", "in": "query", "schema": {"type": "string", "enum": ["latest", "hot"], "default": "latest"}}, {"name": "page", "in": "query", "schema": {"type": "integer", "default": 1}}, {"name": "per_page", "in": "query", "schema": {"type": "integer", "default": 20}} ], "responses": {"200": {"description": "成功"}} }, "post": { "tags": ["帖子评论"], "summary": "创建帖子", "security": [{"cookieAuth": []}], "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["content"], "properties": { "title": {"type": "string"}, "content": {"type": "string"}, "content_type": {"type": "string", "default": "text"} } } } } }, "responses": {"200": {"description": "发布成功"}} } }, "/api/posts/{post_id}/comments": { "get": { "tags": ["帖子评论"], "summary": "获取帖子评论", "parameters": [ {"name": "post_id", "in": "path", "required": true, "schema": {"type": "integer"}}, {"name": "sort", "in": "query", "schema": {"type": "string", "enum": ["latest", "hot"]}} ], "responses": {"200": {"description": "成功"}} }, "post": { "tags": ["帖子评论"], "summary": "发表评论", "security": [{"cookieAuth": []}], "parameters": [ {"name": "post_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["content"], "properties": { "content": {"type": "string"}, "parent_id": {"type": "integer", "description": "回复的评论ID"} } } } } }, "responses": {"200": {"description": "评论成功"}} } }, "/api/posts/{post_id}/like": { "post": { "tags": ["帖子评论"], "summary": "点赞/取消点赞帖子", "security": [{"cookieAuth": []}], "parameters": [ {"name": "post_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/comments/{comment_id}/like": { "post": { "tags": ["帖子评论"], "summary": "点赞评论", "security": [{"cookieAuth": []}], "parameters": [ {"name": "comment_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/posts/{post_id}": { "delete": { "tags": ["帖子评论"], "summary": "删除帖子", "security": [{"cookieAuth": []}], "parameters": [ {"name": "post_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "删除成功"}} } }, "/api/comments/{comment_id}": { "delete": { "tags": ["帖子评论"], "summary": "删除评论", "security": [{"cookieAuth": []}], "parameters": [ {"name": "comment_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "删除成功"}} } }, "/api/stocks/search": { "get": { "tags": ["股票信息"], "summary": "搜索股票", "parameters": [ {"name": "q", "in": "query", "required": true, "schema": {"type": "string"}, "description": "股票代码/名称/拼音首字母"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/kline": { "get": { "tags": ["股票行情"], "summary": "获取K线数据", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "type", "in": "query", "schema": {"type": "string", "enum": ["minute", "daily", "timeline"], "default": "minute"}}, {"name": "event_time", "in": "query", "schema": {"type": "string", "format": "date-time"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/latest-minute": { "get": { "tags": ["股票行情"], "summary": "获取最新分钟数据", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/forecast-report": { "get": { "tags": ["股票信息"], "summary": "获取盈利预测报告", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/basic-info": { "get": { "tags": ["股票信息"], "summary": "获取股票基本信息", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/announcements": { "get": { "tags": ["股票信息"], "summary": "获取公告列表", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/disclosure-schedule": { "get": { "tags": ["股票信息"], "summary": "获取财报预披露时间", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/actual-control": { "get": { "tags": ["股票信息"], "summary": "获取实际控制人", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/concentration": { "get": { "tags": ["股票信息"], "summary": "获取股权集中度", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/management": { "get": { "tags": ["股票信息"], "summary": "获取管理层信息", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "active_only", "in": "query", "schema": {"type": "boolean", "default": true}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/top-circulation-shareholders": { "get": { "tags": ["股票信息"], "summary": "获取十大流通股东", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 10}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/top-shareholders": { "get": { "tags": ["股票信息"], "summary": "获取十大股东", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 10}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/branches": { "get": { "tags": ["股票信息"], "summary": "获取分支机构", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/{stock_code}/patents": { "get": { "tags": ["股票信息"], "summary": "获取专利信息", "parameters": [ {"name": "stock_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}}, {"name": "type", "in": "query", "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/stock/quotes": { "get": { "tags": ["股票行情"], "summary": "获取股票报价（GET）", "parameters": [ {"name": "codes", "in": "query", "required": true, "schema": {"type": "string"}, "description": "逗号分隔的股票代码"}, {"name": "event_time", "in": "query", "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} }, "post": { "tags": ["股票行情"], "summary": "获取股票报价（POST）", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["codes"], "properties": { "codes": {"type": "array", "items": {"type": "string"}}, "event_time": {"type": "string"} } } } } }, "responses": {"200": {"description": "成功"}} } }, "/api/index/{index_code}/kline": { "get": { "tags": ["股票行情"], "summary": "获取指数K线", "parameters": [ {"name": "index_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "type", "in": "query", "schema": {"type": "string", "enum": ["minute", "daily", "timeline"]}}, {"name": "event_time", "in": "query", "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/stock-info/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取财务摘要", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/balance-sheet/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取资产负债表", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 12}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/income-statement/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取利润表", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 12}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/cashflow/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取现金流量表", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 12}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/financial-metrics/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取财务指标", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 12}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/main-business/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取主营业务构成", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "periods", "in": "query", "schema": {"type": "integer", "default": 4}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/forecast/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取业绩预告", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/industry-rank/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取行业排名", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 4}} ], "responses": {"200": {"description": "成功"}} } }, "/api/financial/comparison/{seccode}": { "get": { "tags": ["财务报表"], "summary": "获取报告期对比", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "periods", "in": "query", "schema": {"type": "integer", "default": 8}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/trade/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取交易数据（日K）", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "days", "in": "query", "schema": {"type": "integer", "default": 60}}, {"name": "end_date", "in": "query", "schema": {"type": "string", "format": "date"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/funding/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取融资融券数据", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "days", "in": "query", "schema": {"type": "integer", "default": 30}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/bigdeal/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取大宗交易", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "days", "in": "query", "schema": {"type": "integer", "default": 30}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/unusual/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取龙虎榜数据", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "days", "in": "query", "schema": {"type": "integer", "default": 30}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/pledge/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取股权质押", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/summary/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取市场数据汇总", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/heatmap": { "get": { "tags": ["市场数据"], "summary": "获取市场热力图", "parameters": [ {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 500}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/statistics": { "get": { "tags": ["市场数据"], "summary": "获取市场统计数据", "parameters": [ {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/market/rise-analysis/{seccode}": { "get": { "tags": ["市场数据"], "summary": "获取涨幅分析", "parameters": [ {"name": "seccode", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "start_date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "end_date", "in": "query", "schema": {"type": "string", "format": "date"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/v1/calendar/event-counts": { "get": { "tags": ["财经日历"], "summary": "获取日历事件数量统计", "parameters": [ {"name": "year", "in": "query", "schema": {"type": "integer"}}, {"name": "month", "in": "query", "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/v1/calendar/events": { "get": { "tags": ["财经日历"], "summary": "获取日历事件列表", "parameters": [ {"name": "date", "in": "query", "required": true, "schema": {"type": "string", "format": "date"}}, {"name": "type", "in": "query", "schema": {"type": "string", "default": "all"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/v1/calendar/events/{event_id}": { "get": { "tags": ["财经日历"], "summary": "获取日历事件详情", "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/v1/calendar/events/{event_id}/follow": { "post": { "tags": ["财经日历"], "summary": "关注/取消关注未来事件", "security": [{"cookieAuth": []}], "parameters": [ {"name": "event_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/classifications": { "get": { "tags": ["行业分类"], "summary": "获取所有行业分类系统", "responses": {"200": {"description": "成功"}} } }, "/api/levels": { "get": { "tags": ["行业分类"], "summary": "获取行业层级数据", "parameters": [ {"name": "classification", "in": "query", "required": true, "schema": {"type": "string"}}, {"name": "level", "in": "query", "required": true, "schema": {"type": "integer", "minimum": 1, "maximum": 4}}, {"name": "level1_name", "in": "query", "schema": {"type": "string"}}, {"name": "level2_name", "in": "query", "schema": {"type": "string"}}, {"name": "level3_name", "in": "query", "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/info": { "get": { "tags": ["行业分类"], "summary": "获取行业详细信息", "parameters": [ {"name": "classification", "in": "query", "required": true, "schema": {"type": "string"}}, {"name": "code", "in": "query", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/concepts/daily-top": { "get": { "tags": ["概念板块"], "summary": "获取每日涨幅靠前的概念", "parameters": [ {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 6}} ], "responses": {"200": {"description": "成功"}} } }, "/api/company/comprehensive-analysis/{company_code}": { "get": { "tags": ["公司分析"], "summary": "获取公司综合分析", "parameters": [ {"name": "company_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/company/value-chain-analysis/{company_code}": { "get": { "tags": ["公司分析"], "summary": "获取产业链分析", "parameters": [ {"name": "company_code", "in": "path", "required": true, "schema": {"type": "string"}} ], "responses": {"200": {"description": "成功"}} } }, "/api/company/key-factors-timeline/{company_code}": { "get": { "tags": ["公司分析"], "summary": "获取关键因素和时间线", "parameters": [ {"name": "company_code", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "report_period", "in": "query", "schema": {"type": "string"}}, {"name": "event_limit", "in": "query", "schema": {"type": "integer", "default": 50}} ], "responses": {"200": {"description": "成功"}} } }, "/api/simulation/account": { "get": { "tags": ["模拟交易"], "summary": "获取模拟账户", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/simulation/positions": { "get": { "tags": ["模拟交易"], "summary": "获取持仓列表", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/simulation/orders": { "get": { "tags": ["模拟交易"], "summary": "获取订单列表", "security": [{"cookieAuth": []}], "parameters": [ {"name": "status", "in": "query", "schema": {"type": "string"}}, {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}} ], "responses": {"200": {"description": "成功"}} } }, "/api/simulation/place-order": { "post": { "tags": ["模拟交易"], "summary": "下单（支持7x24小时）", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["stock_code", "order_type", "order_qty"], "properties": { "stock_code": {"type": "string"}, "order_type": {"type": "string", "enum": ["BUY", "SELL"]}, "order_qty": {"type": "integer", "multipleOf": 100}, "price_type": {"type": "string", "default": "MARKET"} } } } } }, "responses": {"200": {"description": "下单成功"}} } }, "/api/simulation/cancel-order/{order_id}": { "post": { "tags": ["模拟交易"], "summary": "撤销订单", "security": [{"cookieAuth": []}], "parameters": [ {"name": "order_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "撤销成功"}} } }, "/api/simulation/transactions": { "get": { "tags": ["模拟交易"], "summary": "获取成交记录", "security": [{"cookieAuth": []}], "parameters": [ {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}} ], "responses": {"200": {"description": "成功"}} } }, "/api/simulation/t1-settlement": { "post": { "tags": ["模拟交易"], "summary": "手动触发T+1结算", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "结算成功"}} } }, "/api/simulation/daily-settlement": { "post": { "tags": ["模拟交易"], "summary": "手动触发日结算", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "结算成功"}} } }, "/api/simulation/reset": { "post": { "tags": ["模拟交易"], "summary": "重置模拟账户", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "重置成功"}} } }, "/api/subscription/plans": { "get": { "tags": ["会员订阅"], "summary": "获取订阅套餐", "responses": {"200": {"description": "成功"}} } }, "/api/subscription/current": { "get": { "tags": ["会员订阅"], "summary": "获取当前订阅", "security": [{"cookieAuth": []}], "responses": {"200": {"description": "成功"}} } }, "/api/subscription/info": { "get": { "tags": ["会员订阅"], "summary": "获取订阅信息", "responses": {"200": {"description": "成功"}} } }, "/api/payment/create-order": { "post": { "tags": ["会员订阅"], "summary": "创建支付订单", "security": [{"cookieAuth": []}], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": ["plan_name", "billing_cycle"], "properties": { "plan_name": {"type": "string", "enum": ["pro", "max"]}, "billing_cycle": {"type": "string", "enum": ["monthly", "yearly"]} } } } } }, "responses": {"200": {"description": "订单创建成功"}} } }, "/api/payment/order/{order_id}/status": { "get": { "tags": ["会员订阅"], "summary": "查询订单状态", "security": [{"cookieAuth": []}], "parameters": [ {"name": "order_id", "in": "path", "required": true, "schema": {"type": "integer"}} ], "responses": {"200": {"description": "成功"}} } } }, "components": { "securitySchemes": { "cookieAuth": { "type": "apiKey", "in": "cookie", "name": "session", "description": "基于Session的Cookie认证" } }, "schemas": { "UserSession": { "type": "object", "properties": { "success": {"type": "boolean"}, "isAuthenticated": {"type": "boolean"}, "user": { "type": "object", "properties": { "id": {"type": "integer"}, "username": {"type": "string"}, "nickname": {"type": "string"}, "email": {"type": "string"}, "phone": {"type": "string"}, "avatar_url": {"type": "string"}, "subscription_type": {"type": "string", "enum": ["free", "pro", "max"]}, "subscription_status": {"type": "string"}, "is_subscription_active": {"type": "boolean"} } } } }, "EventsResponse": { "type": "object", "properties": { "success": {"type": "boolean"}, "data": { "type": "object", "properties": { "events": {"type": "array", "items": {"$ref": "#/components/schemas/EventSummary"}}, "pagination": { "type": "object", "properties": { "page": {"type": "integer"}, "per_page": {"type": "integer"}, "total": {"type": "integer"}, "pages": {"type": "integer"}, "has_prev": {"type": "boolean"}, "has_next": {"type": "boolean"} } } } } } }, "EventSummary": { "type": "object", "properties": { "id": {"type": "integer"}, "title": {"type": "string"}, "description": {"type": "string"}, "event_type": {"type": "string"}, "importance": {"type": "string", "enum": ["S", "A", "B", "C"]}, "status": {"type": "string"}, "hot_score": {"type": "number"}, "view_count": {"type": "integer"}, "trending_score": {"type": "number"}, "related_avg_chg": {"type": "number"}, "related_max_chg": {"type": "number"}, "created_at": {"type": "string", "format": "date-time"} } }, "EventDetail": { "type": "object", "properties": { "id": {"type": "integer"}, "title": {"type": "string"}, "description": {"type": "string"}, "event_type": {"type": "string"}, "status": {"type": "string"}, "importance": {"type": "string"}, "hot_score": {"type": "number"}, "view_count": {"type": "integer"}, "post_count": {"type": "integer"}, "follower_count": {"type": "integer"}, "keywords": {"type": "array", "items": {"type": "string"}}, "related_industries": {"type": "object"}, "related_avg_chg": {"type": "number"}, "related_max_chg": {"type": "number"}, "invest_score": {"type": "integer"}, "has_chain_analysis": {"type": "boolean"}, "is_following": {"type": "boolean"}, "created_at": {"type": "string", "format": "date-time"} } } } } }