{"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"}}}}