{
  "openapi": "3.1.0",
  "info": {
    "title": "智核API · 241 接口",
    "description": "<div style=\"text-align:center\">\n\n# 智核API\n\n**241 接口**\n\n直连官方，只需要 key 就可以获取数据，支持测试 key 使用。\n\n</div>",
    "version": "1.0.12"
  },
  "paths": {
    "/api/test_key": {
      "get": {
        "summary": "获取今日测试 Key（公开）",
        "description": "获取/生成今日测试 Key（网页测试用，每天 50 次，第二天 0 点自动重置）。\n\n返回示例：\n{\n  \"key\": \"kore_test_20260823_xxxxxxxx\",\n  \"key_prefix\": \"kore_test_...\",\n  \"usage\": {\"key_type\": \"test\", \"daily_used\": 3, \"daily_limit\": 50, ...},\n  \"expires\": \"每日 0 点重置\",\n  \"note\": \"网页测试用，每天 50 次\"\n}",
        "operationId": "api_test_key_api_test_key_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/kpl/today_stocks": {
      "get": {
        "summary": "查看当天出票股票（默认接口测试用的股票）",
        "description": "【状态】查看当天出票股票状态。\n\n🎯 测试什么用：看接口默认测试用什么股票 + 当前出票列表。\n📥 入参：无\n📤 返回：当日出票数据 + 动态默认值 + 文件路径\n\n💡 所有接口的默认参数（如 code=000931、plate_id=BK0001）都从这里动态获取。\n💡 9:25 集合竞价撮合后会自动更新，沿用开盘啦出票股票。\n💡 9:25 前会用昨日缓存兑底。\n\n使用示例：\n    curl http://43.156.43.9:39395/api/kpl/today_stocks",
        "operationId": "api_today_stocks_api_kpl_today_stocks_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/kpl/health": {
      "get": {
        "summary": "Health",
        "description": "服务存活检查（白名单 · 无需 Key）。\n\n2026-09-04 移除 kpl_proxy 字段（暴露上游 endpoints = 泄露技术栈）。",
        "operationId": "health_api_kpl_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Health",
        "description": "服务存活检查（白名单 · 无需 Key）。\n\n2026-09-04 移除 kpl_proxy 字段（暴露上游 endpoints = 泄露技术栈）。",
        "operationId": "health_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/kpl/morning_bidding": {
      "get": {
        "summary": "竞价池",
        "operationId": "morning_bidding_api_kpl_morning_bidding_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/zt_rate": {
      "get": {
        "summary": "涨停率筛选",
        "operationId": "zt_rate_api_kpl_zt_rate_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Date"
            }
          },
          {
            "name": "top_n",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10,
              "title": "Top N"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tomorrow_topic": {
      "get": {
        "summary": "明天炒什么",
        "operationId": "tomorrow_topic_api_kpl_tomorrow_topic_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "top_n",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 5,
              "title": "Top N"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/limit_bid_realtime": {
      "get": {
        "summary": "实时委买额（9:50 用）",
        "operationId": "limit_bid_realtime_api_kpl_limit_bid_realtime_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "codes",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "000001,000002",
              "title": "Codes"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/quadrant_lookup": {
      "get": {
        "summary": "四象限标签查询",
        "operationId": "quadrant_lookup_api_kpl_quadrant_lookup_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Date"
            }
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "000001",
              "title": "Code"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/kline_history": {
      "get": {
        "summary": "历史K线",
        "operationId": "kline_history_api_kpl_kline_history_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "000001",
              "title": "Code"
            }
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "day",
              "title": "Period"
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 60,
              "title": "Count"
            }
          },
          {
            "name": "adjust",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Adjust"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/quote": {
      "get": {
        "summary": "单股实时行情",
        "operationId": "quote_api_kpl_quote_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "000001",
              "title": "Code"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/account/key_info": {
      "get": {
        "tags": [
          "🔑 账户"
        ],
        "summary": "当前 API Key 信息",
        "description": "【账户】当前 API Key 的详细信息。\n\n🎯 测试什么用：调用任意接口前，先确认 Key 是否有效 + 看当前用量。\n📥 入参：无（从 Header 的 X-API-Key 自动获取）\n📤 返回：\n    - key_name: Key 名称（生成时填的）\n    - key_type: 类型（master / test / regular）\n    - rate_limit: 限流（100次/分 或 50次/天）\n    - usage: 当前用量统计\n💡 典型场景：API 调试、限流排查、确认鉴权。",
        "operationId": "key_info_api_kpl_account_key_info_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/overview": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "打板概览（聚合）",
        "description": "【打板】打板整体概览。\n\n🎯 测试什么用：一眼看完今天涨停板所有数据（涨跌停数、连板高度、封板率等）。\n📥 入参：无\n📤 返回：聚合数据\n💡 典型场景：开盘后第一眼看看今天打板环境如何。",
        "operationId": "overview_api_kpl_daban_overview_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/zdt_count": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "涨跌停数",
        "description": "【打板】涨跌停股数统计。\n\n🎯 测试什么用：看今天涨停多少家、跌停多少家。\n📥 入参：无\n📤 返回：涨停数、跌停数、炸板数等\n💡 典型场景：判断市场情绪（涨停 > 跌停 = 强势）。",
        "operationId": "zdt_count_api_kpl_daban_zdt_count_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/zhang_ting_tianti": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "涨停天梯（连板高度）",
        "description": "【打板】涨停天梯（连板高度）。\n\n🎯 测试什么用：看今天 1板/2板/3板/.../N板各有哪些股票。\n📥 入参：无\n📤 返回：连板梯队（如：5板: [股票A, 股票B]、4板: [...]、3板: [...]）\n💡 典型场景：找高度龙头、判断市场接力氛围。",
        "operationId": "zhang_ting_tianti_api_kpl_daban_zhang_ting_tianti_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/radar": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "雷达事件流",
        "description": "【打板】雷达事件流（增量推送）。\n\n🎯 测试什么用：实时接收涨停/跌停/异动事件（类似订阅）。\n📥 入参：type = 事件类型，last_id = 增量游标\n📤 返回：新增事件列表\n💡 典型场景：做盘中盯盘机器人，订阅事件流。",
        "operationId": "radar_api_kpl_daban_radar_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "事件类型筛选（如涨停/跌停/异动）",
              "title": "Type"
            },
            "description": "事件类型筛选（如涨停/跌停/异动）"
          },
          {
            "name": "last_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "增量游标（传上一次返回的 last_id）",
              "title": "Last Id"
            },
            "description": "增量游标（传上一次返回的 last_id）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/daily_limit_index": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "涨停盘面统计",
        "description": "【打板】涨停盘面综合统计。\n\n🎯 测试什么用：涨停相关的整体统计（封板率、炸板率、最高板数）。\n📥 入参：无\n📤 返回：综合统计指标\n💡 典型场景：分析涨停板质量（封板率高 = 强势）。",
        "operationId": "daily_limit_index_api_kpl_daban_daily_limit_index_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/module_versatile": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "打板聚合（一次性全量）",
        "description": "【打板】一次性返回打板所有数据。\n\n🎯 测试什么用：把打板所有接口的数据一次打包返回。\n📥 入参：无\n📤 返回：打板所有数据（聚合）\n💡 典型场景：分析全市场打板情况时省得调多个接口。\n⚠️ 数据量较大，调用频率不要太高。",
        "operationId": "module_versatile_api_kpl_daban_module_versatile_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/auction": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "竞价榜单（9:25 集合竞价）",
        "description": "【打板】集合竞价榜单（9:25 撮合结果）。\n\n🎯 测试什么用：9:25 集合竞价撮合完成后，看今天竞价最强的股票。\n📥 入参：index / count / type / order\n📤 返回：竞价榜单 [{code, name, price, change_pct, volume}, ...]\n💡 典型场景：开盘前判断今天竞价强度、找开盘啦候选股。\n⏰ 关键时间：9:25 之后才有数据。",
        "operationId": "auction_api_kpl_daban_auction_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "index",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "分页索引（从 0 开始）",
              "default": 0,
              "title": "Index"
            },
            "description": "分页索引（从 0 开始）"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条",
              "default": 50,
              "title": "Count"
            },
            "description": "返回多少条"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "类型筛选（0=全部 / 1=涨停 / 2=强势等）",
              "title": "Type"
            },
            "description": "类型筛选（0=全部 / 1=涨停 / 2=强势等）"
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "排序方式（1=按涨幅 / 2=按金额）",
              "default": 1,
              "title": "Order"
            },
            "description": "排序方式（1=按涨幅 / 2=按金额）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/wpqc": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "竞价榜单（旧路径兼容）",
        "description": "【打板】竞价榜单（兼容旧路径）。\n\n🎯 测试什么用：同 /auction 接口，保留是为了兼容老调用代码。\n📥 入参：同 /auction\n📤 返回：同 /auction\n💡 典型场景：老代码不想改就直接用这个。",
        "operationId": "wpqc_api_kpl_daban_wpqc_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "index",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0,
              "title": "Index"
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "title": "Count"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Type"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "title": "Order"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/plate_info": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "市场涨跌停复盘",
        "description": "【打板】市场涨跌停复盘（板块归因）。\n\n🎯 测试什么用：看今天涨停主要集中在哪些板块。\n📥 入参：无\n📤 返回：板块涨停统计（如：人工智能涨停 8 家、新能源涨停 5 家）\n💡 典型场景：判断今天的主线题材是什么。",
        "operationId": "plate_info_api_kpl_daban_plate_info_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/pmsl": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "盘面亮点",
        "description": "【打板】盘面亮点（赚钱效应最强的方向）。\n\n🎯 测试什么用：看今天哪些方向最强（赚钱效应分析）。\n📥 入参：无\n📤 返回：亮点板块/个股列表\n💡 典型场景：找主线、判断赚钱效应。",
        "operationId": "pmsl_api_kpl_daban_pmsl_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/kqxy": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "回撤摘要",
        "description": "【打板】强势股回撤摘要。\n\n🎯 测试什么用：看今天涨停股票的回撤情况（炸板后跌了多少）。\n📥 入参：无\n📤 返回：回撤摘要数据\n💡 典型场景：判断打板风险（炸板率）。",
        "operationId": "kqxy_api_kpl_daban_kqxy_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/ydtp_today": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "今日异动停牌/重点监控",
        "description": "【打板】今日异动停牌 + 重点监控股。\n\n🎯 测试什么用：看今天被监管盯上的股票（异动停牌、重点监控）。\n📥 入参：无\n📤 返回：异动股列表\n💡 典型场景：风险警示、避开监管风险。",
        "operationId": "ydtp_today_api_kpl_daban_ydtp_today_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/ydtp_his": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "曾跌停（历史）",
        "description": "【打板】最近跌停的股票（历史）。\n\n🎯 测试什么用：看最近几天有哪些股票跌停了。\n📥 入参：无\n📤 返回：跌停股历史列表\n💡 典型场景：复盘弱势股、判断风险。",
        "operationId": "ydtp_his_api_kpl_daban_ydtp_his_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/daban/fengk_list": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "封盘数据列表",
        "description": "【打板】封盘数据列表（封单金额）。\n\n🎯 测试什么用：看今天封板股票的封单金额（封单大 = 强势）。\n📥 入参：index = 分页\n📤 返回：封盘列表 [{code, name, fengk_amount}, ...]\n💡 典型场景：判断封板强度、找次日开盘可能继续涨停的票。",
        "operationId": "fengk_list_api_kpl_daban_fengk_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "index",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "分页索引",
              "default": 0,
              "title": "Index"
            },
            "description": "分页索引"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/sharp_withdrawal": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "大幅回撤股票",
        "description": "【打板】大幅回撤股票（涨停后大幅下跌）。\n\n🎯 测试什么用：看今天涨停后大幅回落的股票（炸板/开板）。\n📥 入参：code（可选，单只查询）\n📤 返回：大幅回撤列表\n💡 典型场景：风险提示、避开追高被套。",
        "operationId": "sharp_withdrawal_api_kpl_daban_sharp_withdrawal_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "股票代码（可选）",
              "title": "Code"
            },
            "description": "股票代码（可选）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/weight_performance": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "权重股表现",
        "description": "【打板】权重股表现（大票表现）。\n\n🎯 测试什么用：看大盘股（指数权重股）的表现。\n📥 入参：code（可选，单只查询）\n📤 返回：权重股表现数据\n💡 典型场景：判断大盘走势、机构资金动向。",
        "operationId": "weight_performance_api_kpl_daban_weight_performance_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "股票代码（可选）",
              "title": "Code"
            },
            "description": "股票代码（可选）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/zt_reason": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "最近涨停原因",
        "description": "【打板】某只股票最近的涨停原因。\n\n🎯 测试什么用：看某只股票历史上每次涨停是因为什么。\n📥 入参：code = 股票代码，limit = 返回条数\n📤 返回：涨停原因列表 [{date, reason, change_pct}, ...]\n💡 典型场景：判断股票的\"涨停基因\"（题材驱动 / 资金驱动）。",
        "operationId": "zt_reason_api_kpl_daban_zt_reason_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条原因",
              "default": 10,
              "title": "Limit"
            },
            "description": "返回多少条原因"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/daban/index_list": {
      "get": {
        "tags": [
          "🔥 打板"
        ],
        "summary": "风向标资讯",
        "description": "【打板】风向标资讯（盘面风向标）。\n\n🎯 测试什么用：看今天的盘面风向标（重要资讯 + 异动提示）。\n📥 入参：无\n📤 返回：风向标资讯列表\n💡 典型场景：盘中复盘、找主线方向。",
        "operationId": "index_list_api_kpl_daban_index_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/longhubang/business_chart": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "营业部买卖曲线",
        "description": "【龙虎榜】某营业部在某只股票上的买卖曲线。\n\n🎯 测试什么用：看营业部在特定股票上的操作轨迹。\n📥 入参：stock_id = 股票代码，business_id = 营业部 ID（先调 business_list 拿到）\n📤 返回：买卖曲线数据\n💡 典型场景：跟踪知名游资在某只强势股上的操作节奏。",
        "operationId": "business_chart_api_kpl_longhubang_business_chart_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "stock_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "title": "Stock Id"
            },
            "description": "股票代码（如 000931）"
          },
          {
            "name": "business_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "营业部 ID（先调 business_list 拿到）",
              "title": "Business Id"
            },
            "description": "营业部 ID（先调 business_list 拿到）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/longhubang/business_detail": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "营业部明细",
        "description": "【龙虎榜】某营业部在某天的具体买卖明细。\n\n🎯 测试什么用：看某营业部在某天买卖了哪些股票、成交价格、数量。\n📥 入参：business_id = 营业部 ID，day = 日期（可选）\n📤 返回：买卖明细列表\n💡 典型场景：跟踪游资具体操作、复盘游资席位。",
        "operationId": "business_detail_api_kpl_longhubang_business_detail_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "business_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "营业部 ID（先调 business_list 拿到）",
              "title": "Business Id"
            },
            "description": "营业部 ID（先调 business_list 拿到）"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD（不传=最近）",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD（不传=最近）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/longhubang/business_info": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "营业部信息",
        "description": "【龙虎榜】某营业部的基本信息。\n\n🎯 测试什么用：看营业部的归属（哪个券商、哪个城市、上榜次数）。\n📥 入参：business_id = 营业部 ID\n📤 返回：营业部基本信息\n💡 典型场景：识别知名游资席位、判断活跃度。",
        "operationId": "business_info_api_kpl_longhubang_business_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "business_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "营业部 ID（先调 business_list 拿到）",
              "title": "Business Id"
            },
            "description": "营业部 ID（先调 business_list 拿到）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/longhubang/business_list": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "营业部列表",
        "description": "【龙虎榜】某天上榜的所有营业部列表。\n\n🎯 测试什么用：看某天上龙虎榜的营业部汇总（含买卖净额、上榜次数等）。\n📥 入参：day = 日期，type = 板块，index = 分页偏移\n📤 返回：营业部列表\n💡 典型场景：找活跃营业部、识别游资。",
        "operationId": "business_list_api_kpl_longhubang_business_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "上榜类型：全部/沪市/深市/创业板/科创板",
              "default": "全部",
              "title": "Type"
            },
            "description": "上榜类型：全部/沪市/深市/创业板/科创板"
          },
          {
            "name": "index",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "分页偏移量（从0开始）",
              "default": 0,
              "title": "Index"
            },
            "description": "分页偏移量（从0开始）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/longhubang/get_stock_list": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "龙虎榜个股列表（某天上榜）",
        "description": "【龙虎榜】某天上榜的所有股票。\n\n🎯 测试什么用：看某天上龙虎榜的所有股票（含涨跌幅、买入净额、换手率）。\n📥 入参：day = 日期，type = 板块，index = 分页偏移\n📤 返回：上榜股票列表\n💡 典型场景：每日复盘、找异动股。",
        "operationId": "get_stock_list_api_kpl_longhubang_get_stock_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD（不传=最近）",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD（不传=最近）"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "上榜类型：全部/沪市/深市/创业板/科创板",
              "default": "全部",
              "title": "Type"
            },
            "description": "上榜类型：全部/沪市/深市/创业板/科创板"
          },
          {
            "name": "index",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "description": "分页偏移量（从0开始）",
              "default": 0,
              "title": "Index"
            },
            "description": "分页偏移量（从0开始）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/longhubang/lhb_update": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "龙虎榜更新（最新动态）",
        "description": "【龙虎榜】龙虎榜最新更新汇总。\n\n🎯 测试什么用：看龙虎榜最新上榜的股票列表（每天 17:00 左右公布）。\n📥 入参：无\n📤 返回：最新上榜的股票代码列表\n💡 典型场景：盘后第一时间看异动股。",
        "operationId": "lhb_update_api_kpl_longhubang_lhb_update_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/longhubang/ticai_stock_option": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "题材个股选项",
        "description": "【龙虎榜】龙虎榜支持的题材筛选选项。\n\n🎯 测试什么用：看龙虎榜数据按题材筛选时的可选题材列表。\n📥 入参：无\n📤 返回：题材选项配置\n💡 典型场景：构建题材筛选 UI。",
        "operationId": "ticai_stock_option_api_kpl_longhubang_ticai_stock_option_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/longhubang/top_title": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "龙虎榜头条",
        "description": "【龙虎榜】龙虎榜头条摘要。\n\n🎯 测试什么用：龙虎榜重要信息摘要（一句话总结今天龙虎榜动态）。\n📥 入参：无\n📤 返回：头条摘要文本\n💡 典型场景：盘后快速浏览龙虎榜重点。",
        "operationId": "top_title_api_kpl_longhubang_top_title_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/longhubang/youzi_list": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "游资列表",
        "description": "【龙虎榜】知名游资动向列表。\n\n🎯 测试什么用：看知名游资（欢乐海、赵老哥、章盟主、炒股养家等）席位动向。\n📥 入参：无\n📤 返回：游资动向列表\n💡 典型场景：跟踪游资主攻方向、判断题材持续性。",
        "operationId": "youzi_list_api_kpl_longhubang_youzi_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/longhubang/agency_kline": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "营业部净买入日线",
        "description": "【龙虎榜】某营业部净买入的日 K 线。\n\n🎯 测试什么用：看某营业部的净买入变化趋势。\n📥 入参：business_id = 营业部 ID\n📤 返回：净买入日线数据\n💡 典型场景：评估营业部近期活跃度与盈利能力。",
        "operationId": "agency_kline_api_kpl_longhubang_agency_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "business_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "营业部 ID（先调 business_list 拿到）",
              "title": "Business Id"
            },
            "description": "营业部 ID（先调 business_list 拿到）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/longhubang/northbound_connect_stock_funding": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "北向资金个股",
        "description": "【龙虎榜】北向资金个股流向。\n\n🎯 测试什么用：看北向资金（外资）净流入/流出的个股。\n📥 入参：无\n📤 返回：北向资金个股数据\n💡 典型场景：跟踪外资主攻方向、判断大盘走势。",
        "operationId": "northbound_funding_api_kpl_longhubang_northbound_connect_stock_funding_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/longhubang/southbound_connect_stock_funding": {
      "get": {
        "tags": [
          "🐉 龙虎榜"
        ],
        "summary": "南向资金个股",
        "description": "【龙虎榜】南向资金个股流向。\n\n🎯 测试什么用：看南向资金（内资外流）净流入/流出的个股。\n📥 入参：无\n📤 返回：南向资金个股数据\n💡 典型场景：跟踪港股通方向。",
        "operationId": "southbound_funding_api_kpl_longhubang_southbound_connect_stock_funding_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/search/search_combine": {
      "get": {
        "tags": [
          "🔍 搜索"
        ],
        "summary": "综合搜索（股票/板块/资讯）",
        "description": "【搜索】综合搜索（股票 + 板块 + 资讯）。\n\n🎯 测试什么用：输入关键词，快速找到相关股票、板块、资讯。\n📥 入参：keyword = 关键词\n📤 返回：搜索结果（混合股票/板块/资讯）\n💡 典型场景：搜索框自动补全、找某个概念的股票。",
        "operationId": "search_combine_api_kpl_search_search_combine_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "搜索关键词（如股票名/代码/板块名）",
              "default": "平安银行",
              "title": "Keyword"
            },
            "description": "搜索关键词（如股票名/代码/板块名）",
            "example": "比亚迪"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/search/search_hot": {
      "get": {
        "tags": [
          "🔍 搜索"
        ],
        "summary": "热门搜索词",
        "description": "【搜索】当前热门搜索词排行榜。\n\n🎯 测试什么用：看市场用户在搜什么（题材热度参考）。\n📥 入参：无\n📤 返回：热门搜索词列表 [{keyword, hot_score}, ...]\n💡 典型场景：找当前市场主线、判断题材热度。",
        "operationId": "search_hot_api_kpl_search_search_hot_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/search/search_today_top": {
      "get": {
        "tags": [
          "🔍 搜索"
        ],
        "summary": "今日搜索榜",
        "description": "【搜索】今日搜索榜 TOP 排行。\n\n🎯 测试什么用：今天大家在搜什么 TOP 榜单。\n📥 入参：无\n📤 返回：今日搜索榜\n💡 典型场景：捕捉当日热点方向。",
        "operationId": "search_today_top_api_kpl_search_search_today_top_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/search/search_tuyere": {
      "get": {
        "tags": [
          "🔍 搜索"
        ],
        "summary": "风口搜索（热点方向）",
        "description": "【搜索】风口搜索（当前热点方向）。\n\n🎯 测试什么用：搜关键词找当前风口方向（受资金追逐的概念）。\n📥 入参：keyword = 关键词\n📤 返回：风口相关股票/板块\n💡 典型场景：找风口题材、判断市场主线。",
        "operationId": "search_tuyere_api_kpl_search_search_tuyere_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "搜索关键词",
              "default": "平安银行",
              "title": "Keyword"
            },
            "description": "搜索关键词"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/search/search_zt_reason": {
      "get": {
        "tags": [
          "🔍 搜索"
        ],
        "summary": "涨停原因搜索",
        "description": "【搜索】按涨停原因搜索。\n\n🎯 测试什么用：搜某个概念，找出所有因为这个概念涨停的股票。\n📥 入参：keyword = 关键词（概念名）\n📤 返回：因为该原因涨停的股票列表\n💡 典型场景：找华为概念股、AI 概念股、新能源概念股等。",
        "operationId": "search_zt_reason_api_kpl_search_search_zt_reason_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "搜索关键词（如华为、新能源）",
              "title": "Keyword"
            },
            "description": "搜索关键词（如华为、新能源）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/global/global_index_chart": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球指数 K 线",
        "description": "【全球】全球指数 K 线图。\n\n🎯 测试什么用：看全球各大指数的 K 线走势（恒生、道琼斯、纳斯达克等）。\n📥 入参：code = 指数代码，period = 周期，count = K 线根数\n📤 返回：K 线数据\n💡 典型场景：分析海外市场走势、判断美股-A股传导。",
        "operationId": "global_index_chart_api_kpl_global_global_index_chart_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码（如 HSI=恒生、DJI=道琼斯、IXIC=纳斯达克）",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码（如 HSI=恒生、DJI=道琼斯、IXIC=纳斯达克）",
            "example": "HSI"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：day / week / month",
              "default": "day",
              "title": "Period"
            },
            "description": "周期：day / week / month"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少根 K 线",
              "default": 60,
              "title": "Count"
            },
            "description": "返回多少根 K 线"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/global/global_index_head": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球指数速览",
        "description": "【全球】全球指数速览。\n\n🎯 测试什么用：一眼看完全球主要指数的当前表现。\n📥 入参：无\n📤 返回：所有全球指数的实时行情\n💡 典型场景：盘中看海外市场环境、夜盘美股表现。",
        "operationId": "global_index_head_api_kpl_global_global_index_head_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/global/global_popular": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球热门股票",
        "description": "【全球】全球热门股票（港股热门）。\n\n🎯 测试什么用：看港股市场今天交易最活跃的股票。\n📥 入参：无\n📤 返回：港股热门股票列表\n💡 典型场景：找港股投资标的、跟随南向资金。",
        "operationId": "global_popular_api_kpl_global_global_popular_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/global/global_stock_bankuai": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球股票所属板块",
        "description": "【全球】某只全球股票所属板块。\n\n🎯 测试什么用：看某只港股/美股属于哪些板块。\n📥 入参：code = 股票代码\n📤 返回：所属板块列表\n💡 典型场景：找同类板块的其他股票。",
        "operationId": "global_stock_bankuai_api_kpl_global_global_stock_bankuai_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（港股 5 位 / 美股字母）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（港股 5 位 / 美股字母）",
            "example": "00700"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/global/global_stock_chart": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球股票 K 线",
        "description": "【全球】某只全球股票的 K 线。\n\n🎯 测试什么用：看港股/美股 K 线走势。\n📥 入参：code = 股票代码，period = 周期，count = 根数\n📤 返回：K 线数据\n💡 典型场景：技术分析、判断买卖点。",
        "operationId": "global_stock_chart_api_kpl_global_global_stock_chart_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "00700"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：day / week / month",
              "default": "day",
              "title": "Period"
            },
            "description": "周期：day / week / month"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少根",
              "default": 60,
              "title": "Count"
            },
            "description": "返回多少根"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/global/global_stock_head": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球股票实时行情",
        "description": "【全球】某只全球股票的实时行情。\n\n🎯 测试什么用：看某只港股/美股当前价格、涨跌、成交量。\n📥 入参：code = 股票代码\n📤 返回：实时行情数据\n💡 典型场景：实时盯盘、快速看盘。",
        "operationId": "global_stock_head_api_kpl_global_global_stock_head_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "00700"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/global/global_stock_intro": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "全球股票介绍",
        "description": "【全球】某只全球股票的公司介绍。\n\n🎯 测试什么用：了解某只港股/美股的公司基本面。\n📥 入参：code = 股票代码\n📤 返回：公司基本信息\n💡 典型场景：基本面分析、了解公司业务。",
        "operationId": "global_stock_intro_api_kpl_global_global_stock_intro_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "00700"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/global/peripheral_changes": {
      "get": {
        "tags": [
          "🌍 全球股"
        ],
        "summary": "外围市场变动（美股夜盘）",
        "description": "【全球】外围市场变动（重点是美股夜盘）。\n\n🎯 测试什么用：看美股夜盘表现（晚上 21:30 - 次日 4:00）。\n📥 入参：无\n📤 返回：美股主要指数 + 个股表现\n💡 典型场景：A 股开盘前参考美股表现、判断次日开盘方向。\n⏰ 关键时间：每晚 21:30（美股开盘）后更新。",
        "operationId": "peripheral_changes_api_kpl_global_peripheral_changes_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/fund/lof_arb": {
      "get": {
        "tags": [
          "💰 基金"
        ],
        "summary": "LOF 套利机会列表",
        "description": "【基金】LOF 套利机会列表。\n\n🎯 测试什么用：扫所有可套利的 LOF 基金（场内价 vs 场外净值差异）。\n📥 入参：code（可选，不传=全部）\n📤 返回：套利机会列表 [{code, name, market_price, nav, premium_pct}, ...]\n💡 典型场景：低风险套利、稳健收益策略。",
        "operationId": "lof_arb_api_kpl_fund_lof_arb_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "基金代码（可选，不传=拉所有套利机会）",
              "title": "Code"
            },
            "description": "基金代码（可选，不传=拉所有套利机会）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/fund/lof_metrics": {
      "get": {
        "tags": [
          "💰 基金"
        ],
        "summary": "LOF 基金详细指标",
        "description": "【基金】LOF 基金详细指标。\n\n🎯 测试什么用：看某只 LOF 基金的详细指标（场内价、净值、溢价率、成交量等）。\n📥 入参：code = 基金代码\n📤 返回：详细指标\n💡 典型场景：判断某只 LOF 是否有套利空间。",
        "operationId": "lof_metrics_api_kpl_fund_lof_metrics_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "基金代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "基金代码",
            "example": "163406"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/yijiner/health": {
      "get": {
        "tags": [
          "🎯 一进二"
        ],
        "summary": "健康检查",
        "description": "检查 yijiner 一进二涨停分析器模块是否就绪。",
        "operationId": "health_api_kpl_yijiner_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/kpl/yijiner/analyze": {
      "get": {
        "tags": [
          "🎯 一进二"
        ],
        "summary": "一进二涨停分析（综合昨日+今日竞价）",
        "description": "一进二涨停接力分析器。输入股票代码列表，返回每只股票的 15+ 维度数据：\n\n**A 组（上一交易日）**：换手率 / 成交量 / 成交额 / 每手均价 / 首次涨停时间 / 最后涨停时间 / 主力净买额\n\n**B 组（今日竞价）**：竞价涨幅 / 净买额 / 换手率 / 成交额 / 估算手数 / 9:20-9:24中段净买 / 9:24-9:25尾段净买 / 9:25撮合剩余买卖挂单\n\n**C 组（通用）**：封单金额 / 流通市值 / 封板资金占市值比\n\n数据源：官方竞价池 + 历史分时（收盘后）+ 9:25 撮合挂单",
        "operationId": "yijiner_analyze_api_kpl_yijiner_analyze_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "codes",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "股票代码列表，逗号分隔。例如：002084,002155,600540。支持 6 位代码。",
              "title": "Codes"
            },
            "description": "股票代码列表，逗号分隔。例如：002084,002155,600540。支持 6 位代码。",
            "example": "002084,002155"
          },
          {
            "name": "prev_day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "上一个交易日 YYYY-MM-DD。留空则自动算（周末回退到周五）。",
              "title": "Prev Day"
            },
            "description": "上一个交易日 YYYY-MM-DD。留空则自动算（周末回退到周五）。",
            "example": "2026-08-26"
          },
          {
            "name": "include_today",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "是否包含今日竞价数据。设为 false 可只看昨日数据。",
              "default": true,
              "title": "Include Today"
            },
            "description": "是否包含今日竞价数据。设为 false 可只看昨日数据。"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/yijiner/analyze_batch": {
      "get": {
        "tags": [
          "🎯 一进二"
        ],
        "summary": "批量分析昨日涨停池→今日样本",
        "description": "自动拉取今日涨停池 top N 只股票，调 /analyze 接口返回一进二分析结果。\n\n适用场景：一进二打板盯盘 — 9:30-9:35 跳据后调用，获取昨日涨停 → 今日竞价样本。\n\n推荐参数：top_n=10（控制响应大小）",
        "operationId": "yijiner_analyze_batch_api_kpl_yijiner_analyze_batch_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "top_n",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "今日涨停池取几只股票。推荐 10-20 只。",
              "default": 20,
              "title": "Top N"
            },
            "description": "今日涨停池取几只股票。推荐 10-20 只。",
            "example": 10
          },
          {
            "name": "prev_day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "上一个交易日 YYYY-MM-DD。留空自动算。",
              "title": "Prev Day"
            },
            "description": "上一个交易日 YYYY-MM-DD。留空自动算。",
            "example": "2026-08-26"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_info": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "股票基本信息",
        "description": "【基本信息】股票基本信息。\n\n🎯 测试什么用：看一只股票叫什么名字、什么行业、哪天上市的、当前股价多少。\n📥 入参：code = 6 位股票代码\n📤 返回：股票名称、行业、上市日期、当前价、流通市值等\n💡 典型场景：拿到股票代码后第一步调用，确认股票存在 + 获取基础信息。",
        "operationId": "stock_info_api_kpl_stock_stock_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（6 位数字，如 000931 / 600009）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（6 位数字，如 000931 / 600009）",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_company_info": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "公司简介",
        "description": "【基本信息】公司简介。\n\n🎯 测试什么用：看公司主营业务、注册资本、成立日期、办公地址。\n📥 入参：code = 股票代码\n📤 返回：公司名称、主营业务、注册资本、办公地址、联系方式\n💡 典型场景：分析公司基本面、了解公司是做什么的。",
        "operationId": "stock_company_info_api_kpl_stock_stock_company_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_concept": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "所属概念板块",
        "description": "【基本信息】所属概念板块（题材归类）。\n\n🎯 测试什么用：看一只股票属于哪些题材/概念（如人工智能、新能源车）。\n📥 入参：code = 股票代码\n📤 返回：所属板块列表（如：['人工智能', '机器人', '华为概念']）\n💡 典型场景：判断这只股票跟着哪个题材炒、寻找同板块其他股票。",
        "operationId": "stock_concept_api_kpl_stock_stock_concept_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_f10": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "F10 资料",
        "description": "【基本信息】F10 资料（公司全景数据）。\n\n🎯 测试什么用：看股票最完整的元数据（财务指标、股本结构、行业地位等）。\n📥 入参：code = 股票代码\n📤 返回：完整 F10 资料（公司全景数据）\n💡 典型场景：全面了解一家公司，比 stock_company_info 更详细。",
        "operationId": "stock_f10_api_kpl_stock_stock_f10_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_chart": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "日 K 线",
        "description": "【行情】日 K 线（蜡烛图数据）。\n\n🎯 测试什么用：看股票过去 N 天/周/月的开盘价、收盘价、最高价、最低价、成交量。\n📥 入参：code = 股票代码，period = 周期（day/week/month），count = 根数\n📤 返回：K 线数据列表 [{date, open, close, high, low, volume, amount}, ...]\n💡 典型场景：画 K 线图、技术分析、判断趋势。",
        "operationId": "stock_chart_api_kpl_stock_stock_chart_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：day=日K / week=周K / month=月K",
              "default": "day",
              "title": "Period"
            },
            "description": "周期：day=日K / week=周K / month=月K"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回 K 线数量（默认 60 根 = 约 3 个月）",
              "default": 60,
              "title": "Count"
            },
            "description": "返回 K 线数量（默认 60 根 = 约 3 个月）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_minute_trend": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "分时走势（1分钟线）",
        "description": "【行情】分时走势（当天 1 分钟级别）。\n\n🎯 测试什么用：看当天 9:30 到 15:00 每分钟的股价和成交量（240 个点）。\n📥 入参：code = 股票代码\n📤 返回：240 个 1 分钟点 [{time, price, volume, amount}, ...]\n💡 典型场景：分析当天分时走势、判断盘中资金流向、画分时图。\n⚠️ 注意：仅交易时段有数据（9:30-11:30 + 13:00-15:00）。",
        "operationId": "stock_minute_trend_api_kpl_stock_stock_minute_trend_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_zstrend": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "涨速趋势（实时涨速排行）",
        "description": "【行情】涨速趋势。\n\n🎯 测试什么用：看这只股票当前的\"涨速\"（每分钟涨多少 %）。\n📥 入参：code = 股票代码\n📤 返回：实时涨速数据\n💡 典型场景：捕捉急速拉升的股票、异动监控。",
        "operationId": "stock_zstrend_api_kpl_stock_stock_zstrend_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_zstrend_narrow": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "涨速趋势（窄幅）",
        "description": "【行情】涨速趋势窄幅版。\n\n🎯 测试什么用：看股票涨速，但只统计 ±2% 以内的窄幅波动（剔除极端情况）。\n📥 入参：code = 股票代码\n📤 返回：窄幅涨速数据\n💡 典型场景：分析平稳股票的细微波动。",
        "operationId": "stock_zstrend_narrow_api_kpl_stock_stock_zstrend_narrow_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_depth": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "盘口深度（5 档买卖）",
        "description": "【盘口】盘口深度（买卖 5 档挂单）。\n\n🎯 测试什么用：看当前股票买卖双方各 5 档挂单价格 + 数量。\n📥 入参：code = 股票代码\n📤 返回：买1~买5价 + 量、卖1~卖5价 + 量\n💡 典型场景：判断买卖力量对比、判断支撑位/压力位。",
        "operationId": "stock_depth_api_kpl_stock_stock_depth_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_dp_realdata": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "盘口实时数据",
        "description": "【盘口】盘口实时数据。\n\n🎯 测试什么用：看实时盘口的综合数据（5 档 + 最新价 + 涨跌 + 总量）。\n📥 入参：code = 股票代码\n📤 返回：实时盘口综合数据\n💡 典型场景：实时盯盘、快速看盘。",
        "operationId": "stock_dp_realdata_api_kpl_stock_stock_dp_realdata_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_turnover_ten": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "十档成交",
        "description": "【盘口】十档成交明细。\n\n🎯 测试什么用：看最近 10 笔成交记录（时间、价格、数量、方向）。\n📥 入参：code = 股票代码\n📤 返回：最近 10 笔成交\n💡 典型场景：判断大单在买还是卖、追踪主力动作。",
        "operationId": "stock_turnover_ten_api_kpl_stock_stock_turnover_ten_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/fund_flow": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "实时主力净流入（分钟分时）",
        "description": "【资金】实时主力净流入分钟分时。\n\n🎯 测试什么用：看今天这只股票主力资金净流入多少钱（主力=大单+特大单）。\n📥 入参：code = 股票代码\n📤 返回：主力资金流分时 + 累计净流入\n💡 典型场景：判断主力在买还是卖、监控大资金动作。\n⚠️ 数据源：公开行情接口（无需鉴权）。",
        "operationId": "fund_flow_api_kpl_stock_fund_flow_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/quadrant_judge": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "实时四象限判定（A主升/C出货）",
        "description": "【资金】实时四象限判定（基于主力净流入）。\n\n🎯 测试什么用：判断这只股票当前是\"主升\"、\"出货\"还是\"待定\"。\n📥 入参：code = 股票代码\n📤 返回：四象限标签 + 颜色 + 说明\n\n判定规则：\n    - A_主升 🟢：主力净流入 > +500 万\n    - A_弱 🟡 ：主力净流入 0 ~ +500 万\n    - C_弱 🟠 ：主力净流出 -500 ~ 0 万\n    - C_出货 🔴：主力净流出 < -500 万\n    - D_待定 ⚪：数据不足或异常\n\n💡 典型场景：开盘跟踪 Skill 核心接口，每只股票都要过这个判定。",
        "operationId": "quadrant_judge_api_kpl_stock_quadrant_judge_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_big_reminder": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "大单异动提醒",
        "description": "【大单】大单异动提醒。\n\n🎯 测试什么用：捕捉这只股票的\"大单\"动作（成交金额 > 100 万的单子）。\n📥 入参：code = 股票代码\n📤 返回：大单异动事件列表\n💡 典型场景：发现主力在悄悄建仓/出货。",
        "operationId": "stock_big_reminder_api_kpl_stock_stock_big_reminder_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_dadan_trend": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "大单趋势",
        "description": "【大单】大单趋势。\n\n🎯 测试什么用：看大单在分时图上的分布（什么时候有大单买入）。\n📥 入参：code = 股票代码\n📤 返回：大单分时数据\n💡 典型场景：复盘大单动作、判断主力建仓节奏。",
        "operationId": "stock_dadan_trend_api_kpl_stock_stock_dadan_trend_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_dadan_kline": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "大单 K 线",
        "description": "【大单】大单 K 线。\n\n🎯 测试什么用：看每天 K 线上是否有大单标记。\n📥 入参：code = 股票代码，day = 日期（可选）\n📤 返回：带大单标记的 K 线数据\n💡 典型场景：找有主力介入的 K 线日。",
        "operationId": "stock_dadan_kline_api_kpl_stock_stock_dadan_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD（不传=今天）",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD（不传=今天）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_kline_today_dadan": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "今日大单 K 线",
        "description": "【大单】今日大单 K 线。\n\n🎯 测试什么用：只看今天的 K 线 + 大单标记。\n📥 入参：code = 股票代码\n📤 返回：今天大单标记 K 线\n💡 典型场景：盘中实时跟踪大单动作。",
        "operationId": "stock_kline_today_dadan_api_kpl_stock_stock_kline_today_dadan_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_kline_zt": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "涨停 K 线",
        "description": "【大单】涨停 K 线。\n\n🎯 测试什么用：看历史涨停日的 K 线，标记涨停时间。\n📥 入参：code = 股票代码\n📤 返回：涨停 K 线数据\n💡 典型场景：复盘涨停板、判断连板高度。",
        "operationId": "stock_kline_zt_api_kpl_stock_stock_kline_zt_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_zt_gene": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "涨停基因（最近涨停原因）",
        "description": "【大单】涨停基因（最近涨停原因）。\n\n🎯 测试什么用：看这只股票历史涨停是因为什么题材/消息。\n📥 入参：code = 股票代码\n📤 返回：涨停原因列表\n💡 典型场景：判断这只股票的\"涨停属性\"（题材驱动还是资金驱动）。",
        "operationId": "stock_zt_gene_api_kpl_stock_stock_zt_gene_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/company_notice_count": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "公司公告数量",
        "description": "【消息】公司公告数量。\n\n🎯 测试什么用：快速看这只股票有多少条公告（不分页）。\n📥 入参：code = 股票代码\n📤 返回：公告总数\n💡 典型场景：判断公告发布密度（密集发布可能有利好）。",
        "operationId": "company_notice_count_api_kpl_stock_company_notice_count_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/company_notice_list": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "公司公告列表",
        "description": "【消息】公司公告列表。\n\n🎯 测试什么用：看这只股票最近的公告（分红、重组、人事变动等）。\n📥 入参：code = 股票代码，count = 返回条数\n📤 返回：公告列表 [{date, title, type, url}, ...]\n💡 典型场景：复盘公告影响、判断基本面变化。",
        "operationId": "company_notice_list_api_kpl_stock_company_notice_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条（默认 20 条）",
              "default": 20,
              "title": "Count"
            },
            "description": "返回多少条（默认 20 条）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/corporate_news": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "公司新闻",
        "description": "【消息】公司新闻（媒体报道）。\n\n🎯 测试什么用：看这家公司在媒体上的新闻报道（非官方公告）。\n📥 入参：code = 股票代码，count = 返回条数\n📤 返回：新闻列表\n💡 典型场景：舆情监控、判断市场关注度。",
        "operationId": "corporate_news_api_kpl_stock_corporate_news_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条",
              "default": 20,
              "title": "Count"
            },
            "description": "返回多少条"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/research_report_list": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "研究报告列表",
        "description": "【消息】研究报告列表（券商研报）。\n\n🎯 测试什么用：看券商对这只股票的研究报告（买入/卖出评级、目标价）。\n📥 入参：code = 股票代码，count = 返回条数\n📤 返回：研报列表 [{title, org, rating, date}, ...]\n💡 典型场景：参考机构观点、判断估值合理性。",
        "operationId": "research_report_list_api_kpl_stock_research_report_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条",
              "default": 10,
              "title": "Count"
            },
            "description": "返回多少条"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/interviews_by_date_zs": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "按日期查询调研",
        "description": "【调研】按日期查询机构调研记录。\n\n🎯 测试什么用：看机构在某个日期调研过这只股票。\n📥 入参：code = 股票代码，day = 日期（可选）\n📤 返回：调研记录列表\n💡 典型场景：跟踪机构调研动向，机构密集调研的股票可能有利好。",
        "operationId": "interviews_by_date_zs_api_kpl_stock_interviews_by_date_zs_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/research_field_list": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "调研行业列表",
        "description": "【调研】调研行业列表（产业链定位）。\n\n🎯 测试什么用：看这只股票属于哪个细分行业、上下游产业链。\n📥 入参：code = 股票代码\n📤 返回：行业列表\n💡 典型场景：分析公司行业地位、寻找产业链投资机会。",
        "operationId": "research_field_list_api_kpl_stock_research_field_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/research_field_excel": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "调研行业 Excel 数据",
        "description": "【调研】调研行业 Excel 数据。\n\n🎯 测试什么用：看这只股票所在行业的详细数据（市场规模、增速等）。\n📥 入参：code = 股票代码\n📤 返回：行业数据\n💡 典型场景：行业研究、判断赛道好坏。",
        "operationId": "research_field_excel_api_kpl_stock_research_field_excel_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/gudong_info": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "股东信息（前十大股东）",
        "description": "【股东】股东信息（前十大股东）。\n\n🎯 测试什么用：看这家公司的前十大股东（谁持股多少）。\n📥 入参：code = 股票代码\n📤 返回：股东列表 [{name, ratio, shares}, ...]\n💡 典型场景：判断筹码集中度、机构持仓变化。",
        "operationId": "gudong_info_api_kpl_stock_gudong_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/institutional_positions": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "机构持仓",
        "description": "【股东】机构持仓（基金/QFII/保险持仓）。\n\n🎯 测试什么用：看机构持仓这只股票的比例。\n📥 入参：code = 股票代码\n📤 返回：机构持仓数据\n💡 典型场景：跟随机构资金、判断专业投资人的态度。",
        "operationId": "institutional_positions_api_kpl_stock_institutional_positions_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/institutional_show_date": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "机构持仓披露日期",
        "description": "【股东】机构持仓披露日期。\n\n🎯 测试什么用：看这只股票机构持仓的披露日期（季报披露时间）。\n📥 入参：code = 股票代码\n📤 返回：披露日期列表\n💡 典型场景：跟踪机构持仓更新节奏。",
        "operationId": "institutional_show_date_api_kpl_stock_institutional_show_date_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_holding_fund": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "持仓基金",
        "description": "【股东】持仓这只股票的基金列表。\n\n🎯 测试什么用：看哪些基金重仓持有了这只股票。\n📥 入参：code = 股票代码\n📤 返回：基金列表 [{fund_name, shares, ratio}, ...]\n💡 典型场景：跟随主力基金、判断基金抱团情况。",
        "operationId": "stock_holding_fund_api_kpl_stock_stock_holding_fund_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/message_bar": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "个股留言板",
        "description": "【股东】个股留言板（投资者交流）。\n\n🎯 测试什么用：看散户在讨论区对这只股票的看法。\n📥 入参：code = 股票代码\n📤 返回：留言列表\n💡 典型场景：情绪面分析、判断市场预期。",
        "operationId": "message_bar_api_kpl_stock_message_bar_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/gudong_renshu": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "股东人数变化",
        "description": "【股东】股东人数变化（户均持股）。\n\n🎯 测试什么用：看股东人数是增加还是减少（减少=筹码集中）。\n📥 入参：code = 股票代码\n📤 返回：股东人数历史变化\n💡 典型场景：判断筹码集中度、捕捉主力建仓信号。",
        "operationId": "gudong_renshu_api_kpl_stock_gudong_renshu_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_weituo": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "委托单",
        "description": "【委托】委托单数据。\n\n🎯 测试什么用：看大单委托（挂单）情况。\n📥 入参：code = 股票代码\n📤 返回：委托单列表\n💡 典型场景：分析主力挂单意图。",
        "operationId": "stock_weituo_api_kpl_stock_stock_weituo_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_yyb_trend": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "营业部趋势",
        "description": "【营业部】营业部买卖曲线。\n\n🎯 测试什么用：看哪些营业部在买卖这只股票（跟踪游资）。\n📥 入参：code = 股票代码\n📤 返回：营业部买卖数据\n💡 典型场景：跟踪游资动向、判断游资接力情况。",
        "operationId": "stock_yyb_trend_api_kpl_stock_stock_yyb_trend_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_flash": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "盘口闪动",
        "description": "【盘口】盘口闪动数据。\n\n🎯 测试什么用：看盘口的快速变动（异动闪动）。\n📥 入参：code = 股票代码\n📤 返回：盘口闪动事件\n💡 典型场景：捕捉瞬时异动。",
        "operationId": "stock_flash_api_kpl_stock_stock_flash_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/northbound_funding": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "北向资金个股（沪深港通）",
        "description": "【北向】北向资金持股列表。\n\n🎯 测试什么用：看北向资金（外资）今天买卖了哪些股票。\n📥 入参：无（拉取全市场北向数据）\n📤 返回：北向资金个股列表 [{code, name, shares, ratio}, ...]\n💡 典型场景：跟随外资动向、北向资金大幅流入的股票 = 外资看好。\n⚠️ 数据源：开盘啦 longhubang 接口。",
        "operationId": "northbound_funding_api_kpl_stock_northbound_funding_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/stock/lhb_today": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "今日龙虎榜",
        "description": "【龙虎榜】今日上榜个股列表。\n\n🎯 测试什么用：看今天上了龙虎榜的股票（涨跌幅 ±7%/15% 触发）。\n📥 入参：无\n📤 返回：今日上榜股票代码列表\n💡 典型场景：复盘强势股、判断市场主线。\n⚠️ 数据源：开盘啦龙虎榜接口。",
        "operationId": "lhb_today_api_kpl_stock_lhb_today_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/stock/lhb_top_trader": {
      "get": {
        "tags": [
          "📊 个股详情"
        ],
        "summary": "龙虎榜活跃营业部",
        "description": "【龙虎榜】活跃营业部列表。\n\n🎯 测试什么用：看哪些营业部最近最活跃（知名游资席位）。\n📥 入参：无\n📤 返回：营业部列表（前 30 个）\n💡 典型场景：跟踪游资席位、判断游资主线。\n⚠️ 数据源：开盘啦营业部接口。",
        "operationId": "lhb_top_trader_api_kpl_stock_lhb_top_trader_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/plate/bk_fenshi_zhibo": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块分时直播",
        "description": "【板块】板块分时走势直播。\n\n🎯 测试什么用：看某板块今天的分时走势（每分钟涨跌幅）。\n📥 入参：code = 板块代码，period = 周期\n📤 返回：板块分时数据\n💡 典型场景：跟踪板块盘中异动。",
        "operationId": "bk_fenshi_zhibo_api_kpl_plate_bk_fenshi_zhibo_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "板块代码",
            "example": "BK0001"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：today=今天 / 5day=5天 / 20day=20天",
              "default": "today",
              "title": "Period"
            },
            "description": "周期：today=今天 / 5day=5天 / 20day=20天"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_get_point": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块要点速览",
        "description": "【板块】所有板块要点速览。\n\n🎯 测试什么用：一眼看完所有板块的核心要点。\n📥 入参：无\n📤 返回：板块要点列表\n💡 典型场景：找今天表现最强的板块。",
        "operationId": "bk_get_point_api_kpl_plate_bk_get_point_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/plate/bk_introduction": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块介绍",
        "description": "【板块】板块详细介绍。\n\n🎯 测试什么用：看某板块是什么、包含什么股票、相关资讯。\n📥 入参：plate_id = 板块 ID\n📤 返回：板块详细信息\n💡 典型场景：了解某个新概念板块。",
        "operationId": "bk_introduction_api_kpl_plate_bk_introduction_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID",
            "example": "BK0001"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_jiyao_by_stock": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "个股所属板块纪要",
        "description": "【板块】个股所属板块的纪要（重要事件记录）。\n\n🎯 测试什么用：看某板块最近发生了什么重要事件。\n📥 入参：plate_id = 板块 ID，count = 返回条数\n📤 返回：板块纪要列表\n💡 典型场景：复盘板块异动原因。",
        "operationId": "bk_jiyao_by_stock_api_kpl_plate_bk_jiyao_by_stock_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条纪要",
              "default": 10,
              "title": "Count"
            },
            "description": "返回多少条纪要"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_jiyao_tags": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块纪要标签",
        "description": "【板块】所有板块纪要标签。\n\n🎯 测试什么用：看所有可用的板块纪要分类标签。\n📥 入参：无\n📤 返回：标签列表\n💡 典型场景：按标签筛选板块纪要。",
        "operationId": "bk_jiyao_tags_api_kpl_plate_bk_jiyao_tags_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/plate/bk_pankou": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块盘口数据",
        "description": "【板块】板块盘口数据（涨跌家数）。\n\n🎯 测试什么用：看某板块今天涨多少家、跌多少家、平多少家。\n📥 入参：plate_id = 板块 ID，period = 周期\n📤 返回：盘口数据（涨/跌/平家数、领涨股、领跌股）\n💡 典型场景：判断板块整体强弱。",
        "operationId": "bk_pankou_api_kpl_plate_bk_pankou_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID",
            "example": "BK0001"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：today / 5day / 20day",
              "default": "today",
              "title": "Period"
            },
            "description": "周期：today / 5day / 20day"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_parent_plate": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "父级板块",
        "description": "【板块】父级板块（板块归属）。\n\n🎯 测试什么用：看某板块属于哪个父板块（如\"机器学习\"属于\"人工智能\"）。\n📥 入参：plate_id = 板块 ID\n📤 返回：父板块信息\n💡 典型场景：理解板块层级关系、向上追溯。",
        "operationId": "bk_parent_plate_api_kpl_plate_bk_parent_plate_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_plate_news": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块新闻",
        "description": "【板块】板块相关新闻。\n\n🎯 测试什么用：看某板块相关的最新新闻。\n📥 入参：plate_id = 板块 ID，count = 条数\n📤 返回：新闻列表\n💡 典型场景：跟踪板块消息面、判断题材持续性。",
        "operationId": "bk_plate_news_api_kpl_plate_bk_plate_news_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "返回多少条新闻",
              "default": 20,
              "title": "Count"
            },
            "description": "返回多少条新闻"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_son_plate": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "子板块",
        "description": "【板块】子板块列表。\n\n🎯 测试什么用：看某板块包含哪些子板块（如\"人工智能\"下的\"机器学习\"、\"大模型\"）。\n📥 入参：plate_id = 板块 ID，date = 日期（可选）\n📤 返回：子板块列表\n💡 典型场景：板块向下细分、找细分龙头。",
        "operationId": "bk_son_plate_api_kpl_plate_bk_son_plate_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD（不传=今天）",
              "title": "Date"
            },
            "description": "日期 YYYY-MM-DD（不传=今天）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_tag": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块标签",
        "description": "【板块】板块的标签。\n\n🎯 测试什么用：看某板块的所有标签（如\"热门\"、\"高增长\"、\"政策利好\"）。\n📥 入参：plate_id = 板块 ID\n📤 返回：标签列表\n💡 典型场景：快速理解板块属性。",
        "operationId": "bk_tag_api_kpl_plate_bk_tag_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_trend_incremental": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块资金增量",
        "description": "【板块】板块资金流入增量。\n\n🎯 测试什么用：看某板块今天净流入多少钱（资金方向）。\n📥 入参：plate_id = 板块 ID，period = 周期\n📤 返回：资金净流入数据\n💡 典型场景：判断资金在买哪个板块、跟随主力资金。",
        "operationId": "bk_trend_incremental_api_kpl_plate_bk_trend_incremental_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID",
            "example": "BK0001"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：today / 5day / 20day",
              "default": "today",
              "title": "Period"
            },
            "description": "周期：today / 5day / 20day"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_voltur_incremental": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块成交量增量",
        "description": "【板块】板块成交量增量。\n\n🎯 测试什么用：看某板块的成交量增减（量在价先）。\n📥 入参：plate_id = 板块 ID，period = 周期\n📤 返回：成交量增量数据\n💡 典型场景：判断板块活跃度、捕捉放量异动。",
        "operationId": "bk_voltur_incremental_api_kpl_plate_bk_voltur_incremental_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "周期：today / 5day / 20day",
              "default": "today",
              "title": "Period"
            },
            "description": "周期：today / 5day / 20day"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_zhibo_content": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块直播内容（今天）",
        "description": "【板块】板块直播内容（今天）。\n\n🎯 测试什么用：看某板块今天的实时直播内容（消息、异动、评论）。\n📥 入参：plate_id = 板块 ID\n📤 返回：直播内容列表\n💡 典型场景：盘中实时跟踪板块动态。",
        "operationId": "bk_zhibo_content_api_kpl_plate_bk_zhibo_content_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/plate/bk_zhibo_content_his": {
      "get": {
        "tags": [
          "🏷️ 板块"
        ],
        "summary": "板块直播内容（历史）",
        "description": "【板块】板块直播内容（指定日期历史）。\n\n🎯 测试什么用：看某板块某一天的历史直播内容。\n📥 入参：plate_id = 板块 ID，day = 日期\n📤 返回：当天直播内容\n💡 典型场景：复盘历史板块异动。",
        "operationId": "bk_zhibo_content_his_api_kpl_plate_bk_zhibo_content_his_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD",
            "example": "2026-08-24"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/art_title": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "文章标题",
        "operationId": "art_title_api_kpl_market_art_title_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/bxzj_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "冰雪资金列表",
        "operationId": "bxzj_list_api_kpl_market_bxzj_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/data_center_disclo": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "数据中心披露",
        "operationId": "data_center_disclo_api_kpl_market_data_center_disclo_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/data_center_index": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "数据中心指数",
        "operationId": "data_center_index_api_kpl_market_data_center_index_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/data_center_relation": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "数据中心关联",
        "operationId": "data_center_relation_api_kpl_market_data_center_relation_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/dazong_stock_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "大宗交易列表",
        "operationId": "dazong_stock_list_api_kpl_market_dazong_stock_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/emotion_money_date": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "情绪资金日期",
        "operationId": "emotion_money_date_api_kpl_market_emotion_money_date_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/emotion_money_detail": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "情绪资金明细",
        "operationId": "emotion_money_detail_api_kpl_market_emotion_money_detail_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/emotion_mood_count": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "情绪计数",
        "operationId": "emotion_mood_count_api_kpl_market_emotion_mood_count_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/etf_ranking": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "ETF 排名",
        "operationId": "etf_ranking_api_kpl_market_etf_ranking_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/forums_column_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "论坛专栏列表",
        "operationId": "forums_column_list_api_kpl_market_forums_column_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/fuplanla_zdt": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "复盘涨跌停",
        "operationId": "fuplanla_zdt_api_kpl_market_fuplanla_zdt_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/global_index": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "全球指数",
        "operationId": "global_index_api_kpl_market_global_index_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/global_search_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "全球搜索列表",
        "operationId": "global_search_list_api_kpl_market_global_search_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/gongneng_tishi": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "功能提示",
        "operationId": "gongneng_tishi_api_kpl_market_gongneng_tishi_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/gudong_renshu": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "股东人数",
        "operationId": "gudong_renshu_api_kpl_market_gudong_renshu_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/index_banner": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "首页 Banner",
        "operationId": "index_banner_api_kpl_market_index_banner_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/index_change": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "指数涨跌",
        "operationId": "index_change_api_kpl_market_index_change_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/index_info": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "指数信息",
        "operationId": "index_info_api_kpl_market_index_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/interact_hot_search": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "互动热搜",
        "operationId": "interact_hot_search_api_kpl_market_interact_hot_search_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/interact_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "互动列表",
        "operationId": "interact_list_api_kpl_market_interact_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/interviews_by_date_stock": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "按日期个股调研",
        "operationId": "interviews_by_date_stock_api_kpl_market_interviews_by_date_stock_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/investment_calendar": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "投资日历",
        "operationId": "investment_calendar_api_kpl_market_investment_calendar_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/kline_day": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "日K线",
        "operationId": "kline_day_api_kpl_market_kline_day_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 60,
              "title": "Count"
            }
          },
          {
            "name": "adjust",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Adjust"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/kline_today": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "今日K线",
        "operationId": "kline_today_api_kpl_market_kline_today_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/market_capacity_kline": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "大盘容量K线",
        "operationId": "market_capacity_kline_api_kpl_market_market_capacity_kline_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/market_mood": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "市场情绪",
        "operationId": "market_mood_api_kpl_market_market_mood_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/market_stock_zd_num": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "涨跌家数",
        "operationId": "market_stock_zd_num_api_kpl_market_market_stock_zd_num_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/news_flash_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "快讯列表",
        "operationId": "news_flash_list_api_kpl_market_news_flash_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 20,
              "title": "Count"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/news_flash_top": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "快讯头条",
        "operationId": "news_flash_top_api_kpl_market_news_flash_top_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/northbound_close_date": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "北向资金收盘日",
        "operationId": "northbound_close_date_api_kpl_market_northbound_close_date_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/pianlizhi_index": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "偏离值指数",
        "operationId": "pianlizhi_index_api_kpl_market_pianlizhi_index_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/plate_info_qj": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "板块区间",
        "operationId": "plate_info_qj_api_kpl_market_plate_info_qj_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/plate_ranking_realtime": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "板块实时排名",
        "operationId": "plate_ranking_realtime_api_kpl_market_plate_ranking_realtime_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/plate_stocks_realtime": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "板块个股实时",
        "operationId": "plate_stocks_realtime_api_kpl_market_plate_stocks_realtime_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/plate_tc_config": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "板块透传配置",
        "operationId": "plate_tc_config_api_kpl_market_plate_tc_config_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/rqz_data": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "融资融券数据",
        "operationId": "rqz_data_api_kpl_market_rqz_data_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/southbound_close_date": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "南向资金收盘日",
        "operationId": "southbound_close_date_api_kpl_market_southbound_close_date_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/stock_new_high_count": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "新高数量",
        "operationId": "stock_new_high_count_api_kpl_market_stock_new_high_count_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "查询日期（默认今天）",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "查询日期（默认今天）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/stock_new_high_stocks": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "新高个股",
        "operationId": "stock_new_high_stocks_api_kpl_market_stock_new_high_stocks_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "查询日期（默认今天）",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "查询日期（默认今天）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/theme_info_gr": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "题材信息",
        "operationId": "theme_info_gr_api_kpl_market_theme_info_gr_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "theme_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "题材 ID",
              "title": "Theme Id"
            },
            "description": "题材 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/theme_news_by_id": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "题材新闻（按 ID）",
        "operationId": "theme_news_by_id_api_kpl_market_theme_news_by_id_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "theme_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "题材 ID",
              "default": "1",
              "title": "Theme Id"
            },
            "description": "题材 ID"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 20,
              "title": "Count"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/theme_news_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "题材新闻列表",
        "operationId": "theme_news_list_api_kpl_market_theme_news_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/topic_get": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "话题详情",
        "operationId": "topic_get_api_kpl_market_topic_get_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "topic_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "话题 ID",
              "default": "1",
              "title": "Topic Id"
            },
            "description": "话题 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/topic_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "话题列表",
        "operationId": "topic_list_api_kpl_market_topic_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/topic_stocks": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "话题相关个股",
        "operationId": "topic_stocks_api_kpl_market_topic_stocks_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "topic_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "话题 ID",
              "default": "1",
              "title": "Topic Id"
            },
            "description": "话题 ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/xianhuo_article": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "现货文章",
        "operationId": "xianhuo_article_api_kpl_market_xianhuo_article_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/xianhuo_list": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "现货列表",
        "operationId": "xianhuo_list_api_kpl_market_xianhuo_list_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/zhishu_kline": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "指数K线",
        "operationId": "zhishu_kline_api_kpl_market_zhishu_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "day",
              "title": "Period"
            }
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 60,
              "title": "Count"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/zhishu_kline_today": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "指数K线（今日）",
        "operationId": "zhishu_kline_today_api_kpl_market_zhishu_kline_today_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/market/board_arb": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "打板套利",
        "operationId": "board_arb_api_kpl_market_board_arb_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/calendar_analysis": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "日历分析",
        "operationId": "calendar_analysis_api_kpl_market_calendar_analysis_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/calendar_review": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "日历复盘",
        "operationId": "calendar_review_api_kpl_market_calendar_review_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/concept_scan": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "概念扫描",
        "operationId": "concept_scan_api_kpl_market_concept_scan_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/lifecycle": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "生命周期",
        "operationId": "lifecycle_api_kpl_market_lifecycle_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/monitor": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "监控",
        "operationId": "monitor_api_kpl_market_monitor_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/market/us_mapping": {
      "get": {
        "tags": [
          "📈 行情"
        ],
        "summary": "美股映射",
        "operationId": "us_mapping_api_kpl_market_us_mapping_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        },
        "security": [
          {
            "APIKeyHeader": []
          }
        ]
      }
    },
    "/api/kpl/history/his_business_log": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "营业部日志",
        "operationId": "his_business_log_api_kpl_history_his_business_log_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "营业部代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "营业部代码"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_change_statistics": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨跌统计",
        "operationId": "his_change_statistics_api_kpl_history_his_change_statistics_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_company_notice": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史公司公告",
        "operationId": "his_company_notice_api_kpl_history_his_company_notice_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_daban": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史打板",
        "operationId": "his_daban_api_kpl_history_his_daban_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_dadan_kline": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史大单K线",
        "operationId": "his_dadan_kline_api_kpl_history_his_dadan_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_daily_limit_index": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨停指数",
        "operationId": "his_daily_limit_index_api_kpl_history_his_daily_limit_index_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_daily_limit_performance": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨停表现",
        "operationId": "his_daily_limit_performance_api_kpl_history_his_daily_limit_performance_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_disk_review": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史盘面复盘",
        "operationId": "his_disk_review_api_kpl_history_his_disk_review_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_emotion": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史情绪",
        "operationId": "his_emotion_api_kpl_history_his_emotion_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_emotion_detail": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史情绪明细",
        "operationId": "his_emotion_detail_api_kpl_history_his_emotion_detail_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_gudong": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史股东",
        "operationId": "his_gudong_api_kpl_history_his_gudong_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_holding_fund": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史持仓基金",
        "operationId": "his_holding_fund_api_kpl_history_his_holding_fund_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_institutional": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史机构",
        "operationId": "his_institutional_api_kpl_history_his_institutional_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_kline": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史K线",
        "operationId": "his_kline_api_kpl_history_his_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "title": "Count"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_kline_today": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史当日K线",
        "operationId": "his_kline_today_api_kpl_history_his_kline_today_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_longhubang": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史龙虎榜",
        "operationId": "his_longhubang_api_kpl_history_his_longhubang_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_market_scln": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史市场涨跌家数",
        "operationId": "his_market_scln_api_kpl_history_his_market_scln_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_market_scln_kline": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨跌家数K线",
        "operationId": "his_market_scln_kline_api_kpl_history_his_market_scln_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_market_stock_zd_num": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨跌停数",
        "operationId": "his_market_stock_zd_num_api_kpl_history_his_market_stock_zd_num_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_news_flash": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史快讯",
        "operationId": "his_news_flash_api_kpl_history_his_news_flash_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_plate_info": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史板块信息",
        "operationId": "his_plate_info_api_kpl_history_his_plate_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_plate_members": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史板块成员",
        "operationId": "his_plate_members_api_kpl_history_his_plate_members_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_plate_news": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史板块新闻",
        "operationId": "his_plate_news_api_kpl_history_his_plate_news_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_plate_qj": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史板块区间",
        "operationId": "his_plate_qj_api_kpl_history_his_plate_qj_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          },
          {
            "name": "r_start",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "09:30",
              "title": "R Start"
            }
          },
          {
            "name": "r_end",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "15:00",
              "title": "R End"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_plate_stocks": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史板块个股",
        "operationId": "his_plate_stocks_api_kpl_history_his_plate_stocks_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "plate_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "板块 ID",
              "default": "TOPIC_1",
              "title": "Plate Id"
            },
            "description": "板块 ID"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          },
          {
            "name": "r_start",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "09:30",
              "title": "R Start"
            }
          },
          {
            "name": "r_end",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "15:00",
              "title": "R End"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_ranking": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史排名",
        "operationId": "his_ranking_api_kpl_history_his_ranking_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_research_report": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史研报",
        "operationId": "his_research_report_api_kpl_history_his_research_report_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_sharp_withdrawal": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史大幅回撤",
        "operationId": "his_sharp_withdrawal_api_kpl_history_his_sharp_withdrawal_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_sharp_withdrawal_list": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史大幅回撤列表",
        "operationId": "his_sharp_withdrawal_list_api_kpl_history_his_sharp_withdrawal_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_stock_ranking": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史个股排名",
        "operationId": "his_stock_ranking_api_kpl_history_his_stock_ranking_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_theme_info": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史题材信息",
        "operationId": "his_theme_info_api_kpl_history_his_theme_info_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "theme_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "题材 ID",
              "default": "1",
              "title": "Theme Id"
            },
            "description": "题材 ID"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_volume_benchmark": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史成交量基准",
        "operationId": "his_volume_benchmark_api_kpl_history_his_volume_benchmark_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_weight_performance": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史权重表现",
        "operationId": "his_weight_performance_api_kpl_history_his_weight_performance_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_weight_performance_list": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史权重表现列表",
        "operationId": "his_weight_performance_list_api_kpl_history_his_weight_performance_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zhangfu_detail": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨跌幅明细",
        "operationId": "his_zhangfu_detail_api_kpl_history_his_zhangfu_detail_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zhishu_kline": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史指数K线",
        "operationId": "his_zhishu_kline_api_kpl_history_his_zhishu_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zhishu_kline_ln": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史指数K线（连）",
        "operationId": "his_zhishu_kline_ln_api_kpl_history_his_zhishu_kline_ln_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zhishu_kline_today_ln": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史指数今日K线",
        "operationId": "his_zhishu_kline_today_ln_api_kpl_history_his_zhishu_kline_today_ln_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zs_real": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史指数实时",
        "operationId": "his_zs_real_api_kpl_history_his_zs_real_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zs_trend": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史指数趋势",
        "operationId": "his_zs_trend_api_kpl_history_his_zs_trend_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "日期 YYYY-MM-DD",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zstrend": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨速",
        "operationId": "his_zstrend_api_kpl_history_his_zstrend_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          },
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zs_trend_history": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史指数趋势（历史）",
        "operationId": "his_zs_trend_history_api_kpl_history_his_zs_trend_history_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "指数代码",
              "default": "000001",
              "title": "Code"
            },
            "description": "指数代码"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zt_expression": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨停表现",
        "operationId": "his_zt_expression_api_kpl_history_his_zt_expression_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "day",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "日期 YYYY-MM-DD",
              "default": "2026-09-20",
              "title": "Day"
            },
            "description": "日期 YYYY-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zt_reason": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨停原因",
        "operationId": "his_zt_reason_api_kpl_history_his_zt_reason_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "股票代码（如 000931）",
              "default": "000001",
              "title": "Code"
            },
            "description": "股票代码（如 000931）",
            "example": "000931"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/history/his_zt_search": {
      "get": {
        "tags": [
          "📜 历史数据"
        ],
        "summary": "历史涨停搜索",
        "operationId": "his_zt_search_api_kpl_history_his_zt_search_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "搜索关键词",
              "default": "平安银行",
              "title": "Keyword"
            },
            "description": "搜索关键词"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/eastmoney/health": {
      "get": {
        "tags": [
          "📈 L2 全数据-延时15分钟行情"
        ],
        "summary": "健康检查（无需 Key）",
        "description": "【L2 全数据-延时15分钟行情】服务健康检查 + 限速计数器状态。\n\n🎯 测试什么用：监控端点是否可用、看限速计数。\n📥 入参：无\n📤 返回：{ok, global_usage, per_key_limit, cache_size}\n💡 典型场景：UptimeRobot 监控、限速排查。",
        "operationId": "health_api_kpl_eastmoney_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/kpl/eastmoney/snapshot": {
      "get": {
        "tags": [
          "📈 L2 全数据-延时15分钟行情"
        ],
        "summary": "单股快照",
        "description": "【L2 全数据-延时15分钟行情】实时延时数据快照。\n\n🎯 测试什么用：盘中看某只股票最新价、最高/最低、成交量、涨跌幅等。\n📥 入参：secid = 市场前缀.代码（沪 1. / 深 0.）\n📤 返回：{code, name, price, high, low, open, volume_hand, amount_yuan, turnover_pct, change_pct}\n💡 典型场景：盘中监控、快照补采、前端展示兜底。\n⚠️ 注意：L2 全数据-延时15分钟行情，准实时场景建议走其他模块。",
        "operationId": "snapshot_api_kpl_eastmoney_snapshot_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "secid",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "secid 编码（如 1.600519 沪市贵州茅台、0.300750 深市宁德时代）",
              "title": "Secid"
            },
            "description": "secid 编码（如 1.600519 沪市贵州茅台、0.300750 深市宁德时代）",
            "example": "1.600519"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/eastmoney/snapshots": {
      "get": {
        "tags": [
          "📈 L2 全数据-延时15分钟行情"
        ],
        "summary": "批量快照（≤50 只）",
        "description": "【L2 全数据-延时15分钟行情】批量实时延时快照。\n\n🎯 测试什么用：一次拉多只股票的最新价和涨跌。\n📥 入参：codes = 逗号分隔代码列表（自动补 secid 前缀）\n📤 返回：[{code, name, price, change_pct, main_net_inflow_yuan}, ...]\n💡 典型场景：板块批量监控、批量筛选。\n⚠️ 上限 **20 只/次**（实际限制；超过返 400）\n⚠️ 全市场 5500 只 ≈ **275 次调用 × 4.6 秒**（按 60/min 限速约 4.6 分钟）",
        "operationId": "snapshots_api_kpl_eastmoney_snapshots_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "codes",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "股票代码列表（逗号分隔，自动补 secid 前缀）",
              "title": "Codes"
            },
            "description": "股票代码列表（逗号分隔，自动补 secid 前缀）",
            "example": "600519,300750,000001"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/eastmoney/kline": {
      "get": {
        "tags": [
          "📈 L2 全数据-延时15分钟行情"
        ],
        "summary": "历史 K 线（日/周/月）",
        "description": "【L2 全数据-延时15分钟行情】历史 K 线数据。\n\n🎯 测试什么用：拉日 K / 周 K / 月 K，做技术分析、回测、回看历史。\n📥 入参：\n    - secid: 市场前缀.代码\n    - klt: 周期（101 日 / 102 周 / 103 月）\n    - beg / end: 起始 / 结束日期（YYYYMMDD）\n    - fqt: 复权方式（0/1/2）\n📤 返回：[{date, open, close, high, low, volume_hand, amount_yuan}, ...]\n💡 典型场景：技术分析、回测取数、回看历史走势。\n⚠️ 返回数据是未复权 / 前复权 / 后复权（按 fqt 参数），需注意超短线策略慎用前复权（详见 393优 V4 教训）。",
        "operationId": "kline_api_kpl_eastmoney_kline_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "secid",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "secid 编码",
              "title": "Secid"
            },
            "description": "secid 编码",
            "example": "1.600519"
          },
          {
            "name": "klt",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 103,
              "minimum": 101,
              "description": "K 线周期：101=日 K，102=周 K，103=月 K",
              "default": 101,
              "title": "Klt"
            },
            "description": "K 线周期：101=日 K，102=周 K，103=月 K"
          },
          {
            "name": "beg",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "起始日期（YYYYMMDD）",
              "title": "Beg"
            },
            "description": "起始日期（YYYYMMDD）",
            "example": "20260810"
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "结束日期（YYYYMMDD）",
              "title": "End"
            },
            "description": "结束日期（YYYYMMDD）",
            "example": "20260817"
          },
          {
            "name": "fqt",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 2,
              "minimum": 0,
              "description": "复权方式：0=不复权，1=前复权，2=后复权",
              "default": 1,
              "title": "Fqt"
            },
            "description": "复权方式：0=不复权，1=前复权，2=后复权"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tdx/index_list": {
      "get": {
        "tags": [
          "📈 TDX 板块/DC 题材"
        ],
        "summary": "TDX 板块基础信息",
        "description": "【TDX】板块基础信息（包含板块分类）。\n\n📥 入参：\n    - trade_date (YYYYMMDD, 默认今天)\n    - idx_type (可选): 概念板块/行业板块/风格板块/地区板块\n    - ts_code (可选): xxxxxx.TDX\n    - fields (可选): 逗号分隔的字段名\n\n📤 返回：板块列表 [{ts_code, name, idx_type, idx_count, total_mv, float_mv}, ...]\n\n⚠️ 权限：Tushare Pro 6000积分以上",
        "operationId": "tdx_index_list_api_kpl_tdx_index_list_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "trade_date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "交易日期 YYYYMMDD（默认今天）",
              "title": "Trade Date"
            },
            "description": "交易日期 YYYYMMDD（默认今天）"
          },
          {
            "name": "idx_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "板块类型：概念板块/行业板块/风格板块/地区板块",
              "title": "Idx Type"
            },
            "description": "板块类型：概念板块/行业板块/风格板块/地区板块"
          },
          {
            "name": "ts_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "板块代码 xxxxxx.TDX",
              "title": "Ts Code"
            },
            "description": "板块代码 xxxxxx.TDX"
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "字段过滤（逗号分隔）",
              "title": "Fields"
            },
            "description": "字段过滤（逗号分隔）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tdx/daily": {
      "get": {
        "tags": [
          "📈 TDX 板块/DC 题材"
        ],
        "summary": "TDX 板块行情（OHLC+主力+涨停家数）",
        "description": "【TDX】板块行情 · 包含德哥要的所有核心字段。\n\n📥 入参：\n    - trade_date (YYYYMMDD, 默认今天)\n    - idx_type (可选): 概念板块/行业板块/风格板块/地区板块\n    - ts_code (可选): xxxxxx.TDX\n    - fields (可选): 逗号分隔\n\n📤 返回：板块行情列表，每条包含:\n    - OHLC: open/high/low/close\n    - 涨跌: change/pct_change\n    - 成交: vol(手)/amount(万元)\n    - 估值: pe/pb/float_mv\n    - 主力: bm_buy_net/bm_net\n    - 涨跌家数: up_num/down_num/limit_up_num/limit_down_num\n    - 多周期涨幅: 3day/5day/10day/20day/60day/mtd/ytd/1year\n\n⚠️ 盘中部分字段为 null（up_num/bm_net 等盘后才计算）\n⚠️ 权限：Tushare Pro 6000积分以上",
        "operationId": "tdx_daily_api_kpl_tdx_daily_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "trade_date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "交易日期 YYYYMMDD（默认今天）",
              "title": "Trade Date"
            },
            "description": "交易日期 YYYYMMDD（默认今天）"
          },
          {
            "name": "ts_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "板块代码 xxxxxx.TDX",
              "title": "Ts Code"
            },
            "description": "板块代码 xxxxxx.TDX"
          },
          {
            "name": "idx_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "板块类型：概念板块/行业板块/风格板块/地区板块",
              "title": "Idx Type"
            },
            "description": "板块类型：概念板块/行业板块/风格板块/地区板块"
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "字段过滤（逗号分隔）",
              "title": "Fields"
            },
            "description": "字段过滤（逗号分隔）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tdx/members": {
      "get": {
        "tags": [
          "📈 TDX 板块/DC 题材"
        ],
        "summary": "TDX 板块成分股",
        "description": "【TDX】板块成分股列表。\n\n📥 入参：\n    - trade_date (YYYYMMDD, 默认今天)\n    - ts_code (必填): xxxxxx.TDX\n    - con_code (可选): xxxxxx.SH/SZ\n\n📤 返回：成分股列表 [{ts_code, trade_date, con_code, con_name}, ...]\n\n⚠️ 权限：Tushare Pro 6000积分以上",
        "operationId": "tdx_members_api_kpl_tdx_members_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "trade_date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "交易日期 YYYYMMDD",
              "title": "Trade Date"
            },
            "description": "交易日期 YYYYMMDD"
          },
          {
            "name": "ts_code",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "板块代码 xxxxxx.TDX（必填）",
              "title": "Ts Code"
            },
            "description": "板块代码 xxxxxx.TDX（必填）"
          },
          {
            "name": "con_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "成分股代码（可选）",
              "title": "Con Code"
            },
            "description": "成分股代码（可选）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tdx/concept_cons": {
      "get": {
        "tags": [
          "📈 TDX 板块/DC 题材"
        ],
        "summary": "KPL 概念题材成分股",
        "description": "【KPL】概念题材成分股（含人气值+描述）。\n\n📥 入参：\n    - trade_date (YYYYMMDD)\n    - ts_code (可选): xxxxxx.KP\n    - con_code (可选): xxxxxx.SH/SZ\n\n📤 返回：成分股列表 [{ts_code, name, con_code, con_name, trade_date, desc, hot_num}, ...]\n\n⚠️ 权限：Tushare Pro 5000积分",
        "operationId": "tdx_concept_cons_api_kpl_tdx_concept_cons_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "trade_date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "交易日期 YYYYMMDD",
              "title": "Trade Date"
            },
            "description": "交易日期 YYYYMMDD"
          },
          {
            "name": "ts_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "题材代码 xxxxxx.KP",
              "title": "Ts Code"
            },
            "description": "题材代码 xxxxxx.KP"
          },
          {
            "name": "con_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "成分股代码",
              "title": "Con Code"
            },
            "description": "成分股代码"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tdx/dc_concept": {
      "get": {
        "tags": [
          "📈 TDX 板块/DC 题材"
        ],
        "summary": "DC 题材库（含热度+涨停数+主力净流入）",
        "description": "【DC】题材库（盘后数据，含热度+涨停数+主力净流入）。\n\n📥 入参：\n    - trade_date (YYYYMMDD)\n    - theme_code (可选): xxxxxx.DC\n    - name (可选): 题材名\n\n📤 返回：题材列表 [{theme_code, trade_date, name, pct_change, hot, sort,\n                   strength, z_t_num, main_change, lead_stock, lead_stock_code,\n                   lead_stock_pct_change}, ...]\n\n⚠️ 盘后才更新（19:00 后）\n⚠️ 权限：Tushare Pro 6000积分以上",
        "operationId": "tdx_dc_concept_api_kpl_tdx_dc_concept_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "trade_date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "交易日期 YYYYMMDD（数据从 20260203 开始）",
              "title": "Trade Date"
            },
            "description": "交易日期 YYYYMMDD（数据从 20260203 开始）"
          },
          {
            "name": "theme_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "题材代码 xxxxxx.DC",
              "title": "Theme Code"
            },
            "description": "题材代码 xxxxxx.DC"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "题材名称（模糊匹配）",
              "title": "Name"
            },
            "description": "题材名称（模糊匹配）"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/tdx/dc_concept_cons": {
      "get": {
        "tags": [
          "📈 TDX 板块/DC 题材"
        ],
        "summary": "DC 题材成分（含入选原因）",
        "description": "【DC】题材成分股（含入选原因+热点排行）。\n\n📥 入参：\n    - trade_date (YYYYMMDD)\n    - ts_code (可选): 股票代码\n    - theme_code (可选): 题材代码\n\n📤 返回：成分列表 [{ts_code, trade_date, name, theme_code, industry_code,\n                   industry, reason, hot_num}, ...]\n\n⚠️ 盘后才更新\n⚠️ 权限：Tushare Pro 6000积分以上",
        "operationId": "tdx_dc_concept_cons_api_kpl_tdx_dc_concept_cons_get",
        "security": [
          {
            "APIKeyHeader": []
          }
        ],
        "parameters": [
          {
            "name": "trade_date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "交易日期 YYYYMMDD",
              "title": "Trade Date"
            },
            "description": "交易日期 YYYYMMDD"
          },
          {
            "name": "ts_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "股票代码",
              "title": "Ts Code"
            },
            "description": "股票代码"
          },
          {
            "name": "theme_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "题材代码",
              "title": "Theme Code"
            },
            "description": "题材代码"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/account/plans": {
      "get": {
        "tags": [
          "💳 账号与支付（v1 · 2026-09-25）"
        ],
        "summary": "套餐清单（公开）",
        "description": "【公开】4 档套餐清单（无需登录）。",
        "operationId": "get_plans_api_v1_account_plans_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/v1/account/link": {
      "post": {
        "tags": [
          "💳 账号与支付（v1 · 2026-09-25）"
        ],
        "summary": "关联 m.590 账号 → 生成 kore_xxx",
        "description": "【m.590 Bearer】关联 m.590 账号到 kore-market，自动生成/找回专属 kore_xxx。\n\nkore_xxx 字符串永不变化（即使再次 link 也是同一个 key）。",
        "operationId": "link_account_api_v1_account_link_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinkRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/account/me": {
      "get": {
        "tags": [
          "💳 账号与支付（v1 · 2026-09-25）"
        ],
        "summary": "我的账号信息（key 脱敏）",
        "description": "【m.590 Bearer】查看我的 kore_xxx（脱敏）+ 用量 + 钱包 + 套餐。",
        "operationId": "get_me_api_v1_account_me_get",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/account/topup": {
      "post": {
        "tags": [
          "💳 账号与支付（v1 · 2026-09-25）"
        ],
        "summary": "充值到 m.590 钱包（pay.590.net 收银台）",
        "description": "【m.590 Bearer】创建 perpay 充值单，返回 pay.590.net 收银台 URL。",
        "operationId": "topup_api_v1_account_topup_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TopupRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/account/apply": {
      "post": {
        "tags": [
          "💳 账号与支付（v1 · 2026-09-25）"
        ],
        "summary": "把已购套餐期限落到 key（不扣款）",
        "description": "【m.590 Bearer】把已购套餐的**付款期限**写入 kore_xxx。\n\n🎯 解决的问题：充值只扣了 m.590 钱包，39400 这边的 kore_xxx 过期时间没动。\n\n📥 Body：\n    - sku (必填)：m.590 的时长型 SKU（month_1/quarter_1/year_1/lifetime）\n    - kore_key (选填)：要续费的 kore_xxx；留空 = 自动关联（未关联则新建）\n\n🛡️ 防白嫖：先查 m.590 侧 `kore.market` 是否为有效订阅，无效直接 409，**不改 key**。\n\n📤 返回：key(脱敏) + 新到期日 + 限速（固定 60 次/分钟）",
        "operationId": "apply_plan_to_key_api_v1_account_apply_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApplyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/account/buy": {
      "post": {
        "tags": [
          "💳 账号与支付（v1 · 2026-09-25）"
        ],
        "summary": "购买/续费套餐（扣 m.590 钱包 → kore_xxx 续费）",
        "description": "【m.590 Bearer】购买/续费套餐。\n\nkore_key 不传：自动关联（已关联复用 / 未关联新建）。\nkore_key 传了：续费到该 key（不存在 → 400，且不扣款）。",
        "operationId": "buy_plan_api_v1_account_buy_post",
        "parameters": [
          {
            "name": "authorization",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BuyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/proxy/{path}": {
      "get": {
        "tags": [
          "🔁 m.590 反向代理"
        ],
        "summary": "反向代理到 m.590（解决 CORS / Mixed Content）",
        "description": "透传任意路径到 m.590。",
        "operationId": "m590_proxy_api_v1_proxy__path__get",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Path"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "🔁 m.590 反向代理"
        ],
        "summary": "反向代理到 m.590（解决 CORS / Mixed Content）",
        "description": "透传任意路径到 m.590。",
        "operationId": "m590_proxy_api_v1_proxy__path__get",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Path"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "🔁 m.590 反向代理"
        ],
        "summary": "反向代理到 m.590（解决 CORS / Mixed Content）",
        "description": "透传任意路径到 m.590。",
        "operationId": "m590_proxy_api_v1_proxy__path__get",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Path"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "🔁 m.590 反向代理"
        ],
        "summary": "反向代理到 m.590（解决 CORS / Mixed Content）",
        "description": "透传任意路径到 m.590。",
        "operationId": "m590_proxy_api_v1_proxy__path__get",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Path"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "🔁 m.590 反向代理"
        ],
        "summary": "反向代理到 m.590（解决 CORS / Mixed Content）",
        "description": "透传任意路径到 m.590。",
        "operationId": "m590_proxy_api_v1_proxy__path__get",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Path"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "options": {
        "tags": [
          "🔁 m.590 反向代理"
        ],
        "summary": "反向代理到 m.590（解决 CORS / Mixed Content）",
        "description": "透传任意路径到 m.590。",
        "operationId": "m590_proxy_api_v1_proxy__path__get",
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Path"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/info": {
      "get": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "鉴权信息概览（所有 key 都能看）",
        "description": "【公开】鉴权信息概览（任何 key 都能调用）· 2026-09-01 加固脱敏版。\n\n🎯 测试什么用：快速看当前服务有多少 Key、每个 Key 的用量。\n📥 入参：无\n📤 返回：所有 Key 的**脱敏**概览（前 12 字符 + 后 4 字符）+ 用量统计\n\n🔒 安全：不再泄露完整 Key 字符串（之前 8 月临时版本会泄露）\n💡 典型场景：登录管理后台时第一眼看到的信息总览。",
        "operationId": "info_admin_info_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/admin/keys/generate": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "生成新 API Key",
        "description": "【master】生成新的正式 API Key（给客户用）· 2026-09-01 加固版。\n\n🎯 测试什么用：给一个新客户/项目开通 API 访问权限。\n📥 Body：\n    - name (必填)：客户名/项目名（如 \"张三-股票机器人\"）\n    - note (选填)：备注（如 \"2026-08 开通\"）\n    - rate_limit (选填)：每分钟调用次数上限（固定默认 60，上限 1000）\n    - expire_days (选填)：多少天后过期（默认 None=永不过期；最大 365）\n📤 返回：新生成的 key + 用量信息 + 过期时间\n\n💡 典型场景：\n    - 客户签约后生成 35日 Key 发给他\n    - 新项目接入时生成专用 Key\n    - 德哥生产 = expire_days=0（永不过期）\n\n⚠️ 生成后请把 key 字符串安全发给客户（界面会一次性显示完整 key）。",
        "operationId": "generate_key_admin_keys_generate_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateKeyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/keys/generate-batch": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "批量生成 API Key",
        "description": "【master】一次性批量生成多个 API Key（2026-09-03 智核新增）。\n\n🎯 测试什么用：批量开通客户/项目，省得循环调 10 次 /generate。\n📥 Body：\n    - count (必填)：生成数量（1-50）\n    - name_prefix (选填)：前缀；留空 → 用 created_at 作前缀\n    - note (选填)：统一备注\n    - rate_limit (选填)：默认 100，上限 1000\n    - expire_days (选填)：None/0=永久；最大 365\n📤 返回：成功/失败明细 + 每个 Key 仅此一次明文\n\n💡 命名规则（B 方案 · 2026-09-03）：\n    - name_prefix 留空  →  \"2026-09-03-15-34-21-01\" ~ \"..-10\"\n    - name_prefix=\"dege-202609\"  →  \"dege-202609-01\" ~ \"-10\"\n    序号格式 {i:02d}（1-9 自动补 0，与 10 对齐）\n\n⚠️ 部分成功策略：单条失败不阻断其他，整体 ok=False 但已成功的 Key 仍返回。",
        "operationId": "generate_keys_batch_admin_keys_generate_batch_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchGenerateKeyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/keys/extend": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "续费 API Key（key 字符串不变）",
        "description": "【master】续费 API Key · key 字符串不变 · 2026-09-05 智核新增。\n\n🎯 测试什么用：客户续费时，原 key 字符串保持不变，业务代码无需改动。\n📥 入参：\n    - key：要续费的完整 key（如 kore_xxxxxxxx）\n    - extend_days：续费天数（1-365）\n📤 返回：旧到期日、新到期日、续费天数\n\n💡 典型场景：\n    - 客户月付 → 月底续费 30 天\n    - 客户年付 → 年初续费 365 天\n    - 永久 Key → 转付费：续 30 天后从今天开始计算到期\n\n⚠️ 注意：\n    - 必须 master key 调用\n    - 不允许续 master key 本身\n    - 已过期的 Key 可\"复活\"（续费后立即可用）\n\n使用示例：\n    requests.post(f\"{BASE}/api/kpl/admin/keys/extend\",\n                  headers={\"X-API-Key\": \"master\"},\n                  json={\"key\": \"kore_abcdefgh...\", \"extend_days\": 30})",
        "operationId": "extend_key_admin_keys_extend_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExtendKeyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/keys/revive": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "复活已删 API Key（key 字符串复用）",
        "description": "【master】复活已删的 API Key · 复用老 Key 字符串 · 2026-09-06 智核新增。\n\n🎯 测试什么用：用户代码里写死了老 Key 字符串，因文件被删而失效（HTTP 403），\n又不想改业务代码 — 用 revive 把老 Key 字符串重新写回 api_keys.json。\n\n📥 入参：\n    - key：要复活的完整 Key（如 kore_xxxxxxxx）\n    - name：用户标识（建议用原 name）\n    - note：备注（建议带\"复活\"标记）\n    - rate_limit：每分钟调用次数上限（默认 60）\n    - expire_days：多少天后过期\n\n📤 返回：复活的 Key + name + expire_at + rate_limit_per_minute\n\n⚠️ 注意：\n    - 必须 master key 调用\n    - Key 字符串必须以 \"kore_\" 开头\n    - Key 字符串必须**不在**文件里（已存在的 Key 走 extend 续期）\n    - 不允许复活 master key\n    - rate_limit ∈ [1, 1000]，expire_days ∈ [0, 365]\n    - 写盘走 _file_lock + reload-from-disk + temp+rename 三层保险（与 generate/revoke/extend 一致）\n\n💡 典型场景：\n    - user5 老 Key `kore_N_7GWsyv5zq...` 在 9-05 14:30 被误删重建\n    - 用户代码还在用老 Key → 调业务接口 403\n    - 用 revive 复活 → 用户代码 0 改动，立即恢复使用\n\n使用示例：\n    requests.post(f\"{BASE}/api/kpl/admin/keys/revive\",\n                  headers={\"X-API-Key\": \"master\"},\n                  json={\"key\": \"kore_abcdefgh...\", \"name\": \"dege-user5-202609\",\n                        \"note\": \"误删复活 · 2026-09-06\", \"rate_limit\": 60, \"expire_days\": 35})",
        "operationId": "revive_key_admin_keys_revive_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviveKeyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/keys/revoke": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "撤销 API Key",
        "description": "【master】撤销一个 API Key（删除客户权限）。\n\n🎯 测试什么用：客户违约/不再合作时，撤销他的访问权限。\n📥 入参：key = 要撤销的完整 key 字符串\n📤 返回：撤销成功/失败\n\n💡 典型场景：\n    - 客户合同到期\n    - 发现 Key 泄露\n    - 测试账户清理\n\n⚠️ 注意：master key 不能撤销自己（避免锁死）。\n\n使用示例：\n    requests.post(f\"{BASE}/api/kpl/admin/keys/revoke\",\n                  headers={\"X-API-Key\": \"master\"},\n                  params={\"key\": \"kore_abcdefgh...\"})",
        "operationId": "revoke_key_admin_keys_revoke_post",
        "parameters": [
          {
            "name": "key",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "要撤销的完整 Key（如 kore_xxxxxxxx）",
              "title": "Key"
            },
            "description": "要撤销的完整 Key（如 kore_xxxxxxxx）"
          },
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/keys/list": {
      "get": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "列出所有 API Key",
        "description": "【master】列出所有 API Key（含完整 key + 用量统计）。\n\n🎯 测试什么用：完整查看所有 Key（包括完整 key 字符串，便于复制给客户）。\n📥 入参：无\n📤 返回：所有 Key 的详细信息\n\n💡 典型场景：\n    - 审计：定期检查所有 Key 状态\n    - 复制 key 字符串发给客户\n    - 查看哪些 Key 没用起来（清理）\n\n⚠️ 注意：这个接口会显示正式 key 的完整字符串，请妥善保管。",
        "operationId": "list_keys_admin_keys_list_get",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/usage/{key_prefix}": {
      "get": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "查询某个 Key 的用量",
        "description": "【master】通过 key 前缀查询某个 Key 的用量。\n\n🎯 测试什么用：只记得 key 的开头几个字符，想查它的用量。\n📥 入参：key_prefix = key 的前几个字符（至少 4 个）\n📤 返回：匹配的 key 信息 + 用量\n\n💡 典型场景：\n    - 只记得 key 开头几个字符\n    - 客户反馈\"我的 key 用不了\"，查他的用量\n\n使用示例：\n    requests.get(f\"{BASE}/api/kpl/admin/usage/kore_abc\",\n                 headers={\"X-API-Key\": \"master\"})",
        "operationId": "get_usage_admin_usage__key_prefix__get",
        "parameters": [
          {
            "name": "key_prefix",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Key Prefix"
            }
          },
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/stats": {
      "get": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "总体统计",
        "description": "【master】所有 Key 的总调用统计。\n\n🎯 测试什么用：看整体服务的使用情况（每个 Key 今天调用了多少次、最近一分钟调用了多少）。\n📥 入参：无\n📤 返回：总调用次数 + 每个 Key 的今日/最近一分钟调用次数\n\n💡 典型场景：\n    - 监控：看服务繁忙程度\n    - 计费：统计每个客户调用量\n    - 异常排查：哪个 key 突然调得特别多",
        "operationId": "stats_admin_stats_get",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/keys/test-reset": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "重置测试 Key",
        "description": "【master】立即重置当日的测试 Key（强制重新生成）。\n\n🎯 测试什么用：网页测试时，把当日测试 Key 清空，重新生成一个（每天 50 次限额用完后用）。\n📥 入参：无\n📤 返回：被删除的 key 列表 + 新生成的 key\n\n💡 典型场景：\n    - 网页测试额度用完（每天 50 次）\n    - 测试 key 泄漏需要换新\n    - 排查问题时想换个干净的 key\n\n⚠️ 测试 key 每天自动重置，不需要手动重置。",
        "operationId": "reset_test_key_admin_keys_test_reset_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/today-stocks/update": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "手动更新当日出票",
        "description": "【master】手动更新当日出票股票（不拉 morning_bidding，直接填代码）。\n\n🎯 测试什么用：调试接口默认值时，手动指定今天要用的股票。\n📥 Body：\n    - codes (必填)：股票代码列表（如 [\"000931\", \"600009\"]）\n    - names (选填)：股票名称列表\n    - plate_ids (选填)：板块 ID 列表\n    - trigger (选填)：触发方式，默认 \"manual\"\n📤 返回：更新后的状态\n\n💡 典型场景：\n    - 调试某个特定股票时，手动设为默认\n    - morning_bidding 拉取失败时手动补救\n    - 测试某个接口在特定股票上的表现",
        "operationId": "update_today_stocks_admin_today_stocks_update_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTodayStocksRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/today-stocks/refresh": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "立即拉取最新出票",
        "description": "【master】立即调用 morning_bidding 拉取最新出票，更新默认值。\n\n🎯 测试什么用：不想等 cron 立即生效，手动触发拉取。\n📥 入参：无\n📤 返回：拉取结果 + 更新后的状态\n\n💡 典型场景：\n    - 9:25 某只股票刚撮合但 cron 还没跑\n    - 调试某个具体股票表现",
        "operationId": "refresh_today_stocks_admin_today_stocks_refresh_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/today-stocks/status": {
      "get": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "查看当日出票状态",
        "description": "【master】查看当日出票详细状态。\n\n🎯 测试什么用：看默认股票是什么、出票是否最新、哪些接口受影响。\n📥 入参：无\n📤 返回：完整状态信息",
        "operationId": "today_stocks_status_admin_today_stocks_status_get",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/admin/today-stocks/push-tomorrow-topic": {
      "post": {
        "tags": [
          "⚙️ 管理 API（master 专属）"
        ],
        "summary": "推送明天炒什么作为默认值",
        "description": "【master】推送「明天炒什么」作为 kore-market 默认值。\n\n🎯 测试什么用：让明天所有接口默认测试参数指向热门题材个股。\n📥 Body：\n    - topics (必填)：题材列表 [{id, title, hot_val, good_stocks: [{code, name}]}]\n    - target_date (选填)：适用日期（默认明天）\n📤 返回：更新结果\n\n💡 典型场景：\n    - 21:00 cron 跑完「明天炒什么」后自动推送\n    - 手动调试某些题材个股\n    - 9:25 前没有出票时使用\n\n⚠️ 调用方：tomorrow_topic_runner.py cron 任务",
        "operationId": "push_tomorrow_topic_admin_today_stocks_push_tomorrow_topic_post",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PushTomorrowTopicRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_depth_narrow": {
      "get": {
        "summary": "上游转发: stock/stock_depth_narrow",
        "operationId": "upstream_stock_stock_depth_narrow_api_kpl_stock_stock_depth_narrow_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_depth_narrow",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/index_depth": {
      "get": {
        "summary": "上游转发: stock/index_depth",
        "operationId": "upstream_stock_index_depth_api_kpl_stock_index_depth_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/index_depth",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_auction_bid": {
      "get": {
        "summary": "上游转发: stock/stock_auction_bid",
        "operationId": "upstream_stock_stock_auction_bid_api_kpl_stock_stock_auction_bid_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_auction_bid",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_main_money_trend": {
      "get": {
        "summary": "上游转发: stock/stock_main_money_trend",
        "operationId": "upstream_stock_stock_main_money_trend_api_kpl_stock_stock_main_money_trend_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_main_money_trend",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_buy_sell_volume_trend": {
      "get": {
        "summary": "上游转发: stock/stock_buy_sell_volume_trend",
        "operationId": "upstream_stock_stock_buy_sell_volume_trend_api_kpl_stock_stock_buy_sell_volume_trend_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_buy_sell_volume_trend",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_duidao_trend": {
      "get": {
        "summary": "上游转发: stock/stock_duidao_trend",
        "operationId": "upstream_stock_stock_duidao_trend_api_kpl_stock_stock_duidao_trend_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_duidao_trend",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_tick_trades": {
      "get": {
        "summary": "上游转发: stock/stock_tick_trades",
        "operationId": "upstream_stock_stock_tick_trades_api_kpl_stock_stock_tick_trades_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_tick_trades",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_chip_distribution": {
      "get": {
        "summary": "上游转发: stock/stock_chip_distribution",
        "operationId": "upstream_stock_stock_chip_distribution_api_kpl_stock_stock_chip_distribution_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_chip_distribution",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_incremental_trend": {
      "get": {
        "summary": "上游转发: stock/stock_incremental_trend",
        "operationId": "upstream_stock_stock_incremental_trend_api_kpl_stock_stock_incremental_trend_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_incremental_trend",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/kpl/stock/stock_finance_info": {
      "get": {
        "summary": "上游转发: stock/stock_finance_info",
        "operationId": "upstream_stock_stock_finance_info_api_kpl_stock_stock_finance_info_get",
        "parameters": [
          {
            "name": "p",
            "in": "query",
            "required": false,
            "schema": {
              "default": "stock/stock_finance_info",
              "title": "P"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ApplyRequest": {
        "properties": {
          "bearer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bearer"
          },
          "sku": {
            "type": "string",
            "title": "Sku"
          },
          "kore_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Kore Key"
          }
        },
        "type": "object",
        "required": [
          "sku"
        ],
        "title": "ApplyRequest",
        "description": "把已购套餐的期限落到 key（不扣款）。"
      },
      "BatchGenerateKeyRequest": {
        "properties": {
          "count": {
            "type": "integer",
            "title": "Count",
            "default": 10
          },
          "name_prefix": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name Prefix"
          },
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Note",
            "default": ""
          },
          "rate_limit": {
            "type": "integer",
            "title": "Rate Limit",
            "default": 60
          },
          "expire_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expire Days"
          }
        },
        "type": "object",
        "title": "BatchGenerateKeyRequest",
        "description": "批量生成 Key 的请求体（2026-09-03 智核新增）。\n\n字段：\n  count        (必填)  生成数量（1-50）\n  name_prefix  (选填)  前缀；留空 → 用 created_at（YYYY-MM-DD-HH-MM-SS，无冒号）当前缀\n  note         (选填)  统一备注\n  rate_limit   (选填)  每分钟调用次数上限（固定默认 60，上限 1000）\n  expire_days  (选填)  None/0=永不过期；最大 365"
      },
      "BuyRequest": {
        "properties": {
          "bearer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bearer"
          },
          "plan": {
            "type": "string",
            "title": "Plan"
          },
          "kore_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Kore Key"
          }
        },
        "type": "object",
        "required": [
          "plan"
        ],
        "title": "BuyRequest"
      },
      "ExtendKeyRequest": {
        "properties": {
          "key": {
            "type": "string",
            "title": "Key"
          },
          "extend_days": {
            "type": "integer",
            "title": "Extend Days"
          }
        },
        "type": "object",
        "required": [
          "key",
          "extend_days"
        ],
        "title": "ExtendKeyRequest",
        "description": "续费 Key 的请求体（2026-09-05 智核新增）。\n\n字段：\n  key          (必填)  要续费的 API Key\n  extend_days  (必填)  续费天数（1-365）\n\n行为：\n  - 已有 expire_at：在原到期日上叠加\n  - 永不过期（expire_at=None）：从今天起算\n  - 已过期：自动\"复活\"，从今天起算"
      },
      "GenerateKeyRequest": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "note": {
            "type": "string",
            "title": "Note",
            "default": ""
          },
          "rate_limit": {
            "type": "integer",
            "title": "Rate Limit",
            "default": 60
          },
          "expire_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expire Days"
          }
        },
        "type": "object",
        "required": [
          "name"
        ],
        "title": "GenerateKeyRequest",
        "description": "生成 Key 的请求体（2026-09-01 加固版）。\n\n字段：\n  name        (必填)  客户名/项目名（如 \"张三-股票机器人\"）\n  note        (选填)  备注信息（如 \"2026-08 开通\"）\n  rate_limit  (选填)  每分钟调用次数上限（固定默认 60，上限 1000）\n  expire_days (选填)  充值套餐时长（None/0=永不过期；最大 365）"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "LinkRequest": {
        "properties": {
          "bearer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bearer"
          }
        },
        "type": "object",
        "title": "LinkRequest"
      },
      "PushTomorrowTopicRequest": {
        "properties": {
          "topics": {
            "items": {},
            "type": "array",
            "title": "Topics",
            "default": []
          },
          "target_date": {
            "type": "string",
            "title": "Target Date",
            "default": ""
          }
        },
        "type": "object",
        "title": "PushTomorrowTopicRequest",
        "description": "明天炒什么推送请求。"
      },
      "ReviveKeyRequest": {
        "properties": {
          "key": {
            "type": "string",
            "title": "Key"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "note": {
            "type": "string",
            "title": "Note",
            "default": ""
          },
          "rate_limit": {
            "type": "integer",
            "title": "Rate Limit",
            "default": 60
          },
          "expire_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expire Days"
          }
        },
        "type": "object",
        "required": [
          "key",
          "name"
        ],
        "title": "ReviveKeyRequest",
        "description": "复活 Key 的请求体（2026-09-06 智核新增）。\n\n与 ExtendKeyRequest 的区别：\n  - extend：Key 在文件里且有 expire_at → 只动 expire_at\n  - revive：Key 不在文件里 → 把 Key 字符串重新写回文件\n\n字段：\n  key         (必填)  要复活的完整 Key（如 kore_xxxxxxxx），必须以 \"kore_\" 开头\n  name        (必填)  客户名/项目名（如 \"dege-user5-202609\"）\n  note        (选填)  备注（建议带\"复活\"标记便于审计）\n  rate_limit  (选填)  每分钟调用次数上限（默认 60，上限 1000）\n  expire_days (选填)  多少天后过期（None/0=永不过期；最大 365）"
      },
      "TopupRequest": {
        "properties": {
          "bearer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bearer"
          },
          "amountYuan": {
            "type": "number",
            "title": "Amountyuan"
          }
        },
        "type": "object",
        "required": [
          "amountYuan"
        ],
        "title": "TopupRequest"
      },
      "UpdateTodayStocksRequest": {
        "properties": {
          "codes": {
            "items": {},
            "type": "array",
            "title": "Codes",
            "default": []
          },
          "names": {
            "items": {},
            "type": "array",
            "title": "Names",
            "default": []
          },
          "plate_ids": {
            "items": {},
            "type": "array",
            "title": "Plate Ids",
            "default": []
          },
          "trigger": {
            "type": "string",
            "title": "Trigger",
            "default": "manual"
          }
        },
        "type": "object",
        "title": "UpdateTodayStocksRequest",
        "description": "手动更新当日出票。"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    },
    "securitySchemes": {
      "APIKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}