fanhuadesenlinnn/daily_stock_analysis
1
0
Fork 0
mirror of https://github.com/ZhuLinsen/daily_stock_analysis synced 2026-09-21 03:26:27 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
00a9bb461908f01f0c8403f9c5fdc46db510e2d6
daily_stock_analysis/docs/architecture/api_spec.json
zhulinsen ee2c113a1b feat: rebuild partial-data stock profile contract (#2308) 
* feat: add partial-data stock profile contract

* fix: query stock profile aliases

* fix: converge US stock profile aliases

* fix: preserve stock profile intelligence coverage

* fix: preserve JP and KR profile identities

* fix: disambiguate profile persisted identities

* fix: complete offshore profile identities

* fix: isolate offshore profile identities

* fix: preserve Taiwan profile aliases

* fix: preserve explicit profile market identity

* fix: preserve market in history candidates

* fix: preserve stock profile research evidence

* fix: complete stock profile history evidence

* fix: reject conflicting stock profile identities

* fix: normalize persisted profile symbol filters

* fix: exclude ambiguous global stock aliases

* fix: deduplicate profile alias queries

* fix: exclude ambiguous profile history aliases

* fix: break stock profile import cycle

* fix: preserve market-unique legacy aliases
2026-08-30 20:38:33 +08:00

9082 lines
232 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"openapi": "3.1.0",
"info": {
"title": "Daily Stock Analysis API",
"description": "A股/港股/美股自选股智能分析系统 API\n\n## 功能模块\n- 股票分析：触发 AI 智能分析\n- 历史记录：查询历史分析报告\n- 股票数据：获取行情数据\n\n## 认证方式\n支持可选管理员认证：ADMIN_AUTH_ENABLED=true 时，除登录、状态、健康检查和 OpenAPI 文档外，/api/v1/* 需要有效管理员会话 Cookie；关闭时不强制认证。",
"version": "1.0.0"
},
"servers": [
{
"url": "http://localhost:8000",
"description": "本地开发服务器"
}
],
"tags": [
{
"name": "Health",
"description": "健康检查接口"
},
{
"name": "Analysis",
"description": "股票分析相关接口"
},
{
"name": "History",
"description": "历史记录相关接口"
},
{
"name": "SystemConfig",
"description": "系统配置管理接口"
},
{
"name": "DecisionSignals",
"description": "AI 决策信号资产接口"
}
],
"paths": {
"/": {
"get": {
"tags": [
"Health"
],
"summary": "API 根路由",
"description": "返回 API 运行状态信息",
"operationId": "root",
"responses": {
"200": {
"description": "API 正常运行",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RootResponse"
}
}
}
}
}
}
},
"/health": {
"get": {
"tags": [
"Health"
],
"summary": "根路径健康检查",
"description": "用于负载均衡器或监控系统检查服务状态；即使静态 Web 前端已构建，也返回 JSON 而不是 SPA HTML fallback。",
"operationId": "rootHealthCheck",
"responses": {
"200": {
"description": "服务健康",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HealthResponse"
}
}
}
}
}
}
},
"/api/health": {
"get": {
"tags": [
"Health"
],
"summary": "健康检查",
"description": "用于负载均衡器或监控系统检查服务状态",
"operationId": "healthCheck",
"responses": {
"200": {
"description": "服务健康",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HealthResponse"
}
}
}
}
}
}
},
"/api/v1/health": {
"get": {
"tags": [
"Health"
],
"summary": "v1 健康检查",
"description": "API v1 前缀下的健康检查接口，用于监控系统和客户端探测服务状态。",
"operationId": "v1HealthCheck",
"responses": {
"200": {
"description": "服务健康",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HealthResponse"
}
}
}
}
}
}
},
"/api/v1/analysis/analyze": {
"post": {
"tags": [
"Analysis"
],
"summary": "触发股票分析",
"description": "启动 AI 智能分析任务，支持单只或多只股票批量分析",
"operationId": "triggerAnalysis",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AnalyzeRequest"
}
}
}
},
"responses": {
"200": {
"description": "分析完成（同步模式）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AnalysisResult"
}
}
}
},
"202": {
"description": "分析任务已接受（异步模式）",
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/TaskAccepted"
},
{
"$ref": "#/components/schemas/BatchTaskAcceptedResponse"
}
]
}
}
}
},
"400": {
"description": "请求参数错误",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"409": {
"description": "股票正在分析中，拒绝重复提交",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DuplicateTaskError"
}
}
}
},
"500": {
"description": "分析失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/analysis/tasks": {
"get": {
"tags": [
"Analysis"
],
"summary": "获取分析任务列表",
"description": "获取当前所有分析任务，支持按状态筛选。返回进行中和最近完成的任务。",
"operationId": "getAnalysisTasks",
"parameters": [
{
"name": "status",
"in": "query",
"description": "筛选状态：pending, processing, completed, failed, cancel_requested, cancelled（支持逗号分隔多个）",
"schema": {
"type": "string",
"example": "pending,processing"
}
},
{
"name": "limit",
"in": "query",
"description": "返回数量限制",
"schema": {
"type": "integer",
"default": 20,
"minimum": 1,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "任务列表",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TaskListResponse"
}
}
}
}
}
}
},
"/api/v1/analysis/tasks/stream": {
"get": {
"tags": [
"Analysis"
],
"summary": "任务状态 SSE 流",
"description": "通过 Server-Sent Events 实时推送任务状态变化。\n\n## 事件类型\n- `connected`: 连接成功\n- `task_created`: 新任务创建\n- `task_started`: 任务开始执行\n- `task_completed`: 任务完成\n- `task_failed`: 任务失败\n- `heartbeat`: 心跳（每 30 秒）",
"operationId": "taskStream",
"responses": {
"200": {
"description": "SSE 事件流",
"content": {
"text/event-stream": {
"schema": {
"type": "string",
"example": "event: task_created\ndata: {\"task_id\": \"abc123\", \"stock_code\": \"600519\", \"status\": \"pending\"}\n\n"
}
}
}
}
}
}
},
"/api/v1/history": {
"get": {
"tags": [
"History"
],
"summary": "获取历史分析列表",
"description": "分页获取历史分析记录摘要，支持按股票代码、报告类型和日期范围筛选",
"operationId": "getHistoryList",
"parameters": [
{
"name": "stock_code",
"in": "query",
"description": "股票代码筛选",
"schema": {
"type": "string"
}
},
{
"name": "report_type",
"in": "query",
"description": "报告类型筛选（如 market_review）；不传则返回所有类型历史。",
"schema": {
"type": "string"
}
},
{
"name": "start_date",
"in": "query",
"description": "开始日期 (YYYY-MM-DD)",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "end_date",
"in": "query",
"description": "结束日期 (YYYY-MM-DD)",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "page",
"in": "query",
"description": "页码（从 1 开始）",
"schema": {
"type": "integer",
"default": 1,
"minimum": 1
}
},
{
"name": "limit",
"in": "query",
"description": "每页数量",
"schema": {
"type": "integer",
"default": 20,
"minimum": 1,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "历史记录列表",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HistoryListResponse"
}
}
}
}
}
}
},
"/api/v1/history/{query_id}": {
"get": {
"tags": [
"History"
],
"summary": "获取历史报告详情",
"description": "根据 query_id 获取完整的历史分析报告",
"operationId": "getHistoryDetail",
"parameters": [
{
"name": "query_id",
"in": "path",
"required": true,
"description": "分析记录唯一标识",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "报告详情",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AnalysisReport"
}
}
}
},
"404": {
"description": "报告不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/history/{query_id}/news": {
"get": {
"tags": [
"History"
],
"summary": "获取历史报告关联新闻",
"description": "根据 query_id 获取关联的新闻情报列表（为空也返回 200）",
"operationId": "getHistoryNews",
"parameters": [
{
"name": "query_id",
"in": "path",
"required": true,
"description": "分析记录唯一标识",
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "返回数量限制",
"schema": {
"type": "integer",
"default": 20,
"minimum": 1,
"maximum": 100
}
}
],
"responses": {
"200": {
"description": "新闻情报列表",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NewsIntelResponse"
}
}
}
},
"500": {
"description": "服务器错误",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/system/config": {
"get": {
"tags": [
"SystemConfig"
],
"summary": "获取系统配置",
"description": "读取当前系统配置并返回分类后的显示值。服务端掩码的敏感字段可能返回 mask_token；客户端应结合 raw_value_exists 与 is_masked 判断。",
"operationId": "getSystemConfig",
"parameters": [
{
"name": "include_schema",
"in": "query",
"description": "是否携带字段元数据（默认 true）",
"schema": {
"type": "boolean",
"default": true
}
}
],
"responses": {
"200": {
"description": "配置读取成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemConfigResponse"
}
}
}
},
"401": {
"description": "未认证",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "读取失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
},
"put": {
"tags": [
"SystemConfig"
],
"summary": "更新系统配置",
"description": "按键更新系统配置。若字段值为掩码（如 ******），则保留原值不覆盖。",
"operationId": "updateSystemConfig",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateSystemConfigRequest"
}
}
}
},
"responses": {
"200": {
"description": "更新成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateSystemConfigResponse"
}
}
}
},
"400": {
"description": "参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemConfigValidationErrorResponse"
}
}
}
},
"409": {
"description": "配置版本冲突",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemConfigConflictResponse"
}
}
}
},
"500": {
"description": "更新失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/system/config/export": {
"get": {
"tags": [
"SystemConfig"
],
"summary": "导出 `.env` 备份",
"description": "返回当前已保存 `.env` 的原始文本内容，用于配置备份。",
"operationId": "exportSystemConfig",
"responses": {
"200": {
"description": "导出成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ExportSystemConfigResponse"
}
}
}
},
"401": {
"description": "未登录",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"403": {
"description": "未开启管理员鉴权（`ADMIN_AUTH_ENABLED=false`）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "导出失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/system/config/import": {
"post": {
"tags": [
"SystemConfig"
],
"summary": "导入 `.env` 备份",
"description": "按键级覆盖方式把备份文本合并到当前 `.env`，并沿用现有配置版本冲突保护。",
"operationId": "importSystemConfig",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ImportSystemConfigRequest"
}
}
}
},
"responses": {
"200": {
"description": "导入成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UpdateSystemConfigResponse"
}
}
}
},
"400": {
"description": "导入文件无效或配置校验失败",
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/ErrorResponse"
},
{
"$ref": "#/components/schemas/SystemConfigValidationErrorResponse"
}
]
}
}
}
},
"401": {
"description": "未认证",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"403": {
"description": "未开启管理员鉴权（`ADMIN_AUTH_ENABLED=false`）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"409": {
"description": "配置版本冲突",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemConfigConflictResponse"
}
}
}
},
"500": {
"description": "导入失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/system/config/validate": {
"post": {
"tags": [
"SystemConfig"
],
"summary": "校验配置",
"description": "仅校验提交内容，不写入 .env。用于前端保存前预检查。",
"operationId": "validateSystemConfig",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ValidateSystemConfigRequest"
}
}
}
},
"responses": {
"200": {
"description": "校验完成",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ValidateSystemConfigResponse"
}
}
}
},
"500": {
"description": "校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/system/config/schema": {
"get": {
"tags": [
"SystemConfig"
],
"summary": "获取配置字段元数据",
"description": "返回配置分类、字段类型、校验规则和 UI 控件建议，用于前端动态渲染。",
"operationId": "getSystemConfigSchema",
"responses": {
"200": {
"description": "元数据读取成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemConfigSchemaResponse"
}
}
}
},
"500": {
"description": "元数据读取失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals": {
"post": {
"tags": [
"DecisionSignals"
],
"summary": "创建或去重决策信号",
"description": "显式写入 DecisionSignal。未传 horizon/expires_at 时由服务补默认生命周期；命中同源去重键或窄 relaxed 去重时返回已有记录和 created=false；active 新建或 expired 续期会失效同股旧 active 相反信号，active duplicate retry 也会重跑该修复；普通旧 duplicate/replay 不作为新的激活事件；不保证并发绝对幂等。",
"operationId": "createDecisionSignal",
"security": [
{
"AdminSessionCookie": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalCreateRequest"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalMutationResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "请求字段非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "请求体或路径参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "创建失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
},
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询决策信号列表",
"description": "分页查询 DecisionSignal；读取前会懒过期已到 expires_at 的 active 信号。当 source_type=analysis 且只传 source_report_id 查询时，若无命中信号会尝试基于该历史报告一次性懒回填 （仅首次命中列表场景，且该精确查询会触发历史决策信号回填写入，属于 read-with-write 行为；不影响其他分页列表筛选参数场景）。holding_only=true 只读取 active 账户的 portfolio_positions 缓存持仓，不触发 portfolio snapshot replay。",
"operationId": "listDecisionSignals",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "market",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional market filter: cn/hk/us/jp/kr/tw",
"title": "Market"
},
"description": "Optional market filter: cn/hk/us/jp/kr/tw"
},
{
"name": "stock_code",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional stock code filter",
"title": "Stock Code"
},
"description": "Optional stock code filter"
},
{
"name": "action",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional decision action filter",
"title": "Action"
},
"description": "Optional decision action filter"
},
{
"name": "market_phase",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional market phase filter",
"title": "Market Phase"
},
"description": "Optional market phase filter"
},
{
"name": "decision_profile",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional decision profile filter: conservative/balanced/aggressive/unknown",
"title": "Decision Profile"
},
"description": "Optional decision profile filter: conservative/balanced/aggressive/unknown"
},
{
"name": "source_type",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional source type filter",
"title": "Source Type"
},
"description": "Optional source type filter"
},
{
"name": "source_report_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Optional source report id filter",
"title": "Source Report Id"
},
"description": "Optional source report id filter"
},
{
"name": "trace_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional trace id filter",
"title": "Trace Id"
},
"description": "Optional trace id filter"
},
{
"name": "trigger_source",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional trigger source filter",
"title": "Trigger Source"
},
"description": "Optional trigger source filter"
},
{
"name": "status",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional status filter",
"title": "Status"
},
"description": "Optional status filter"
},
{
"name": "created_from",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Inclusive created_at lower bound",
"title": "Created From"
},
"description": "Inclusive created_at lower bound"
},
{
"name": "created_to",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Inclusive created_at upper bound",
"title": "Created To"
},
"description": "Inclusive created_at upper bound"
},
{
"name": "expires_from",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Inclusive expires_at lower bound",
"title": "Expires From"
},
"description": "Inclusive expires_at lower bound"
},
{
"name": "expires_to",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Inclusive expires_at upper bound",
"title": "Expires To"
},
"description": "Inclusive expires_at upper bound"
},
{
"name": "holding_only",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Filter to active cached portfolio holdings only",
"default": false,
"title": "Holding Only"
},
"description": "Filter to active cached portfolio holdings only"
},
{
"name": "account_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Optional active portfolio account id for holding_only",
"title": "Account Id"
},
"description": "Optional active portfolio account id for holding_only"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"default": 1,
"title": "Page"
}
},
{
"name": "page_size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 20,
"title": "Page Size"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalListResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "查询参数非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "查询参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "查询失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals/latest/{stock_code}": {
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询股票最新 active 决策信号",
"description": "返回指定股票最新 active 信号列表；读取前会执行懒过期。",
"operationId": "getLatestDecisionSignals",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "stock_code",
"in": "path",
"required": true,
"schema": {
"type": "string",
"title": "Stock Code"
}
},
{
"name": "market",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional market filter: cn/hk/us/jp/kr/tw",
"title": "Market"
},
"description": "Optional market filter: cn/hk/us/jp/kr/tw"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 1,
"title": "Limit"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalListResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "请求参数非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "路径或查询参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "查询失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals/{signal_id}": {
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询单条决策信号",
"description": "按 ID 查询单条 DecisionSignal；读取前会执行懒过期。",
"operationId": "getDecisionSignal",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "signal_id",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"title": "Signal Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalItem"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": "信号不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "路径参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "查询失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals/{signal_id}/status": {
"patch": {
"tags": [
"DecisionSignals"
],
"summary": "更新决策信号状态",
"description": "只更新合法状态和可选 metadata；省略 metadata 时保留原值，null 时清空，object 时按整包替换并保持正式 decision_profile 身份。expired/invalidated/closed/archived 等 terminal 状态不能直接 PATCH 回 active。",
"operationId": "updateDecisionSignalStatus",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "signal_id",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"title": "Signal Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalStatusUpdateRequest"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalItem"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "状态非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": "信号不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "请求体或路径参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "更新失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/analysis/tasks/{task_id}/flow": {
"get": {
"tags": [
"Analysis"
],
"summary": "获取分析任务运行流",
"description": "根据 task_id 查询活跃任务或已落库任务的运行流快照。活跃任务缺少诊断时返回 skeleton flow；完成任务可按同一 task_id/query_id 尝试读取历史诊断。",
"operationId": "getTaskRunFlow",
"parameters": [
{
"name": "task_id",
"in": "path",
"required": true,
"description": "分析任务 ID",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "任务运行流快照",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RunFlowSnapshot"
}
}
}
},
"404": {
"description": "任务不存在或已过期",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "服务器错误",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/history/{record_id}/flow": {
"get": {
"tags": [
"History"
],
"summary": "获取历史报告运行流",
"description": "根据历史记录 ID 或可解析的 query_id 获取历史报告运行流快照。旧历史缺少诊断时返回 skeleton/unknown 状态，不影响报告详情读取。",
"operationId": "getHistoryRunFlow",
"parameters": [
{
"name": "record_id",
"in": "path",
"required": true,
"description": "历史记录主键 ID 或 query_id",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "历史报告运行流快照",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RunFlowSnapshot"
}
}
}
},
"404": {
"description": "报告不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "服务器错误",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/usage/summary": {
"get": {
"tags": [
"Usage"
],
"summary": "LLM token usage summary",
"description": "Aggregate token consumption by period, call type, and model.",
"operationId": "get_usage_summary_api_v1_usage_summary_get",
"parameters": [
{
"name": "period",
"in": "query",
"required": false,
"schema": {
"type": "string",
"description": "'today' | 'month' | 'all'",
"default": "month",
"title": "Period"
},
"description": "'today' | 'month' | 'all'"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UsageSummaryResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/v1/usage/dashboard": {
"get": {
"tags": [
"Usage"
],
"summary": "LLM token usage monitoring dashboard",
"description": "Return token totals, model breakdowns, and recent LLM call records.",
"operationId": "get_usage_dashboard_api_v1_usage_dashboard_get",
"parameters": [
{
"name": "period",
"in": "query",
"required": false,
"schema": {
"type": "string",
"description": "'today' | 'month' | 'all'",
"default": "month",
"title": "Period"
},
"description": "'today' | 'month' | 'all'"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Recent call records to include",
"default": 50,
"title": "Limit"
},
"description": "Recent call records to include"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UsageDashboardResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/v1/decision-signals/outcomes/run": {
"post": {
"tags": [
"DecisionSignals"
],
"summary": "触发决策信号后验评估",
"description": "显式触发 signal-level outcome 计算；默认跳过 completed 和终态 unable，但会重算缺少行情数据等可恢复 unable；force=true 会重算并覆盖同一 signal_id+horizon+engine_version。",
"operationId": "runDecisionSignalOutcomes",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalOutcomeRunRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalOutcomeRunResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "请求字段非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": "信号不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "请求体校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "后验计算失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
},
"security": [
{
"AdminSessionCookie": []
}
]
}
},
"/api/v1/decision-signals/outcomes": {
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询决策信号后验结果",
"description": "分页查询 signal-level outcome；默认只查当前 signal 后验 engine_version。",
"operationId": "listDecisionSignalOutcomes",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "signal_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"title": "Signal Id"
}
},
{
"name": "horizon",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Horizon"
}
},
{
"name": "engine_version",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Engine Version"
}
},
{
"name": "eval_status",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Eval Status"
}
},
{
"name": "outcome",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Outcome"
}
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"default": 1,
"title": "Page"
}
},
{
"name": "page_size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 20,
"title": "Page Size"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalOutcomeListResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "查询参数非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "查询参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "查询失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals/outcomes/stats": {
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询决策信号后验统计",
"description": "默认统计当前 engine_version，且排除 archived 信号。",
"operationId": "getDecisionSignalOutcomeStats",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "horizons",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Horizons"
}
},
{
"name": "engine_version",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Engine Version"
}
},
{
"name": "statuses",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Statuses"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalOutcomeStatsResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "查询参数非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "查询参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "统计失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals/{signal_id}/outcomes": {
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询单个决策信号后验结果",
"description": "返回指定 signal_id 在当前 engine_version 下的后验结果。",
"operationId": "listDecisionSignalOutcomesBySignal",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "signal_id",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"title": "Signal Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalOutcomeListResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": "信号不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "路径参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "查询失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/decision-signals/{signal_id}/feedback": {
"get": {
"tags": [
"DecisionSignals"
],
"summary": "查询决策信号用户反馈",
"description": "没有反馈时返回 feedback_value=null；信号不存在时返回 404。",
"operationId": "getDecisionSignalFeedback",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "signal_id",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"title": "Signal Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalFeedbackItem"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": "信号不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "路径参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "查询失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
},
"put": {
"tags": [
"DecisionSignals"
],
"summary": "写入决策信号用户反馈",
"description": "按 signal_id upsert 最新 useful/not_useful 反馈。",
"operationId": "putDecisionSignalFeedback",
"security": [
{
"AdminSessionCookie": []
}
],
"parameters": [
{
"name": "signal_id",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"title": "Signal Id"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalFeedbackRequest"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalFeedbackItem"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "请求字段非法",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": "信号不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "请求体或路径参数校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "更新失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/alerts/triggers": {
"get": {
"tags": [
"Alerts"
],
"summary": "List alert trigger history",
"operationId": "list_triggers_api_v1_alerts_triggers_get",
"parameters": [
{
"name": "rule_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Optional rule id filter",
"title": "Rule Id"
},
"description": "Optional rule id filter"
},
{
"name": "target",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional target filter",
"title": "Target"
},
"description": "Optional target filter"
},
{
"name": "status",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional status filter",
"title": "Status"
},
"description": "Optional status filter"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"default": 1,
"title": "Page"
}
},
{
"name": "page_size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"default": 20,
"title": "Page Size"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AlertTriggerListResponse"
}
}
}
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
},
"description": "Internal Server Error"
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/v1/portfolio/risk": {
"get": {
"tags": [
"Portfolio"
],
"summary": "Get portfolio risk report",
"operationId": "get_risk_report_api_v1_portfolio_risk_get",
"parameters": [
{
"name": "account_id",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Optional account id",
"title": "Account Id"
},
"description": "Optional account id"
},
{
"name": "as_of",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"description": "Risk report date, default today",
"title": "As Of"
},
"description": "Risk report date, default today"
},
{
"name": "cost_method",
"in": "query",
"required": false,
"schema": {
"type": "string",
"description": "Cost method: fifo or avg",
"default": "fifo",
"title": "Cost Method"
},
"description": "Cost method: fifo or avg"
},
{
"name": "include_realtime",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"description": "Whether today's risk snapshot should try realtime quotes before historical close fallback",
"default": true,
"title": "Include Realtime"
},
"description": "Whether today's risk snapshot should try realtime quotes before historical close fallback"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PortfolioRiskResponse"
}
}
}
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
},
"description": "Bad Request"
},
"500": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
},
"description": "Internal Server Error"
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/v1/decision-signals/reassess": {
"post": {
"tags": [
"DecisionSignals"
],
"summary": "重评估决策风格并可选保存",
"description": "基于 source_report_id 对应的持久化历史报告快照重新计算 decision_profile 信号；persist=false 返回只读 preview，persist=true 将通过 guardrail 的服务端结果写入 DecisionSignal。",
"operationId": "reassessDecisionSignalPreview",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalReassessRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalReassessResponse"
}
}
}
},
"401": {
"description": "未登录或管理员会话无效（ADMIN_AUTH_ENABLED=true 时）",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"400": {
"description": "历史报告不适用或持久化被风控阻断",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DecisionSignalReassessErrorResponse"
}
}
}
},
"404": {
"description": "来源历史报告不存在",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "请求体校验失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "重评估失败",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
},
"security": [
{
"AdminSessionCookie": []
}
]
}
},
"/api/v1/data/overview": {
"get": {
"tags": [
"Data"
],
"summary": "Get data capability overview",
"description": "Return provider capabilities, dataset quality, and source priority without exposing secrets.",
"operationId": "get_data_overview_api_v1_data_overview_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DataCapabilityOverviewResponse"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/data/capabilities": {
"get": {
"tags": [
"Data"
],
"summary": "Get data provider capabilities",
"description": "Alias of /data/overview for clients that only need capability metadata.",
"operationId": "get_data_capabilities_api_v1_data_capabilities_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DataCapabilityOverviewResponse"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
},
"/api/v1/stocks/{stock_code}/profile": {
"get": {
"tags": [
"Stocks"
],
"summary": "获取个股研究聚合档案",
"description": "按独立质量状态聚合行情、历史、研究产物、资讯、持仓关系和监控规则。",
"operationId": "get_stock_profile_api_v1_stocks__stock_code__profile_get",
"parameters": [
{
"name": "stock_code",
"in": "path",
"required": true,
"schema": {
"type": "string",
"title": "Stock Code"
}
},
{
"name": "history_days",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "日线历史天数",
"default": 60,
"title": "History Days"
},
"description": "日线历史天数"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StockProfileResponse"
}
}
}
},
"400": {
"description": "股票代码无效",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "服务器错误",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"RootResponse": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Daily Stock Analysis API is running"
},
"version": {
"type": "string",
"example": "1.0.0"
}
},
"required": [
"message"
]
},
"HealthResponse": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "ok"
},
"timestamp": {
"type": "string",
"format": "date-time"
}
},
"required": [
"status"
]
},
"AnalyzeRequest": {
"type": "object",
"properties": {
"stock_code": {
"type": "string",
"description": "单只股票代码",
"example": "600519"
},
"stock_codes": {
"type": "array",
"description": "多只股票代码（与 stock_code 二选一）",
"items": {
"type": "string"
},
"example": [
"600519",
"000858"
]
},
"report_type": {
"type": "string",
"enum": [
"simple",
"detailed",
"full",
"brief"
],
"default": "detailed",
"description": "报告类型：simple(精简) / detailed(完整) / full(完整) / brief(简洁)"
},
"force_refresh": {
"type": "boolean",
"default": false,
"description": "是否强制刷新（忽略缓存）"
},
"async_mode": {
"type": "boolean",
"default": false,
"description": "是否使用异步模式"
},
"analysis_phase": {
"type": "string",
"enum": [
"auto",
"premarket",
"intraday",
"postmarket"
],
"default": "auto",
"description": "分析阶段覆盖：auto(自动推断) / premarket(盘前) / intraday(盘中) / postmarket(盘后)"
}
}
},
"AnalysisResult": {
"type": "object",
"properties": {
"query_id": {
"type": "string",
"description": "分析记录唯一标识"
},
"stock_code": {
"type": "string"
},
"stock_name": {
"type": "string"
},
"report": {
"$ref": "#/components/schemas/AnalysisReport"
},
"created_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"query_id",
"stock_code",
"report",
"created_at"
]
},
"TaskAccepted": {
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "任务 ID，用于查询状态"
},
"status": {
"type": "string",
"enum": [
"pending",
"processing"
],
"example": "pending"
},
"message": {
"type": "string",
"example": "Analysis task accepted"
},
"analysis_phase": {
"type": "string",
"enum": [
"auto",
"premarket",
"intraday",
"postmarket"
],
"default": "auto",
"description": "请求的分析阶段"
}
},
"required": [
"task_id",
"status"
]
},
"BatchTaskAcceptedItem": {
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "任务 ID，用于查询状态"
},
"stock_code": {
"type": "string",
"description": "股票代码"
},
"status": {
"type": "string",
"enum": [
"pending",
"processing"
]
},
"message": {
"type": "string"
},
"analysis_phase": {
"type": "string",
"enum": [
"auto",
"premarket",
"intraday",
"postmarket"
],
"default": "auto",
"description": "请求的分析阶段"
}
},
"required": [
"task_id",
"stock_code",
"status"
]
},
"BatchDuplicateTaskItem": {
"type": "object",
"properties": {
"stock_code": {
"type": "string",
"description": "股票代码"
},
"existing_task_id": {
"type": "string",
"description": "已存在的任务 ID"
},
"message": {
"type": "string",
"description": "错误信息"
}
},
"required": [
"stock_code",
"existing_task_id",
"message"
]
},
"BatchTaskAcceptedResponse": {
"type": "object",
"properties": {
"accepted": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BatchTaskAcceptedItem"
}
},
"duplicates": {
"type": "array",
"items": {
"$ref": "#/components/schemas/BatchDuplicateTaskItem"
}
},
"message": {
"type": "string",
"description": "汇总信息"
}
},
"required": [
"accepted",
"duplicates",
"message"
]
},
"TaskStatus": {
"type": "object",
"properties": {
"task_id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pending",
"processing",
"completed",
"failed"
]
},
"progress": {
"type": "integer",
"description": "进度百分比 (0-100)"
},
"result": {
"$ref": "#/components/schemas/AnalysisResult"
},
"error": {
"type": "string",
"description": "错误信息（仅在 failed 时存在）"
},
"analysis_phase": {
"type": "string",
"enum": [
"auto",
"premarket",
"intraday",
"postmarket"
],
"nullable": true,
"description": "请求的分析阶段；无持久化字段的历史 DB fallback 可能为空"
}
},
"required": [
"task_id",
"status"
]
},
"TaskInfo": {
"type": "object",
"description": "任务详情（用于任务列表和 SSE 事件）",
"properties": {
"task_id": {
"type": "string",
"description": "任务 ID"
},
"stock_code": {
"type": "string",
"description": "股票代码"
},
"stock_name": {
"type": "string",
"description": "股票名称"
},
"status": {
"type": "string",
"enum": [
"pending",
"processing",
"completed",
"failed"
],
"description": "任务状态"
},
"progress": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"description": "进度百分比"
},
"message": {
"type": "string",
"description": "状态消息"
},
"report_type": {
"type": "string",
"enum": [
"simple",
"detailed"
],
"description": "报告类型"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "创建时间"
},
"started_at": {
"type": "string",
"format": "date-time",
"description": "开始执行时间"
},
"completed_at": {
"type": "string",
"format": "date-time",
"description": "完成时间"
},
"error": {
"type": "string",
"description": "错误信息"
},
"analysis_phase": {
"type": "string",
"enum": [
"auto",
"premarket",
"intraday",
"postmarket"
],
"default": "auto",
"description": "请求的分析阶段"
}
},
"required": [
"task_id",
"stock_code",
"status",
"created_at"
]
},
"TaskListResponse": {
"type": "object",
"description": "任务列表响应",
"properties": {
"total": {
"type": "integer",
"description": "任务总数"
},
"pending": {
"type": "integer",
"description": "等待中的任务数"
},
"processing": {
"type": "integer",
"description": "处理中的任务数"
},
"tasks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TaskInfo"
},
"description": "任务列表"
}
},
"required": [
"total",
"pending",
"processing",
"tasks"
]
},
"DuplicateTaskError": {
"type": "object",
"description": "重复任务错误响应",
"properties": {
"error": {
"type": "string",
"example": "duplicate_task",
"description": "错误类型"
},
"message": {
"type": "string",
"example": "股票 600519 正在分析中",
"description": "错误信息"
},
"stock_code": {
"type": "string",
"example": "600519",
"description": "股票代码"
},
"existing_task_id": {
"type": "string",
"example": "abc123def456",
"description": "已存在的任务 ID"
}
},
"required": [
"error",
"message",
"stock_code",
"existing_task_id"
]
},
"HistoryListResponse": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "总记录数"
},
"page": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/HistoryItem"
}
}
},
"required": [
"total",
"page",
"limit",
"items"
]
},
"NewsIntelItem": {
"type": "object",
"description": "新闻情报条目",
"properties": {
"title": {
"type": "string",
"description": "新闻标题"
},
"snippet": {
"type": "string",
"description": "新闻摘要（最多50字）"
},
"url": {
"type": "string",
"description": "新闻链接"
}
},
"required": [
"title",
"url"
]
},
"NewsIntelResponse": {
"type": "object",
"description": "新闻情报响应",
"properties": {
"total": {
"type": "integer",
"description": "新闻条数"
},
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/NewsIntelItem"
},
"description": "新闻列表"
}
},
"required": [
"total",
"items"
]
},
"HistoryItem": {
"type": "object",
"description": "历史记录摘要（列表展示用）",
"properties": {
"query_id": {
"type": "string"
},
"stock_code": {
"type": "string"
},
"stock_name": {
"type": "string"
},
"report_type": {
"type": "string"
},
"sentiment_score": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"operation_advice": {
"type": "string"
},
"action": {
"type": "string",
"description": "结构化建议动作 taxonomy",
"nullable": true,
"enum": [
"buy",
"add",
"hold",
"reduce",
"sell",
"watch",
"avoid",
"alert"
]
},
"action_label": {
"type": "string",
"description": "建议动作展示标签",
"nullable": true
},
"model_used": {
"type": "string",
"description": "历史记录中展示的模型快照，仅用于展示与排障，不影响 provider/model/base URL 运行时路由"
},
"created_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"query_id",
"stock_code",
"created_at"
]
},
"AnalysisReport": {
"type": "object",
"description": "完整分析报告",
"properties": {
"meta": {
"type": "object",
"description": "元信息",
"properties": {
"query_id": {
"type": "string"
},
"stock_code": {
"type": "string"
},
"stock_name": {
"type": "string"
},
"report_type": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"model_used": {
"type": "string",
"description": "历史快照中的模型名称，仅供展示，不参与运行时 provider/model/base URL 路由、清理或迁移"
}
}
},
"summary": {
"type": "object",
"description": "概览区（首屏展示）",
"properties": {
"analysis_summary": {
"type": "string",
"description": "关键结论"
},
"operation_advice": {
"type": "string",
"description": "操作建议"
},
"action": {
"type": "string",
"description": "结构化建议动作 taxonomy",
"nullable": true,
"enum": [
"buy",
"add",
"hold",
"reduce",
"sell",
"watch",
"avoid",
"alert"
]
},
"action_label": {
"type": "string",
"description": "建议动作展示标签",
"nullable": true
},
"trend_prediction": {
"type": "string",
"description": "趋势预测"
},
"sentiment_score": {
"type": "integer",
"description": "情绪评分 (0-100)"
},
"sentiment_label": {
"type": "string",
"description": "情绪标签",
"enum": [
"极度悲观",
"悲观",
"中性",
"乐观",
"极度乐观"
]
}
}
},
"strategy": {
"type": "object",
"description": "策略点位区",
"properties": {
"ideal_buy": {
"type": "string",
"description": "理想买入价"
},
"secondary_buy": {
"type": "string",
"description": "第二买入价"
},
"stop_loss": {
"type": "string",
"description": "止损价"
},
"take_profit": {
"type": "string",
"description": "止盈价"
}
}
},
"details": {
"type": "object",
"description": "详情区（可折叠）",
"properties": {
"news_content": {
"type": "string",
"description": "新闻摘要"
},
"raw_result": {
"type": "object",
"description": "原始分析结果（JSON）"
},
"context_snapshot": {
"type": "object",
"description": "分析时上下文快照（JSON）"
},
"market_structure": {
"type": "object",
"description": "市场结构上下文（题材主线与个股市场位置信息，JSON）"
}
}
},
"structured_report": {
"anyOf": [
{
"$ref": "#/components/schemas/ResearchArtifact"
},
{
"type": "null"
}
],
"description": "结构化研究产物，供看板、个股研究页、监控和 Copilot 复用"
}
},
"required": [
"meta",
"summary"
]
},
"ResearchArtifact": {
"properties": {
"schema_version": {
"type": "string",
"const": "research-artifact-v1",
"title": "Schema Version",
"default": "research-artifact-v1"
},
"artifact_id": {
"type": "string",
"minLength": 1,
"title": "Artifact Id"
},
"source_report_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Source Report Id"
},
"source_query_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Query Id"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created At"
},
"subject": {
"$ref": "#/components/schemas/ResearchSubject"
},
"thesis": {
"$ref": "#/components/schemas/ResearchThesis"
},
"evidence": {
"items": {
"$ref": "#/components/schemas/ResearchEvidenceItem"
},
"type": "array",
"title": "Evidence"
},
"invalidation_conditions": {
"items": {
"$ref": "#/components/schemas/ResearchInvalidationCondition"
},
"type": "array",
"minItems": 1,
"title": "Invalidation Conditions"
},
"next_actions": {
"items": {
"$ref": "#/components/schemas/ResearchNextAction"
},
"type": "array",
"title": "Next Actions"
},
"data_quality": {
"$ref": "#/components/schemas/ResearchDataQuality"
},
"metadata": {
"additionalProperties": true,
"type": "object",
"title": "Metadata"
}
},
"type": "object",
"required": [
"artifact_id",
"subject",
"thesis",
"invalidation_conditions"
],
"title": "ResearchArtifact",
"description": "Structured report artifact for dashboard, stock detail, monitor and copilot reuse."
},
"ResearchDataQuality": {
"properties": {
"level": {
"type": "string",
"enum": [
"good",
"usable",
"limited",
"poor",
"unknown"
],
"title": "Level",
"default": "unknown"
},
"overall_score": {
"anyOf": [
{
"type": "integer",
"maximum": 100.0,
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Overall Score"
},
"source_count": {
"type": "integer",
"minimum": 0.0,
"title": "Source Count",
"default": 0
},
"stale_count": {
"type": "integer",
"minimum": 0.0,
"title": "Stale Count",
"default": 0
},
"missing_blocks": {
"items": {
"type": "string"
},
"type": "array",
"title": "Missing Blocks"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"title": "ResearchDataQuality",
"description": "Low-sensitive quality summary for the artifact inputs."
},
"ResearchEvidenceItem": {
"properties": {
"id": {
"type": "string",
"minLength": 1,
"title": "Id"
},
"source_type": {
"type": "string",
"minLength": 1,
"title": "Source Type"
},
"title": {
"type": "string",
"minLength": 1,
"title": "Title"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Summary"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source"
},
"freshness": {
"type": "string",
"enum": [
"fresh",
"stale",
"unknown"
],
"title": "Freshness",
"default": "unknown"
},
"quality_level": {
"type": "string",
"enum": [
"good",
"usable",
"limited",
"poor",
"unknown"
],
"title": "Quality Level",
"default": "unknown"
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "As Of"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"metadata": {
"additionalProperties": true,
"type": "object",
"title": "Metadata"
}
},
"type": "object",
"required": [
"id",
"source_type",
"title"
],
"title": "ResearchEvidenceItem",
"description": "One evidence item with freshness and quality status."
},
"ResearchInvalidationCondition": {
"properties": {
"id": {
"type": "string",
"minLength": 1,
"title": "Id"
},
"category": {
"type": "string",
"enum": [
"price",
"volume",
"evidence",
"market",
"time",
"data_quality",
"manual"
],
"title": "Category"
},
"description": {
"type": "string",
"minLength": 1,
"title": "Description"
},
"trigger": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trigger"
},
"severity": {
"type": "string",
"enum": [
"watch",
"warning",
"critical"
],
"title": "Severity",
"default": "warning"
},
"metric": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Metric"
},
"threshold": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Threshold"
},
"due_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Due At"
},
"metadata": {
"additionalProperties": true,
"type": "object",
"title": "Metadata"
}
},
"type": "object",
"required": [
"id",
"category",
"description"
],
"title": "ResearchInvalidationCondition",
"description": "Condition that should invalidate or force reassessment of the thesis."
},
"ResearchNextAction": {
"properties": {
"action": {
"type": "string",
"minLength": 1,
"title": "Action"
},
"label": {
"type": "string",
"minLength": 1,
"title": "Label"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason"
},
"due_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Due At"
},
"metadata": {
"additionalProperties": true,
"type": "object",
"title": "Metadata"
}
},
"type": "object",
"required": [
"action",
"label"
],
"title": "ResearchNextAction",
"description": "Suggested next action for a human or workflow."
},
"ResearchSubject": {
"properties": {
"stock_code": {
"type": "string",
"minLength": 1,
"title": "Stock Code"
},
"stock_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stock Name"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market"
},
"entity_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Entity Ref",
"description": "Optional EntityLink ref when available"
}
},
"type": "object",
"required": [
"stock_code"
],
"title": "ResearchSubject",
"description": "The entity being researched."
},
"ResearchThesis": {
"properties": {
"direction": {
"type": "string",
"enum": [
"bullish",
"bearish",
"neutral",
"unknown"
],
"title": "Direction",
"default": "unknown"
},
"summary": {
"type": "string",
"title": "Summary",
"description": "Concise thesis statement",
"default": ""
},
"confidence": {
"anyOf": [
{
"type": "number",
"maximum": 1.0,
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Confidence"
},
"score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Score",
"description": "Original sentiment score when available"
},
"horizon": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Horizon"
},
"action": {
"anyOf": [
{
"type": "string",
"enum": [
"buy",
"add",
"hold",
"reduce",
"sell",
"watch",
"avoid",
"alert"
]
},
{
"type": "null"
}
],
"title": "Action"
},
"action_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action Label"
},
"reasons": {
"items": {
"type": "string"
},
"type": "array",
"title": "Reasons"
},
"risks": {
"items": {
"type": "string"
},
"type": "array",
"title": "Risks"
}
},
"type": "object",
"title": "ResearchThesis",
"description": "Structured investment thesis extracted from a report."
},
"StockQuote": {
"type": "object",
"description": "股票实时行情",
"properties": {
"stock_code": {
"type": "string"
},
"stock_name": {
"type": "string"
},
"current_price": {
"type": "number"
},
"change": {
"type": "number",
"description": "涨跌额"
},
"change_percent": {
"type": "number",
"description": "涨跌幅 (%)"
},
"open": {
"type": "number"
},
"high": {
"type": "number"
},
"low": {
"type": "number"
},
"prev_close": {
"type": "number"
},
"volume": {
"type": "number",
"description": "成交量（股）"
},
"amount": {
"type": "number",
"description": "成交额（元）"
},
"update_time": {
"type": "string",
"format": "date-time"
}
},
"required": [
"stock_code",
"current_price"
]
},
"SystemConfigFieldSchema": {
"type": "object",
"description": "系统配置字段元数据",
"properties": {
"key": {
"type": "string",
"description": "配置键名（ENV 变量）",
"example": "GEMINI_API_KEY"
},
"title": {
"type": "string",
"description": "前端展示标题",
"example": "Gemini API Key"
},
"description": {
"type": "string",
"description": "字段说明"
},
"category": {
"type": "string",
"enum": [
"base",
"data_source",
"ai_model",
"notification",
"system",
"backtest",
"uncategorized"
],
"description": "分类"
},
"data_type": {
"type": "string",
"enum": [
"string",
"integer",
"number",
"boolean",
"array",
"json",
"time"
]
},
"ui_control": {
"type": "string",
"enum": [
"text",
"password",
"number",
"select",
"textarea",
"switch",
"time"
],
"description": "前端控件建议"
},
"is_sensitive": {
"type": "boolean"
},
"is_required": {
"type": "boolean"
},
"is_editable": {
"type": "boolean"
},
"default_value": {
"type": "string",
"nullable": true
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "可选值列表（用于 select）"
},
"validation": {
"type": "object",
"description": "校验规则定义（min/max/regex/enum/custom）"
},
"display_order": {
"type": "integer"
}
},
"required": [
"key",
"category",
"data_type",
"ui_control",
"is_sensitive",
"is_required",
"is_editable",
"display_order"
]
},
"SystemConfigCategorySchema": {
"type": "object",
"description": "配置分类元数据",
"properties": {
"category": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"display_order": {
"type": "integer"
},
"fields": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SystemConfigFieldSchema"
}
}
},
"required": [
"category",
"title",
"display_order",
"fields"
]
},
"SystemConfigSchemaResponse": {
"type": "object",
"description": "配置元数据响应",
"properties": {
"schema_version": {
"type": "string",
"example": "2026-02-09"
},
"categories": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SystemConfigCategorySchema"
}
}
},
"required": [
"schema_version",
"categories"
]
},
"SystemConfigItem": {
"type": "object",
"description": "系统配置项（含脱敏显示值）",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string",
"description": "当前配置值；敏感字段可能返回掩码，真实值不保证返回，客户端应结合 raw_value_exists 与 is_masked 判断"
},
"raw_value_exists": {
"type": "boolean",
"description": "保存配置中是否存在该 key 的原始值；为 false 时 value 可能来自默认值或运行时环境，敏感运行时值仍可能被服务端掩码"
},
"is_masked": {
"type": "boolean",
"description": "value 是否为服务端掩码显示值"
},
"schema": {
"$ref": "#/components/schemas/SystemConfigFieldSchema"
}
},
"required": [
"key",
"value",
"raw_value_exists",
"is_masked"
]
},
"SystemConfigResponse": {
"type": "object",
"description": "系统配置读取响应",
"properties": {
"config_version": {
"type": "string",
"description": "配置版本（用于乐观锁）",
"example": "2026-02-09T13:20:31Z:sha256:4f9a..."
},
"mask_token": {
"type": "string",
"example": "******"
},
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SystemConfigItem"
}
},
"updated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"config_version",
"mask_token",
"items"
]
},
"ExportSystemConfigResponse": {
"type": "object",
"description": "`.env` 原文导出响应",
"properties": {
"content": {
"type": "string",
"description": "当前已保存 `.env` 的原始文本内容"
},
"config_version": {
"type": "string",
"description": "导出时对应的配置版本"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"content",
"config_version"
]
},
"SystemConfigUpdateItem": {
"type": "object",
"description": "配置更新项",
"properties": {
"key": {
"type": "string",
"example": "STOCK_LIST"
},
"value": {
"type": "string",
"description": "字段新值；若敏感字段传入掩码 token 则表示保持原值"
}
},
"required": [
"key",
"value"
]
},
"UpdateSystemConfigRequest": {
"type": "object",
"description": "系统配置更新请求",
"properties": {
"config_version": {
"type": "string"
},
"mask_token": {
"type": "string",
"default": "******"
},
"reload_now": {
"type": "boolean",
"default": true
},
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SystemConfigUpdateItem"
},
"minItems": 1
}
},
"required": [
"config_version",
"items"
]
},
"ImportSystemConfigRequest": {
"type": "object",
"description": "`.env` 导入请求",
"properties": {
"config_version": {
"type": "string"
},
"content": {
"type": "string",
"description": "待导入的 `.env` 原始文本"
},
"reload_now": {
"type": "boolean",
"default": true
}
},
"required": [
"config_version",
"content"
]
},
"UpdateSystemConfigResponse": {
"type": "object",
"description": "系统配置更新结果",
"properties": {
"success": {
"type": "boolean"
},
"config_version": {
"type": "string"
},
"applied_count": {
"type": "integer"
},
"skipped_masked_count": {
"type": "integer"
},
"reload_triggered": {
"type": "boolean"
},
"updated_keys": {
"type": "array",
"items": {
"type": "string"
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"success",
"config_version",
"applied_count",
"skipped_masked_count",
"reload_triggered",
"updated_keys"
]
},
"ValidateSystemConfigRequest": {
"type": "object",
"description": "配置校验请求",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SystemConfigUpdateItem"
},
"minItems": 1
}
},
"required": [
"items"
]
},
"ConfigValidationIssue": {
"type": "object",
"description": "配置校验问题",
"properties": {
"key": {
"type": "string"
},
"code": {
"type": "string",
"example": "invalid_format"
},
"message": {
"type": "string"
},
"severity": {
"type": "string",
"enum": [
"error",
"warning"
]
},
"expected": {
"type": "string"
},
"actual": {
"type": "string"
}
},
"required": [
"key",
"code",
"message",
"severity"
]
},
"ValidateSystemConfigResponse": {
"type": "object",
"description": "配置校验结果",
"properties": {
"valid": {
"type": "boolean"
},
"issues": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConfigValidationIssue"
}
}
},
"required": [
"valid",
"issues"
]
},
"SystemConfigValidationErrorResponse": {
"type": "object",
"description": "配置更新校验失败响应",
"properties": {
"error": {
"type": "string",
"example": "validation_failed"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConfigValidationIssue"
}
}
},
"required": [
"error",
"message",
"issues"
]
},
"SystemConfigConflictResponse": {
"type": "object",
"description": "配置版本冲突响应",
"properties": {
"error": {
"type": "string",
"example": "config_version_conflict"
},
"message": {
"type": "string"
},
"current_config_version": {
"type": "string"
}
},
"required": [
"error",
"message",
"current_config_version"
]
},
"DecisionAction": {
"type": "string",
"enum": [
"buy",
"add",
"hold",
"reduce",
"sell",
"watch",
"avoid",
"alert"
],
"description": "八态建议动作，独立于旧 decision_type=buy|hold|sell 统计口径。"
},
"MarketPhaseValue": {
"type": "string",
"enum": [
"premarket",
"intraday",
"lunch_break",
"closing_auction",
"postmarket",
"non_trading",
"unknown"
]
},
"DecisionSignalCreateRequest": {
"properties": {
"stock_code": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"title": "Stock Code"
},
"stock_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 64,
"title": "Stock Name"
},
"market": {
"type": "string",
"enum": [
"cn",
"hk",
"us",
"jp",
"kr",
"tw"
],
"title": "Market"
},
"source_type": {
"type": "string",
"enum": [
"analysis",
"agent",
"alert",
"market_review",
"manual"
],
"title": "Source Type"
},
"source_agent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 64,
"title": "Source Agent"
},
"source_report_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Source Report Id"
},
"trace_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 64,
"title": "Trace Id"
},
"decision_profile": {
"type": "string",
"enum": [
"conservative",
"balanced",
"aggressive"
],
"title": "Decision Profile",
"description": "Optional decision profile. Omit to use server-side default/fallback; explicit null is rejected."
},
"market_phase": {
"anyOf": [
{
"type": "string",
"enum": [
"premarket",
"intraday",
"lunch_break",
"closing_auction",
"postmarket",
"non_trading",
"unknown"
]
},
{
"type": "null"
}
],
"title": "Market Phase"
},
"trigger_source": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"title": "Trigger Source"
},
"action": {
"type": "string",
"enum": [
"buy",
"add",
"hold",
"reduce",
"sell",
"watch",
"avoid",
"alert"
],
"title": "Action"
},
"action_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 32,
"title": "Action Label"
},
"confidence": {
"anyOf": [
{
"type": "number",
"maximum": 1.0,
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Confidence"
},
"score": {
"anyOf": [
{
"type": "integer",
"maximum": 100.0,
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Score"
},
"horizon": {
"anyOf": [
{
"type": "string",
"enum": [
"intraday",
"1d",
"3d",
"5d",
"10d",
"swing",
"long"
]
},
{
"type": "null"
}
],
"title": "Horizon"
},
"entry_low": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Entry Low"
},
"entry_high": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Entry High"
},
"stop_loss": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Stop Loss"
},
"target_price": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Target Price"
},
"invalidation": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Invalidation"
},
"watch_conditions": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Watch Conditions"
},
"reason": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Reason"
},
"risk_summary": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Risk Summary"
},
"catalyst_summary": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Catalyst Summary"
},
"evidence": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Evidence"
},
"data_quality_summary": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Data Quality Summary"
},
"plan_quality": {
"anyOf": [
{
"type": "string",
"enum": [
"complete",
"partial",
"minimal",
"unknown"
]
},
{
"type": "null"
}
],
"title": "Plan Quality"
},
"status": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"expired",
"invalidated",
"closed",
"archived"
]
},
{
"type": "null"
}
],
"title": "Status"
},
"expires_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Expires At"
},
"metadata": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Metadata",
"description": "Optional metadata object. Omitted or null values are treated as absent."
},
"report_language": {
"anyOf": [
{
"type": "string",
"enum": [
"zh",
"en",
"ko"
]
},
{
"type": "null"
}
],
"title": "Report Language"
}
},
"type": "object",
"required": [
"stock_code",
"market",
"source_type",
"trigger_source",
"action"
],
"title": "DecisionSignalCreateRequest"
},
"DecisionSignalStatusUpdateRequest": {
"properties": {
"status": {
"type": "string",
"enum": [
"active",
"expired",
"invalidated",
"closed",
"archived"
],
"title": "Status"
},
"metadata": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Metadata",
"description": "Optional replacement metadata. Omit to preserve the stored value; null clears it; an object replaces it while preserving the formal decision_profile identity."
}
},
"type": "object",
"required": [
"status"
],
"title": "DecisionSignalStatusUpdateRequest"
},
"DecisionSignalItem": {
"properties": {
"id": {
"type": "integer",
"title": "Id"
},
"stock_code": {
"type": "string",
"title": "Stock Code"
},
"stock_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stock Name"
},
"market": {
"type": "string",
"title": "Market"
},
"source_type": {
"type": "string",
"title": "Source Type"
},
"source_agent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Agent"
},
"source_report_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Source Report Id"
},
"trace_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trace Id"
},
"decision_profile": {
"anyOf": [
{
"type": "string",
"enum": [
"conservative",
"balanced",
"aggressive"
]
},
{
"type": "null"
}
],
"title": "Decision Profile"
},
"market_phase": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market Phase"
},
"trigger_source": {
"type": "string",
"title": "Trigger Source"
},
"action": {
"type": "string",
"title": "Action"
},
"action_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action Label"
},
"confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Confidence"
},
"score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Score"
},
"horizon": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Horizon"
},
"entry_low": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry Low"
},
"entry_high": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry High"
},
"stop_loss": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Stop Loss"
},
"target_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Target Price"
},
"invalidation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Invalidation"
},
"watch_conditions": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Watch Conditions"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason"
},
"risk_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Risk Summary"
},
"catalyst_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Catalyst Summary"
},
"evidence": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Evidence"
},
"data_quality_summary": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Data Quality Summary"
},
"plan_quality": {
"type": "string",
"title": "Plan Quality"
},
"status": {
"type": "string",
"title": "Status"
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expires At"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
},
"metadata": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Metadata"
}
},
"type": "object",
"required": [
"id",
"stock_code",
"market",
"source_type",
"trigger_source",
"action",
"plan_quality",
"status"
],
"title": "DecisionSignalItem"
},
"DecisionSignalMutationResponse": {
"properties": {
"item": {
"$ref": "#/components/schemas/DecisionSignalItem"
},
"created": {
"type": "boolean",
"title": "Created"
}
},
"type": "object",
"required": [
"item",
"created"
],
"title": "DecisionSignalMutationResponse"
},
"DecisionSignalListResponse": {
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/DecisionSignalItem"
},
"type": "array",
"title": "Items"
},
"total": {
"type": "integer",
"title": "Total"
},
"page": {
"type": "integer",
"title": "Page"
},
"page_size": {
"type": "integer",
"title": "Page Size"
}
},
"type": "object",
"required": [
"total",
"page",
"page_size"
],
"title": "DecisionSignalListResponse"
},
"ErrorResponse": {
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "错误类型",
"example": "validation_error"
},
"message": {
"type": "string",
"title": "Message",
"description": "错误详情",
"example": "请求参数错误"
},
"detail": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Detail",
"description": "附加错误信息"
}
},
"type": "object",
"required": [
"error",
"message"
],
"title": "ErrorResponse",
"description": "错误响应",
"example": {
"error": "not_found",
"message": "资源不存在"
}
},
"RunFlowLane": {
"type": "object",
"description": "运行流泳道定义",
"properties": {
"id": {
"type": "string",
"description": "稳定泳道 ID"
},
"label": {
"type": "string",
"description": "展示标签"
},
"order": {
"type": "integer",
"description": "展示顺序"
}
},
"required": [
"id",
"label",
"order"
]
},
"RunFlowNode": {
"type": "object",
"description": "运行流中的一个节点",
"properties": {
"id": {
"type": "string",
"description": "稳定节点 ID"
},
"lane": {
"type": "string",
"description": "所属泳道 ID"
},
"kind": {
"type": "string",
"enum": [
"entry",
"queue",
"data_source",
"analysis",
"model",
"artifact",
"notification"
],
"description": "节点类型"
},
"label": {
"type": "string",
"description": "展示标签"
},
"status": {
"type": "string",
"enum": [
"pending",
"running",
"success",
"failed",
"degraded",
"fallback",
"timeout",
"cancel_requested",
"cancelled",
"skipped",
"unknown"
],
"description": "节点状态"
},
"provider": {
"type": "string",
"nullable": true,
"description": "Provider、模型或通知渠道名称"
},
"started_at": {
"type": "string",
"nullable": true,
"description": "开始时间 ISO 字符串"
},
"ended_at": {
"type": "string",
"nullable": true,
"description": "结束时间 ISO 字符串"
},
"duration_ms": {
"type": "integer",
"nullable": true,
"minimum": 0,
"description": "耗时毫秒数"
},
"attempts": {
"type": "integer",
"nullable": true,
"minimum": 1,
"description": "节点代表的尝试次数"
},
"record_count": {
"type": "integer",
"nullable": true,
"minimum": 0,
"description": "返回记录数"
},
"message": {
"type": "string",
"nullable": true,
"description": "短脱敏状态说明"
},
"metadata": {
"type": "object",
"description": "脱敏后的低敏元数据",
"additionalProperties": true
}
},
"required": [
"id",
"lane",
"kind",
"label",
"status"
]
},
"RunFlowEdge": {
"type": "object",
"description": "运行流中的有向连线",
"properties": {
"id": {
"type": "string",
"description": "稳定连线 ID"
},
"from": {
"type": "string",
"description": "来源节点 ID"
},
"to": {
"type": "string",
"description": "目标节点 ID"
},
"kind": {
"type": "string",
"enum": [
"data",
"control",
"fallback",
"retry"
],
"description": "连线类型"
},
"status": {
"type": "string",
"enum": [
"pending",
"running",
"success",
"failed",
"degraded",
"fallback",
"timeout",
"cancel_requested",
"cancelled",
"skipped",
"unknown"
],
"description": "连线状态"
},
"label": {
"type": "string",
"nullable": true,
"description": "短展示标签"
},
"message": {
"type": "string",
"nullable": true,
"description": "短脱敏说明"
},
"metadata": {
"type": "object",
"description": "脱敏后的低敏元数据",
"additionalProperties": true
}
},
"required": [
"id",
"from",
"to",
"kind",
"status"
]
},
"RunFlowEvent": {
"type": "object",
"description": "运行流事件",
"properties": {
"id": {
"type": "string",
"description": "稳定事件 ID"
},
"timestamp": {
"type": "string",
"nullable": true,
"description": "事件时间 ISO 字符串"
},
"severity": {
"type": "string",
"enum": [
"info",
"success",
"warning",
"danger"
],
"description": "事件严重级别"
},
"type": {
"type": "string",
"description": "稳定事件类型"
},
"node_id": {
"type": "string",
"nullable": true,
"description": "关联节点 ID"
},
"title": {
"type": "string",
"description": "短标题"
},
"message": {
"type": "string",
"nullable": true,
"description": "短脱敏说明"
},
"metadata": {
"type": "object",
"description": "脱敏后的低敏元数据",
"additionalProperties": true
}
},
"required": [
"id",
"severity",
"type",
"title"
]
},
"RunFlowSummary": {
"type": "object",
"description": "运行流摘要指标",
"properties": {
"elapsed_ms": {
"type": "integer",
"nullable": true,
"minimum": 0,
"description": "观测到的总耗时毫秒数"
},
"bottleneck_node_id": {
"type": "string",
"nullable": true,
"description": "耗时最长节点 ID"
},
"failed_attempts": {
"type": "integer",
"minimum": 0,
"description": "失败尝试次数"
},
"fallback_count": {
"type": "integer",
"minimum": 0,
"description": "fallback 或 retry 转换次数"
},
"model": {
"type": "string",
"nullable": true,
"description": "诊断中观测到的脱敏模型名"
},
"data_source_count": {
"type": "integer",
"minimum": 0,
"description": "数据来源节点数量"
},
"event_count": {
"type": "integer",
"minimum": 0,
"description": "事件数量"
}
},
"required": [
"failed_attempts",
"fallback_count",
"data_source_count",
"event_count"
]
},
"RunFlowSnapshot": {
"type": "object",
"description": "任务或历史报告运行流快照",
"properties": {
"task_id": {
"type": "string",
"description": "任务 ID 或 query_id"
},
"trace_id": {
"type": "string",
"nullable": true,
"description": "诊断 trace ID"
},
"stock_code": {
"type": "string",
"description": "股票代码"
},
"stock_name": {
"type": "string",
"nullable": true,
"description": "股票名称"
},
"status": {
"type": "string",
"enum": [
"pending",
"running",
"success",
"failed",
"degraded",
"fallback",
"timeout",
"cancel_requested",
"cancelled",
"skipped",
"unknown"
],
"description": "整体运行流状态"
},
"summary": {
"$ref": "#/components/schemas/RunFlowSummary"
},
"lanes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RunFlowLane"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RunFlowNode"
}
},
"edges": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RunFlowEdge"
}
},
"events": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RunFlowEvent"
}
},
"generated_at": {
"type": "string",
"description": "快照生成时间 ISO 字符串"
}
},
"required": [
"task_id",
"stock_code",
"status",
"summary",
"lanes",
"nodes",
"edges",
"events",
"generated_at"
]
},
"UsageDashboardResponse": {
"properties": {
"period": {
"type": "string",
"title": "Period",
"description": "'today' | 'month' | 'all'"
},
"from_date": {
"type": "string",
"title": "From Date",
"description": "ISO date string"
},
"to_date": {
"type": "string",
"title": "To Date",
"description": "ISO date string"
},
"total_calls": {
"type": "integer",
"title": "Total Calls"
},
"total_prompt_tokens": {
"type": "integer",
"title": "Total Prompt Tokens",
"default": 0
},
"total_completion_tokens": {
"type": "integer",
"title": "Total Completion Tokens",
"default": 0
},
"total_tokens": {
"type": "integer",
"title": "Total Tokens"
},
"by_call_type": {
"items": {
"$ref": "#/components/schemas/CallTypeBreakdown"
},
"type": "array",
"title": "By Call Type"
},
"by_model": {
"items": {
"$ref": "#/components/schemas/ModelBreakdown"
},
"type": "array",
"title": "By Model"
},
"recent_calls": {
"items": {
"$ref": "#/components/schemas/UsageCallRecord"
},
"type": "array",
"title": "Recent Calls"
}
},
"type": "object",
"required": [
"period",
"from_date",
"to_date",
"total_calls",
"total_tokens",
"by_call_type",
"by_model",
"recent_calls"
],
"title": "UsageDashboardResponse"
},
"UsageCallRecord": {
"properties": {
"id": {
"type": "integer",
"title": "Id"
},
"called_at": {
"type": "string",
"title": "Called At",
"description": "ISO datetime string"
},
"call_type": {
"type": "string",
"title": "Call Type"
},
"model": {
"type": "string",
"title": "Model"
},
"stock_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stock Code"
},
"prompt_tokens": {
"type": "integer",
"title": "Prompt Tokens"
},
"completion_tokens": {
"type": "integer",
"title": "Completion Tokens"
},
"total_tokens": {
"type": "integer",
"title": "Total Tokens"
}
},
"type": "object",
"required": [
"id",
"called_at",
"call_type",
"model",
"prompt_tokens",
"completion_tokens",
"total_tokens"
],
"title": "UsageCallRecord"
},
"CallTypeBreakdown": {
"properties": {
"call_type": {
"type": "string",
"title": "Call Type",
"description": "'analysis' | 'agent' | 'market_review'"
},
"calls": {
"type": "integer",
"title": "Calls"
},
"prompt_tokens": {
"type": "integer",
"title": "Prompt Tokens",
"default": 0
},
"completion_tokens": {
"type": "integer",
"title": "Completion Tokens",
"default": 0
},
"total_tokens": {
"type": "integer",
"title": "Total Tokens"
}
},
"type": "object",
"required": [
"call_type",
"calls",
"total_tokens"
],
"title": "CallTypeBreakdown"
},
"ModelBreakdown": {
"properties": {
"model": {
"type": "string",
"title": "Model"
},
"calls": {
"type": "integer",
"title": "Calls"
},
"prompt_tokens": {
"type": "integer",
"title": "Prompt Tokens",
"default": 0
},
"completion_tokens": {
"type": "integer",
"title": "Completion Tokens",
"default": 0
},
"total_tokens": {
"type": "integer",
"title": "Total Tokens"
},
"max_total_tokens": {
"type": "integer",
"title": "Max Total Tokens",
"default": 0
}
},
"type": "object",
"required": [
"model",
"calls",
"total_tokens"
],
"title": "ModelBreakdown"
},
"UsageSummaryResponse": {
"properties": {
"period": {
"type": "string",
"title": "Period",
"description": "'today' | 'month' | 'all'"
},
"from_date": {
"type": "string",
"title": "From Date",
"description": "ISO date string"
},
"to_date": {
"type": "string",
"title": "To Date",
"description": "ISO date string"
},
"total_calls": {
"type": "integer",
"title": "Total Calls"
},
"total_prompt_tokens": {
"type": "integer",
"title": "Total Prompt Tokens",
"default": 0
},
"total_completion_tokens": {
"type": "integer",
"title": "Total Completion Tokens",
"default": 0
},
"total_tokens": {
"type": "integer",
"title": "Total Tokens"
},
"by_call_type": {
"items": {
"$ref": "#/components/schemas/CallTypeBreakdown"
},
"type": "array",
"title": "By Call Type"
},
"by_model": {
"items": {
"$ref": "#/components/schemas/ModelBreakdown"
},
"type": "array",
"title": "By Model"
}
},
"type": "object",
"required": [
"period",
"from_date",
"to_date",
"total_calls",
"total_tokens",
"by_call_type",
"by_model"
],
"title": "UsageSummaryResponse"
},
"DecisionSignalFeedbackItem": {
"properties": {
"signal_id": {
"type": "integer",
"title": "Signal Id"
},
"feedback_value": {
"anyOf": [
{
"type": "string",
"enum": [
"useful",
"not_useful"
]
},
{
"type": "null"
}
],
"title": "Feedback Value"
},
"reason_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason Code"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note"
},
"source": {
"anyOf": [
{
"type": "string",
"enum": [
"web",
"api"
]
},
{
"type": "null"
}
],
"title": "Source"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
}
},
"type": "object",
"required": [
"signal_id"
],
"title": "DecisionSignalFeedbackItem"
},
"DecisionSignalFeedbackRequest": {
"properties": {
"feedback_value": {
"type": "string",
"enum": [
"useful",
"not_useful"
],
"title": "Feedback Value"
},
"reason_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 64,
"title": "Reason Code"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 1000,
"title": "Note"
},
"source": {
"type": "string",
"enum": [
"web",
"api"
],
"title": "Source",
"default": "api"
}
},
"type": "object",
"required": [
"feedback_value"
],
"title": "DecisionSignalFeedbackRequest"
},
"DecisionSignalOutcomeItem": {
"properties": {
"id": {
"type": "integer",
"title": "Id"
},
"signal_id": {
"type": "integer",
"title": "Signal Id"
},
"horizon": {
"type": "string",
"title": "Horizon"
},
"engine_version": {
"type": "string",
"title": "Engine Version"
},
"eval_status": {
"type": "string",
"title": "Eval Status"
},
"outcome": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Outcome"
},
"direction_expected": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Direction Expected"
},
"direction_correct": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Direction Correct"
},
"unable_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unable Reason"
},
"anchor_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Anchor Date"
},
"eval_window_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Eval Window Days"
},
"start_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Start Price"
},
"end_close": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "End Close"
},
"max_high": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max High"
},
"min_low": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Low"
},
"stock_return_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Stock Return Pct"
},
"action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Action"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market"
},
"market_phase": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market Phase"
},
"source_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Type"
},
"source_agent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Agent"
},
"plan_quality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Plan Quality"
},
"data_quality_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Data Quality Level"
},
"holding_state": {
"type": "string",
"title": "Holding State"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created At"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
}
},
"type": "object",
"required": [
"id",
"signal_id",
"horizon",
"engine_version",
"eval_status",
"holding_state"
],
"title": "DecisionSignalOutcomeItem"
},
"DecisionSignalOutcomeListResponse": {
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/DecisionSignalOutcomeItem"
},
"type": "array",
"title": "Items"
},
"total": {
"type": "integer",
"title": "Total"
},
"page": {
"type": "integer",
"title": "Page"
},
"page_size": {
"type": "integer",
"title": "Page Size"
}
},
"type": "object",
"required": [
"total",
"page",
"page_size"
],
"title": "DecisionSignalOutcomeListResponse"
},
"DecisionSignalOutcomeRunRequest": {
"properties": {
"signal_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Signal Id"
},
"horizons": {
"anyOf": [
{
"items": {
"type": "string",
"enum": [
"intraday",
"1d",
"3d",
"5d",
"10d",
"swing",
"long"
]
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Horizons"
},
"force": {
"type": "boolean",
"title": "Force",
"default": false
},
"market": {
"anyOf": [
{
"type": "string",
"enum": [
"cn",
"hk",
"us",
"jp",
"kr",
"tw"
]
},
{
"type": "null"
}
],
"title": "Market"
},
"stock_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"maxLength": 32,
"title": "Stock Code"
},
"action": {
"anyOf": [
{
"type": "string",
"enum": [
"buy",
"add",
"hold",
"reduce",
"sell",
"watch",
"avoid",
"alert"
]
},
{
"type": "null"
}
],
"title": "Action"
},
"source_type": {
"anyOf": [
{
"type": "string",
"enum": [
"analysis",
"agent",
"alert",
"market_review",
"manual"
]
},
{
"type": "null"
}
],
"title": "Source Type"
},
"status": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"expired",
"invalidated",
"closed",
"archived"
]
},
{
"type": "null"
}
],
"title": "Status"
},
"limit": {
"type": "integer",
"maximum": 500.0,
"minimum": 1.0,
"title": "Limit",
"default": 100
}
},
"type": "object",
"title": "DecisionSignalOutcomeRunRequest"
},
"DecisionSignalOutcomeRunResponse": {
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/DecisionSignalOutcomeItem"
},
"type": "array",
"title": "Items"
},
"evaluated": {
"type": "integer",
"title": "Evaluated"
},
"created": {
"type": "integer",
"title": "Created"
},
"updated": {
"type": "integer",
"title": "Updated"
},
"skipped": {
"type": "integer",
"title": "Skipped"
},
"engine_version": {
"type": "string",
"title": "Engine Version"
}
},
"type": "object",
"required": [
"evaluated",
"created",
"updated",
"skipped",
"engine_version"
],
"title": "DecisionSignalOutcomeRunResponse"
},
"DecisionSignalOutcomeStatsBucket": {
"properties": {
"dimension": {
"type": "string",
"title": "Dimension"
},
"value": {
"type": "string",
"title": "Value"
},
"total": {
"type": "integer",
"title": "Total"
},
"completed": {
"type": "integer",
"title": "Completed"
},
"unable": {
"type": "integer",
"title": "Unable"
},
"hit": {
"type": "integer",
"title": "Hit"
},
"miss": {
"type": "integer",
"title": "Miss"
},
"neutral": {
"type": "integer",
"title": "Neutral"
},
"hit_rate_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Hit Rate Pct"
},
"avg_stock_return_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Avg Stock Return Pct"
},
"unable_reasons": {
"additionalProperties": {
"type": "integer"
},
"type": "object",
"title": "Unable Reasons"
}
},
"type": "object",
"required": [
"dimension",
"value",
"total",
"completed",
"unable",
"hit",
"miss",
"neutral"
],
"title": "DecisionSignalOutcomeStatsBucket"
},
"DecisionSignalOutcomeStatsResponse": {
"properties": {
"engine_version": {
"type": "string",
"title": "Engine Version"
},
"horizons": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Horizons"
},
"statuses": {
"items": {
"type": "string"
},
"type": "array",
"title": "Statuses"
},
"total": {
"type": "integer",
"title": "Total"
},
"completed": {
"type": "integer",
"title": "Completed"
},
"unable": {
"type": "integer",
"title": "Unable"
},
"hit": {
"type": "integer",
"title": "Hit"
},
"miss": {
"type": "integer",
"title": "Miss"
},
"neutral": {
"type": "integer",
"title": "Neutral"
},
"hit_rate_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Hit Rate Pct"
},
"avg_stock_return_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Avg Stock Return Pct"
},
"unable_reasons": {
"additionalProperties": {
"type": "integer"
},
"type": "object",
"title": "Unable Reasons"
},
"breakdowns": {
"additionalProperties": {
"items": {
"$ref": "#/components/schemas/DecisionSignalOutcomeStatsBucket"
},
"type": "array"
},
"type": "object",
"title": "Breakdowns"
},
"profile_calibration": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibration"
}
},
"type": "object",
"required": [
"engine_version",
"total",
"completed",
"unable",
"hit",
"miss",
"neutral",
"profile_calibration"
],
"title": "DecisionSignalOutcomeStatsResponse"
},
"DecisionSignalProfileCalibration": {
"properties": {
"minimum_completed_sample_size": {
"type": "integer",
"minimum": 1.0,
"title": "Minimum Completed Sample Size"
},
"breakdowns": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBreakdowns"
}
},
"type": "object",
"required": [
"minimum_completed_sample_size",
"breakdowns"
],
"title": "DecisionSignalProfileCalibration"
},
"DecisionSignalProfileCalibrationBreakdowns": {
"properties": {
"decision_profile": {
"items": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBucket"
},
"type": "array",
"title": "Decision Profile"
},
"decision_profile_action": {
"items": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBucket"
},
"type": "array",
"title": "Decision Profile Action"
},
"decision_profile_horizon": {
"items": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBucket"
},
"type": "array",
"title": "Decision Profile Horizon"
},
"decision_profile_market_phase": {
"items": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBucket"
},
"type": "array",
"title": "Decision Profile Market Phase"
},
"decision_profile_data_quality_level": {
"items": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBucket"
},
"type": "array",
"title": "Decision Profile Data Quality Level"
},
"profile_source": {
"items": {
"$ref": "#/components/schemas/DecisionSignalProfileCalibrationBucket"
},
"type": "array",
"title": "Profile Source"
}
},
"type": "object",
"title": "DecisionSignalProfileCalibrationBreakdowns"
},
"DecisionSignalProfileCalibrationBucket": {
"properties": {
"dimensions": {
"additionalProperties": {
"type": "string"
},
"type": "object",
"title": "Dimensions"
},
"total": {
"type": "integer",
"title": "Total"
},
"completed": {
"type": "integer",
"title": "Completed"
},
"unable": {
"type": "integer",
"title": "Unable"
},
"hit": {
"type": "integer",
"title": "Hit"
},
"miss": {
"type": "integer",
"title": "Miss"
},
"neutral": {
"type": "integer",
"title": "Neutral"
},
"sample_sufficient": {
"type": "boolean",
"title": "Sample Sufficient"
},
"hit_rate_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Hit Rate Pct"
},
"avg_stock_return_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Avg Stock Return Pct"
},
"miss_rate_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Miss Rate Pct"
},
"unable_rate_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Unable Rate Pct"
},
"max_adverse_excursion_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Adverse Excursion Pct"
}
},
"type": "object",
"required": [
"total",
"completed",
"unable",
"hit",
"miss",
"neutral",
"sample_sufficient"
],
"title": "DecisionSignalProfileCalibrationBucket"
},
"AlertTriggerItem": {
"properties": {
"id": {
"type": "integer",
"title": "Id"
},
"rule_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Rule Id"
},
"target": {
"type": "string",
"title": "Target"
},
"observed_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Observed Value"
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason"
},
"data_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Data Source"
},
"data_timestamp": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Data Timestamp"
},
"triggered_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Triggered At"
},
"status": {
"type": "string",
"title": "Status"
},
"diagnostics": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Diagnostics"
},
"market_phase_summary": {
"anyOf": [
{
"$ref": "#/components/schemas/MarketPhaseSummary"
},
{
"type": "null"
}
]
},
"analysis_context_pack_overview": {
"anyOf": [
{
"$ref": "#/components/schemas/AnalysisContextPackOverview"
},
{
"type": "null"
}
]
},
"analysis_visibility_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Analysis Visibility Source",
"description": "公开摘要来源：alert_trigger_market_context / analysis_history_snapshot / evaluator_snapshot / legacy_text / null"
},
"decision_signal_summary": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Decision Signal Summary"
}
},
"type": "object",
"required": [
"id",
"target",
"status"
],
"title": "AlertTriggerItem"
},
"AlertTriggerListResponse": {
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/AlertTriggerItem"
},
"type": "array",
"title": "Items"
},
"total": {
"type": "integer",
"title": "Total"
},
"page": {
"type": "integer",
"title": "Page"
},
"page_size": {
"type": "integer",
"title": "Page Size"
}
},
"type": "object",
"required": [
"total",
"page",
"page_size"
],
"title": "AlertTriggerListResponse"
},
"PortfolioDecisionSignalRiskBlock": {
"properties": {
"available": {
"type": "boolean",
"title": "Available",
"default": true
},
"total": {
"type": "integer",
"title": "Total",
"default": 0
},
"actions": {
"additionalProperties": {
"type": "integer"
},
"type": "object",
"title": "Actions"
},
"items": {
"items": {
"$ref": "#/components/schemas/PortfolioDecisionSignalRiskItem"
},
"type": "array",
"title": "Items"
}
},
"type": "object",
"title": "PortfolioDecisionSignalRiskBlock"
},
"PortfolioDecisionSignalRiskItem": {
"properties": {
"account_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Account Id"
},
"symbol": {
"type": "string",
"title": "Symbol"
},
"market": {
"type": "string",
"title": "Market"
},
"signal": {
"additionalProperties": true,
"type": "object",
"title": "Signal"
}
},
"type": "object",
"required": [
"symbol",
"market"
],
"title": "PortfolioDecisionSignalRiskItem"
},
"PortfolioRiskResponse": {
"properties": {
"as_of": {
"type": "string",
"title": "As Of"
},
"account_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Account Id"
},
"cost_method": {
"type": "string",
"title": "Cost Method"
},
"currency": {
"type": "string",
"title": "Currency"
},
"thresholds": {
"additionalProperties": true,
"type": "object",
"title": "Thresholds"
},
"concentration": {
"additionalProperties": true,
"type": "object",
"title": "Concentration"
},
"sector_concentration": {
"additionalProperties": true,
"type": "object",
"title": "Sector Concentration"
},
"drawdown": {
"additionalProperties": true,
"type": "object",
"title": "Drawdown"
},
"stop_loss": {
"additionalProperties": true,
"type": "object",
"title": "Stop Loss"
},
"decision_signal_risk": {
"$ref": "#/components/schemas/PortfolioDecisionSignalRiskBlock"
}
},
"type": "object",
"required": [
"as_of",
"cost_method",
"currency"
],
"title": "PortfolioRiskResponse"
},
"MarketPhaseSummary": {
"properties": {
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"description": "市场区域"
},
"phase": {
"type": "string",
"enum": [
"premarket",
"intraday",
"lunch_break",
"closing_auction",
"postmarket",
"non_trading",
"unknown"
],
"title": "Phase",
"description": "市场阶段"
},
"market_local_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market Local Time",
"description": "市场本地时间"
},
"session_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Session Date",
"description": "市场本地日期"
},
"effective_daily_bar_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Effective Daily Bar Date",
"description": "最新可复用完整日线日期"
},
"is_trading_day": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Trading Day",
"description": "是否交易日"
},
"is_market_open_now": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Market Open Now",
"description": "当前是否开市"
},
"is_partial_bar": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Partial Bar",
"description": "最新日线是否可能未完成"
},
"minutes_to_open": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Minutes To Open",
"description": "距离开盘分钟数"
},
"minutes_to_close": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Minutes To Close",
"description": "距离收盘分钟数"
},
"trigger_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trigger Source",
"description": "触发来源"
},
"analysis_intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Analysis Intent",
"description": "分析意图"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings",
"description": "阶段推断降级告警码"
}
},
"type": "object",
"required": [
"phase"
],
"title": "MarketPhaseSummary",
"description": "Low-sensitivity market phase metadata exposed on report meta."
},
"AnalysisContextPackOverview": {
"properties": {
"pack_version": {
"type": "string",
"title": "Pack Version",
"description": "AnalysisContextPack 版本"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Created At",
"description": "创建时间"
},
"subject": {
"$ref": "#/components/schemas/AnalysisContextPackOverviewSubject"
},
"blocks": {
"items": {
"$ref": "#/components/schemas/AnalysisContextPackOverviewBlock"
},
"type": "array",
"title": "Blocks"
},
"counts": {
"$ref": "#/components/schemas/AnalysisContextPackOverviewCounts"
},
"data_quality": {
"anyOf": [
{
"$ref": "#/components/schemas/AnalysisContextPackOverviewDataQuality"
},
{
"type": "null"
}
],
"description": "本次分析输入数据质量低敏摘要"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings",
"description": "顶层数据质量提醒"
},
"metadata": {
"$ref": "#/components/schemas/AnalysisContextPackOverviewMetadata"
}
},
"type": "object",
"required": [
"pack_version",
"subject",
"counts"
],
"title": "AnalysisContextPackOverview",
"description": "历史/API 可见的低敏 AnalysisContextPack 摘要"
},
"AnalysisContextPackOverviewSubject": {
"properties": {
"code": {
"type": "string",
"title": "Code",
"description": "股票代码"
},
"stock_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stock Name",
"description": "股票名称"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"description": "市场"
}
},
"type": "object",
"required": [
"code"
],
"title": "AnalysisContextPackOverviewSubject",
"description": "AnalysisContextPack 可见摘要标的信息"
},
"AnalysisContextPackOverviewBlock": {
"properties": {
"key": {
"type": "string",
"title": "Key",
"description": "数据块稳定 key"
},
"label": {
"type": "string",
"title": "Label",
"description": "数据块展示名称"
},
"status": {
"type": "string",
"enum": [
"available",
"missing",
"not_supported",
"fallback",
"stale",
"estimated",
"partial",
"fetch_failed"
],
"title": "Status",
"description": "数据块质量状态"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source",
"description": "数据来源"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings",
"description": "数据块告警码"
},
"missing_reasons": {
"items": {
"type": "string"
},
"type": "array",
"title": "Missing Reasons",
"description": "缺失原因"
}
},
"type": "object",
"required": [
"key",
"label",
"status"
],
"title": "AnalysisContextPackOverviewBlock",
"description": "AnalysisContextPack 可见摘要数据块"
},
"AnalysisContextPackOverviewCounts": {
"properties": {
"available": {
"type": "integer",
"title": "Available",
"default": 0
},
"missing": {
"type": "integer",
"title": "Missing",
"default": 0
},
"not_supported": {
"type": "integer",
"title": "Not Supported",
"default": 0
},
"fallback": {
"type": "integer",
"title": "Fallback",
"default": 0
},
"stale": {
"type": "integer",
"title": "Stale",
"default": 0
},
"estimated": {
"type": "integer",
"title": "Estimated",
"default": 0
},
"partial": {
"type": "integer",
"title": "Partial",
"default": 0
},
"fetch_failed": {
"type": "integer",
"title": "Fetch Failed",
"default": 0
}
},
"type": "object",
"title": "AnalysisContextPackOverviewCounts",
"description": "AnalysisContextPack 可见摘要状态计数"
},
"AnalysisContextPackOverviewDataQuality": {
"properties": {
"overall_score": {
"anyOf": [
{
"type": "integer",
"maximum": 100.0,
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Overall Score",
"description": "输入数据质量总分"
},
"level": {
"anyOf": [
{
"type": "string",
"enum": [
"good",
"usable",
"limited",
"poor"
]
},
{
"type": "null"
}
],
"title": "Level",
"description": "输入数据质量等级"
},
"block_scores": {
"additionalProperties": {
"type": "integer"
},
"type": "object",
"title": "Block Scores",
"description": "固定数据块质量分"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations",
"description": "低敏数据限制说明"
}
},
"type": "object",
"title": "AnalysisContextPackOverviewDataQuality",
"description": "AnalysisContextPack 可见摘要数据质量评分"
},
"AnalysisContextPackOverviewMetadata": {
"properties": {
"trigger_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trigger Source",
"description": "触发来源"
},
"news_result_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "News Result Count",
"description": "新闻结果数量"
}
},
"type": "object",
"title": "AnalysisContextPackOverviewMetadata",
"description": "AnalysisContextPack 可见摘要元数据"
},
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
},
"ValidationError": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"DecisionSignalReassessRequest": {
"properties": {
"source_report_id": {
"type": "integer",
"exclusiveMinimum": 0.0,
"title": "Source Report Id"
},
"decision_profile": {
"type": "string",
"enum": [
"conservative",
"balanced",
"aggressive"
],
"title": "Decision Profile"
},
"persist": {
"type": "boolean",
"title": "Persist",
"default": false
}
},
"additionalProperties": false,
"type": "object",
"required": [
"source_report_id",
"decision_profile"
],
"title": "DecisionSignalReassessRequest"
},
"DecisionSignalReassessResponse": {
"properties": {
"preview": {
"anyOf": [
{
"$ref": "#/components/schemas/DecisionSignalPreview"
},
{
"type": "null"
}
]
},
"item": {
"anyOf": [
{
"$ref": "#/components/schemas/DecisionSignalItem"
},
{
"type": "null"
}
]
},
"created": {
"type": "boolean",
"title": "Created",
"default": false
},
"persist_status": {
"anyOf": [
{
"type": "string",
"enum": [
"created",
"existing",
"refreshed"
]
},
{
"type": "null"
}
],
"title": "Persist Status"
},
"warnings": {
"items": {
"$ref": "#/components/schemas/DecisionSignalWarning"
},
"type": "array",
"title": "Warnings"
},
"blocked_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Blocked Reason"
}
},
"type": "object",
"title": "DecisionSignalReassessResponse"
},
"DecisionSignalReassessErrorResponse": {
"properties": {
"error": {
"type": "string",
"enum": [
"unsupported_report_type",
"unsupported_report_snapshot",
"guardrail_blocked"
],
"title": "Error"
},
"message": {
"type": "string",
"title": "Message"
},
"blocked_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Blocked Reason"
},
"warnings": {
"items": {
"$ref": "#/components/schemas/DecisionSignalWarning"
},
"type": "array",
"title": "Warnings"
}
},
"type": "object",
"required": [
"error",
"message"
],
"title": "DecisionSignalReassessErrorResponse"
},
"DecisionSignalWarning": {
"properties": {
"code": {
"type": "string",
"title": "Code"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message"
},
"params": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Params"
}
},
"type": "object",
"required": [
"code"
],
"title": "DecisionSignalWarning"
},
"DecisionSignalPreview": {
"properties": {
"action": {
"type": "string",
"title": "Action"
},
"score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Score"
},
"confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Confidence"
},
"horizon": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Horizon"
},
"entry_low": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry Low"
},
"entry_high": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry High"
},
"stop_loss": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Stop Loss"
},
"target_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Target Price"
},
"invalidation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Invalidation"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason"
},
"risk_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Risk Summary"
},
"watch_conditions": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Watch Conditions"
},
"metadata": {
"additionalProperties": true,
"type": "object",
"title": "Metadata"
}
},
"type": "object",
"required": [
"action",
"metadata"
],
"title": "DecisionSignalPreview"
},
"DataCapabilityOverviewResponse": {
"properties": {
"as_of": {
"type": "string",
"title": "As Of"
},
"providers": {
"items": {
"$ref": "#/components/schemas/DataProviderCapability"
},
"type": "array",
"title": "Providers"
},
"datasets": {
"items": {
"$ref": "#/components/schemas/DataDatasetQuality"
},
"type": "array",
"title": "Datasets"
},
"priorities": {
"items": {
"$ref": "#/components/schemas/DataPriorityView"
},
"type": "array",
"title": "Priorities"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings"
}
},
"type": "object",
"required": [
"as_of"
],
"title": "DataCapabilityOverviewResponse",
"description": "Read-only data capability and dataset quality overview."
},
"DataDatasetQuality": {
"properties": {
"dataset": {
"type": "string",
"title": "Dataset",
"description": "Stable dataset identifier"
},
"status": {
"type": "string",
"enum": [
"ok",
"degraded",
"partial",
"unconfigured",
"unavailable",
"unknown",
"stale"
],
"title": "Status",
"description": "Current quality status"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source",
"description": "Selected source token when known"
},
"stale": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Stale",
"description": "Whether the data is known stale"
},
"last_success": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Success",
"description": "Last successful load timestamp"
},
"last_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Error",
"description": "Last non-sensitive error summary"
},
"fallback_from": {
"items": {
"type": "string"
},
"type": "array",
"title": "Fallback From",
"description": "Earlier priority sources skipped before selected source"
},
"coverage": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Coverage",
"description": "Optional dataset coverage summary"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings",
"description": "Stable warning codes"
}
},
"type": "object",
"required": [
"dataset",
"status"
],
"title": "DataDatasetQuality",
"description": "Dataset-level quality view consumed by dashboards and data center."
},
"DataPriorityView": {
"properties": {
"scenario": {
"type": "string",
"title": "Scenario",
"description": "Stable scenario identifier"
},
"providers": {
"items": {
"type": "string"
},
"type": "array",
"title": "Providers",
"description": "Configured provider/source tokens"
},
"source": {
"type": "string",
"title": "Source",
"description": "Where this priority list comes from",
"default": ""
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings",
"description": "Stable warning codes"
}
},
"type": "object",
"required": [
"scenario"
],
"title": "DataPriorityView",
"description": "Configured provider order for one usage scenario."
},
"DataProviderCapability": {
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Stable provider token"
},
"label": {
"type": "string",
"title": "Label",
"description": "Human-readable provider name",
"default": ""
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"description": "Whether the provider is enabled for runtime routing"
},
"configured": {
"type": "boolean",
"title": "Configured",
"description": "Whether required configuration is present"
},
"status": {
"type": "string",
"enum": [
"ok",
"partial",
"unconfigured",
"unavailable",
"unknown"
],
"title": "Status",
"description": "Configuration/runtime availability summary"
},
"priority": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Priority",
"description": "Runtime fetcher priority when available"
},
"markets": {
"items": {
"type": "string"
},
"type": "array",
"title": "Markets",
"description": "Supported markets"
},
"datasets": {
"items": {
"type": "string"
},
"type": "array",
"title": "Datasets",
"description": "Supported dataset identifiers"
},
"dataset_markets": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "object",
"title": "Dataset Markets",
"description": "Exact supported markets for each dataset; consumers must not infer a markets × datasets cross-product"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array",
"title": "Warnings",
"description": "Stable warning codes"
},
"last_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Error",
"description": "Last known non-sensitive error summary"
},
"cooldown": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Cooldown",
"description": "Whether the provider is currently in cooldown"
}
},
"type": "object",
"required": [
"name",
"enabled",
"configured",
"status"
],
"title": "DataProviderCapability",
"description": "Visible capability metadata for one data provider."
},
"StockProfileResearchBlock": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"data": {
"$ref": "#/components/schemas/StockProfileResearchData"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfileResearchBlock"
},
"StockProfileResearchData": {
"properties": {
"latest_report": {
"anyOf": [
{
"$ref": "#/components/schemas/HistoryItem"
},
{
"type": "null"
}
]
},
"recent_reports": {
"items": {
"$ref": "#/components/schemas/HistoryItem"
},
"type": "array",
"title": "Recent Reports"
},
"structured_report": {
"anyOf": [
{
"$ref": "#/components/schemas/ResearchArtifact"
},
{
"type": "null"
}
]
}
},
"type": "object",
"title": "StockProfileResearchData"
},
"StockProfileHistoryBlock": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"period": {
"type": "string",
"const": "daily",
"title": "Period",
"default": "daily"
},
"data": {
"items": {
"$ref": "#/components/schemas/KLineData"
},
"type": "array",
"title": "Data"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfileHistoryBlock"
},
"KLineData": {
"properties": {
"date": {
"type": "string",
"title": "Date",
"description": "日期"
},
"open": {
"type": "number",
"title": "Open",
"description": "开盘价"
},
"high": {
"type": "number",
"title": "High",
"description": "最高价"
},
"low": {
"type": "number",
"title": "Low",
"description": "最低价"
},
"close": {
"type": "number",
"title": "Close",
"description": "收盘价"
},
"volume": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Volume",
"description": "成交量"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Amount",
"description": "成交额"
},
"change_percent": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Change Percent",
"description": "涨跌幅 (%)"
}
},
"type": "object",
"required": [
"date",
"open",
"high",
"low",
"close"
],
"title": "KLineData",
"description": "K 线数据点",
"example": {
"amount": 18000000000,
"change_percent": 0.84,
"close": 1800.0,
"date": "2024-01-01",
"high": 1810.0,
"low": 1780.0,
"open": 1785.0,
"volume": 10000000
}
},
"ResearchResponse": {
"properties": {
"success": {
"type": "boolean",
"title": "Success"
},
"content": {
"type": "string",
"title": "Content"
},
"sources": {
"items": {
"type": "string"
},
"type": "array",
"title": "Sources"
},
"token_usage": {
"type": "integer",
"title": "Token Usage",
"default": 0
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error"
}
},
"type": "object",
"required": [
"success",
"content"
],
"title": "ResearchResponse"
},
"StockProfilePortfolioBlock": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"data": {
"$ref": "#/components/schemas/StockProfilePortfolioRelation"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfilePortfolioBlock"
},
"StockProfilePortfolioRelation": {
"properties": {
"held": {
"type": "boolean",
"title": "Held",
"default": false
},
"matched_markets": {
"items": {
"type": "string"
},
"type": "array",
"title": "Matched Markets"
}
},
"type": "object",
"title": "StockProfilePortfolioRelation"
},
"StockProfileEvidenceQuality": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"blocks": {
"additionalProperties": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
]
},
"type": "object",
"title": "Blocks"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfileEvidenceQuality"
},
"ResearchRequest": {
"properties": {
"question": {
"type": "string",
"title": "Question"
},
"stock_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Stock Code"
}
},
"type": "object",
"required": [
"question"
],
"title": "ResearchRequest"
},
"StockProfileMonitorBlock": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"data": {
"$ref": "#/components/schemas/StockProfileMonitorData"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfileMonitorBlock"
},
"StockProfileMonitorData": {
"properties": {
"total_rule_count": {
"type": "integer",
"title": "Total Rule Count",
"default": 0
},
"enabled_rule_count": {
"type": "integer",
"title": "Enabled Rule Count",
"default": 0
},
"rule_ids": {
"items": {
"type": "integer"
},
"type": "array",
"title": "Rule Ids"
}
},
"type": "object",
"title": "StockProfileMonitorData"
},
"StockProfileIntelligenceBlock": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"items": {
"items": {
"$ref": "#/components/schemas/IntelligenceItem"
},
"type": "array",
"title": "Items"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfileIntelligenceBlock"
},
"IntelligenceItem": {
"properties": {
"id": {
"type": "integer",
"title": "Id"
},
"source_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Source Id"
},
"source_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Name"
},
"source_type": {
"type": "string",
"title": "Source Type"
},
"title": {
"type": "string",
"title": "Title"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Summary"
},
"url": {
"type": "string",
"title": "Url"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source"
},
"published_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Published At"
},
"fetched_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Fetched At"
},
"scope_type": {
"type": "string",
"title": "Scope Type"
},
"scope_value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Scope Value"
},
"market": {
"type": "string",
"title": "Market"
}
},
"type": "object",
"required": [
"id",
"source_type",
"title",
"url",
"scope_type",
"market"
],
"title": "IntelligenceItem"
},
"StockProfileResponse": {
"properties": {
"requested_code": {
"type": "string",
"title": "Requested Code"
},
"canonical_code": {
"type": "string",
"title": "Canonical Code"
},
"market": {
"type": "string",
"enum": [
"cn",
"hk",
"us",
"jp",
"kr",
"tw"
],
"title": "Market"
},
"as_of": {
"type": "string",
"title": "As Of"
},
"quote": {
"$ref": "#/components/schemas/StockProfileQuoteBlock"
},
"history": {
"$ref": "#/components/schemas/StockProfileHistoryBlock"
},
"research": {
"$ref": "#/components/schemas/StockProfileResearchBlock"
},
"intelligence": {
"$ref": "#/components/schemas/StockProfileIntelligenceBlock"
},
"portfolio": {
"$ref": "#/components/schemas/StockProfilePortfolioBlock"
},
"monitors": {
"$ref": "#/components/schemas/StockProfileMonitorBlock"
},
"evidence_quality": {
"$ref": "#/components/schemas/StockProfileEvidenceQuality"
}
},
"type": "object",
"required": [
"requested_code",
"canonical_code",
"market",
"as_of",
"quote",
"history",
"research",
"intelligence",
"portfolio",
"monitors",
"evidence_quality"
],
"title": "StockProfileResponse"
},
"StockProfileQuoteBlock": {
"properties": {
"status": {
"type": "string",
"enum": [
"fresh",
"partial",
"unavailable"
],
"title": "Status"
},
"data": {
"anyOf": [
{
"$ref": "#/components/schemas/StockQuote"
},
{
"type": "null"
}
]
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"type": "object",
"required": [
"status"
],
"title": "StockProfileQuoteBlock"
}
},
"securitySchemes": {
"AdminSessionCookie": {
"type": "apiKey",
"in": "cookie",
"name": "dsa_session"
}
}
}
}
Reference in New Issue View Git Blame Copy Permalink