{"openapi":"3.1.0","info":{"title":"TickerLab Data API","description":"Professional financial market data APIs for analytics, trading, and investment applications.","version":"1.0.0"},"paths":{"/v1/export/history":{"get":{"tags":["数据导出"],"summary":"导出历史数据","description":"下载历史OHLCV数据为CSV或JSON格式。\n\n## 使用场景\n- 回测交易策略\n- 训练机器学习模型\n- 生成报告\n\n## 示例\n\n```bash\ncurl -X GET \"https://tickerlab.org/v1/export/history?symbol=sz.000001&start_date=2024-01-01&end_date=2024-12-31&format=csv\" \\\n     -H \"X-API-Key: your_key\" \\\n     -o data.csv\n```\n\n## 计费规则\n- 仅成功导出的请求计费\n- `format` 会影响计费额度，具体规则以当前套餐和 Playground 显示为准","operationId":"export_history_v1_export_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (例如: sz.000001)","examples":["sz.000001","sh.600519"],"title":"Symbol"},"description":"股票代码 (例如: sz.000001)"},{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD)","examples":["2024-01-01"],"title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD)","examples":["2024-12-31"],"title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"时间周期","examples":["1d","1h","15m"],"default":"1d","title":"Interval"},"description":"时间周期"},{"name":"format","in":"query","required":false,"schema":{"enum":["csv","json"],"type":"string","description":"导出格式","default":"csv","title":"Format"},"description":"导出格式"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/ws-token":{"get":{"tags":["Real-time Data"],"summary":"Mint a short-lived WebSocket ticket for `/ws/quotes`","description":"Mint a short-lived WebSocket ticket for `/ws/quotes`.\n\nClients should connect using:\n`new WebSocket(url, [\"tickerlab-ws.v1\", ws_token])`","operationId":"create_ws_quotes_ticket_v1_markets_ws_token_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["Real-time Data"],"summary":"Mint a short-lived WebSocket ticket for `/ws/quotes`","description":"Mint a short-lived WebSocket ticket for `/ws/quotes`.\n\nClients should connect using:\n`new WebSocket(url, [\"tickerlab-ws.v1\", ws_token])`","operationId":"create_ws_quotes_ticket_v1_markets_ws_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/indicators/bbands":{"get":{"tags":["技术指标"],"summary":"布林带指标","description":"获取布林带指标数据用于技术分析。","operationId":"get_bbands_v1_indicators_bbands_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"timeperiod","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":2,"description":"计算周期 (可选)","default":20,"title":"Timeperiod"},"description":"计算周期 (可选)"},{"name":"stds","in":"query","required":false,"schema":{"type":"number","maximum":5.0,"minimum":0.5,"description":"标准差倍数 (可选)","default":2.0,"title":"Stds"},"description":"标准差倍数 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"最大数据点数","default":5000,"title":"Limit"},"description":"最大数据点数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/macd":{"get":{"tags":["技术指标"],"summary":"MACD指标数据","description":"获取MACD指标数据。","operationId":"get_macd_v1_indicators_macd_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"fastperiod","in":"query","required":false,"schema":{"type":"integer","description":"MACD快速EMA周期 (可选)","default":12,"title":"Fastperiod"},"description":"MACD快速EMA周期 (可选)"},{"name":"slowperiod","in":"query","required":false,"schema":{"type":"integer","description":"MACD慢速EMA周期 (可选)","default":26,"title":"Slowperiod"},"description":"MACD慢速EMA周期 (可选)"},{"name":"signalperiod","in":"query","required":false,"schema":{"type":"integer","description":"MACD信号线周期 (可选)","default":9,"title":"Signalperiod"},"description":"MACD信号线周期 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回数据点数","default":5000,"title":"Limit"},"description":"返回数据点数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/rsi":{"get":{"tags":["技术指标"],"summary":"RSI指标数据","description":"获取RSI指标数据。","operationId":"get_rsi_v1_indicators_rsi_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"timeperiod","in":"query","required":false,"schema":{"type":"integer","minimum":2,"description":"RSI计算周期 (可选)","default":14,"title":"Timeperiod"},"description":"RSI计算周期 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"description":"返回数据点数","default":5000,"title":"Limit"},"description":"返回数据点数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/ma":{"get":{"tags":["技术指标"],"summary":"简单移动平均线(SMA/MA)","description":"计算简单移动平均线(SMA/MA)。\n\n## 请求示例\n```\nGET /ma?symbol=sz.000001&interval=1d&timeperiod=20\n```","operationId":"get_ma_v1_indicators_ma_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码，例如：sz.000001","title":"Symbol"},"description":"股票代码，例如：sz.000001"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"timeperiod","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":2,"description":"移动平均周期","default":20,"title":"Timeperiod"},"description":"移动平均周期"},{"name":"series_type","in":"query","required":false,"schema":{"type":"string","description":"价格类型：open, high, low, close","default":"close","title":"Series Type"},"description":"价格类型：open, high, low, close"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"最大数据点数","default":5000,"title":"Limit"},"description":"最大数据点数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/ema":{"get":{"tags":["技术指标"],"summary":"指数移动平均线(EMA)","description":"计算指数移动平均线(EMA)。\n\nEMA给予近期价格更高的权重，使其对新信息更敏感。","operationId":"get_ema_v1_indicators_ema_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码，例如：sz.000001","title":"Symbol"},"description":"股票代码，例如：sz.000001"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"timeperiod","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":2,"description":"EMA周期","default":20,"title":"Timeperiod"},"description":"EMA周期"},{"name":"series_type","in":"query","required":false,"schema":{"type":"string","description":"价格类型：open, high, low, close","default":"close","title":"Series Type"},"description":"价格类型：open, high, low, close"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"最大数据点数","default":5000,"title":"Limit"},"description":"最大数据点数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/kdj":{"get":{"tags":["技术指标"],"summary":"KDJ指标(随机指标)","description":"计算KDJ指标(随机指标)。\n\nKDJ是中国股市中常用的动量指标：\n- **K线**: 平滑后的随机值\n- **D线**: 平滑后的信号线\n- **J线**: 3×K - 2×D (用于测量背离，KDJ独有)\n\n## 交易信号\n- **超买**: K, D > 80\n- **超卖**: K, D < 20\n- **金叉**: K上穿D\n- **死叉**: K下穿D","operationId":"get_kdj_v1_indicators_kdj_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码，例如：sz.000001","title":"Symbol"},"description":"股票代码，例如：sz.000001"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"fastk_period","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"快速K线周期(RSV周期)","default":9,"title":"Fastk Period"},"description":"快速K线周期(RSV周期)"},{"name":"slowk_period","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"慢速K线平滑周期","default":3,"title":"Slowk Period"},"description":"慢速K线平滑周期"},{"name":"slowd_period","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"慢速D线平滑周期","default":3,"title":"Slowd Period"},"description":"慢速D线平滑周期"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"最大数据点数","default":5000,"title":"Limit"},"description":"最大数据点数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/ticker_info":{"get":{"tags":["技术指标"],"summary":"股票基本信息","description":"获取股票基本信息。","operationId":"get_ticker_info_v1_indicators_ticker_info_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (例如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (例如: sz.000001, sh.600519)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/vwap":{"get":{"tags":["技术指标"],"summary":"成交量加权平均价（VWAP）","description":"获取成交量加权平均价（VWAP）。","operationId":"get_vwap_v1_indicators_vwap_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期","title":"Start Date"},"description":"开始日期"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期","title":"End Date"},"description":"结束日期"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回条数","default":5000,"title":"Limit"},"description":"返回条数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/stoch":{"get":{"tags":["技术指标"],"summary":"随机震荡指标（Stochastic Oscillator）","description":"获取随机震荡指标（Stochastic Oscillator）。","operationId":"get_stoch_v1_indicators_stoch_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期","title":"Start Date"},"description":"开始日期"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期","title":"End Date"},"description":"结束日期"},{"name":"fastk_period","in":"query","required":false,"schema":{"type":"integer","description":"FastK周期","default":14,"title":"Fastk Period"},"description":"FastK周期"},{"name":"slowk_period","in":"query","required":false,"schema":{"type":"integer","description":"SlowK周期","default":3,"title":"Slowk Period"},"description":"SlowK周期"},{"name":"slowd_period","in":"query","required":false,"schema":{"type":"integer","description":"SlowD周期","default":3,"title":"Slowd Period"},"description":"SlowD周期"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回条数","default":5000,"title":"Limit"},"description":"返回条数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/atr":{"get":{"tags":["技术指标"],"summary":"平均真实波幅（ATR）","description":"获取平均真实波幅（ATR）。","operationId":"get_atr_v1_indicators_atr_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期","title":"Start Date"},"description":"开始日期"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期","title":"End Date"},"description":"结束日期"},{"name":"timeperiod","in":"query","required":false,"schema":{"type":"integer","description":"计算周期","default":14,"title":"Timeperiod"},"description":"计算周期"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回条数","default":5000,"title":"Limit"},"description":"返回条数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/obv":{"get":{"tags":["技术指标"],"summary":"能量潮指标（OBV）","description":"获取能量潮指标（OBV）。","operationId":"get_obv_v1_indicators_obv_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期","title":"Start Date"},"description":"开始日期"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期","title":"End Date"},"description":"结束日期"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回条数","default":5000,"title":"Limit"},"description":"返回条数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/adx":{"get":{"tags":["技术指标"],"summary":"平均趋向指数（ADX）","description":"获取平均趋向指数（ADX）。","operationId":"get_adx_v1_indicators_adx_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期","title":"Start Date"},"description":"开始日期"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期","title":"End Date"},"description":"结束日期"},{"name":"timeperiod","in":"query","required":false,"schema":{"type":"integer","description":"计算周期","default":14,"title":"Timeperiod"},"description":"计算周期"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回条数","default":5000,"title":"Limit"},"description":"返回条数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indicators/time_series":{"get":{"tags":["技术指标"],"summary":"K线及技术指标(带TA)","description":"获取指定股票的K线数据（包含技术指标如MA/MACD/RSI等）。","operationId":"get_time_series_v1_indicators_time_series_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"adjust","in":"query","required":false,"schema":{"type":"string","description":"复权类型","default":"","title":"Adjust"},"description":"复权类型"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"返回条数","default":5000,"title":"Limit"},"description":"返回条数"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)","default":"1d","title":"Interval"},"description":"K线周期 (支持: 1m, 5m, 15m, 30m, 60m, 1h, 4h, 1d, 1w, 1M)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/chart/batch":{"post":{"tags":["市场全局与交易机制"],"summary":"批量生成图表","description":"一次请求生成多个金融行情图表。","operationId":"batch_create_charts_v1_markets_chart_batch_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"items":{"$ref":"#/components/schemas/KLineRequest"},"type":"array"},{"$ref":"#/components/schemas/KLineRequest"}],"title":"Requests"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/markets/history":{"get":{"tags":["市场全局与交易机制"],"summary":"历史行情","description":"提供指定证券的OHLCV历史行情数据。","operationId":"get_market_history_v1_markets_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (如: 1m, 1d, 1w)","default":"1d","title":"Interval"},"description":"K线周期 (如: 1m, 1d, 1w)"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"adjust","in":"query","required":false,"schema":{"type":"string","description":"复权类型 (qfq-前复权，hfq-后复权) (可选)","title":"Adjust"},"description":"复权类型 (qfq-前复权，hfq-后复权) (可选)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/calendar":{"get":{"tags":["市场全局与交易机制"],"summary":"交易日历","description":"获取交易日历。\n\n返回每个交易所的日期和交易日状态。","operationId":"get_trade_calendar_v1_markets_calendar_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所代码 (SSE/SZSE) (可选)","title":"Exchange"},"description":"交易所代码 (SSE/SZSE) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"is_trading_day","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"过滤交易日 (1=是, 0=否) (可选)","title":"Is Trading Day"},"description":"过滤交易日 (1=是, 0=否) (可选)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeCalendarResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/margin":{"get":{"tags":["市场全局与交易机制"],"summary":"融资融券市场汇总","operationId":"get_margin_v1_markets_margin_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarginDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供融资余额、融券余额及市场整体融资融券指标。"}},"/v1/markets/margin-detail":{"get":{"tags":["市场全局与交易机制"],"summary":"融资融券个股明细","operationId":"get_margin_detail_v1_markets_margin_detail_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exchange"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"default":300,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供个股融资融券余额及交易明细。"}},"/v1/markets/block-trade-daily":{"get":{"tags":["市场全局与交易机制"],"summary":"大宗交易市场统计","operationId":"get_block_trade_daily_v1_markets_block_trade_daily_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockTradeDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供大宗交易市场的每日汇总指标。"}},"/v1/markets/block-trade-detail":{"get":{"tags":["市场全局与交易机制"],"summary":"大宗交易明细","operationId":"get_block_trade_detail_v1_markets_block_trade_detail_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockTradeDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供上市公司大宗交易成交记录。"}},"/v1/markets/hsgt-stock-statistics":{"get":{"tags":["市场全局与交易机制"],"summary":"沪深港通持股统计","operationId":"get_hsgt_stock_statistics_v1_markets_hsgt_stock_statistics_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供沪深港通标的持股数量及变动数据。"}},"/v1/markets/suspend-resume-events":{"get":{"tags":["市场全局与交易机制"],"summary":"停复牌事件","operationId":"get_suspend_resume_events_v1_markets_suspend_resume_events_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"default":300,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供上市公司停牌与复牌事件记录。"}},"/v1/markets/options/snapshot":{"get":{"tags":["市场全局与交易机制"],"summary":"期权行情快照","description":"获取期权市场的行情快照数据 (包括认购/认沽类型、行权价、到期日、最新价、结算价等)。","operationId":"get_option_snapshots_v1_markets_options_snapshot_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"underlying","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"标的证券名称 (如: etf_option) (可选)","title":"Underlying"},"description":"标的证券名称 (如: etf_option) (可选)"},{"name":"contract_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"期权合约代码 (可选)","title":"Contract Code"},"description":"期权合约代码 (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指定日期 (YYYY-MM-DD) (可选)","title":"Date"},"description":"指定日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptionSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/ivix":{"get":{"tags":["市场全局与交易机制"],"summary":"ETF 期权 iVIX (R3)","description":"从 ETF 期权 BS 反推隐含波动率，近似中国版 VIX 恐慌指数。","operationId":"get_ivix_v1_markets_ivix_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"underlying","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"标的 (如 etf_option)","title":"Underlying"},"description":"标的 (如 etf_option)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":30,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/board-summary":{"get":{"tags":["市场全局与交易机制"],"summary":"板块交易汇总数据","description":"获取主要板块/交易所 (上交所、深交所) 的市场交易指标汇总 (如市价总值、平均市盈率等)。","operationId":"get_board_summary_v1_markets_board_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所代码 (如: SSE, SZSE) (可选)","title":"Exchange"},"description":"交易所代码 (如: SSE, SZSE) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指定日期 (YYYY-MM-DD) (可选，默认返回最新数据)","title":"Date"},"description":"指定日期 (YYYY-MM-DD) (可选，默认返回最新数据)"},{"name":"item","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指标项名称 (如: 市价总值, 平均市盈率) (可选)","title":"Item"},"description":"指标项名称 (如: 市价总值, 平均市盈率) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/info":{"get":{"tags":["股票基础与行情"],"summary":"上市公司列表","description":"获取上市公司列表","operationId":"get_stock_list_v1_stocks_info_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"代码/名称/类型关键词 (可选)","title":"Keyword"},"description":"代码/名称/类型关键词 (可选)"},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所过滤 (SSE/SZSE/BSE) (可选)","title":"Exchange"},"description":"交易所过滤 (SSE/SZSE/BSE) (可选)"},{"name":"security_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"证券类型过滤 (可选)","title":"Security Type"},"description":"证券类型过滤 (可选)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/profile":{"get":{"tags":["股票基础与行情","股票基础与行情"],"summary":"股票基本信息 [Pro]","description":"提供单只股票的公司概况与基础信息。","operationId":"get_stock_profile_v1_stocks_profile_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/adjust-factor":{"get":{"tags":["股票基础与行情"],"summary":"股票复权因子 (前复权/后复权)","description":"获取股票复权因子 (前复权/后复权)。\n\n返回股票的每日向前和向后复权因子。","operationId":"get_adjust_factor_v1_stocks_adjust_factor_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":1000,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdjustFactorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/index-constituents":{"get":{"tags":["股票基础与行情"],"summary":"指数成分股 (R19)","description":"获取指数成分股列表 (沪深300/中证500/上证50/中证1000/创业板指/科创50)。","operationId":"get_index_constituents_v1_stocks_index_constituents_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"index_code","in":"query","required":false,"schema":{"type":"string","description":"指数代码 (000300/000905/000016/000852/399006/000688)","default":"000300","title":"Index Code"},"description":"指数代码 (000300/000905/000016/000852/399006/000688)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/daily-basic":{"get":{"tags":["股票基础与行情","股票基础与行情"],"summary":"个股每日综合指标","description":"提供个股每日估值、交易及基础指标。","operationId":"get_daily_master_v1_stocks_daily_basic_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日期 (YYYY-MM-DD) (可选)","title":"Date"},"description":"交易日期 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"sort_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"排序字段 (可选)","title":"Sort By"},"description":"排序字段 (可选)"},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","description":"排序方向 (asc/desc)","default":"desc","title":"Order"},"description":"排序方向 (asc/desc)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/name-history":{"get":{"tags":["股票基础与行情","股票基础与行情"],"summary":"股票历史曾用名","description":"获取股票历史更名记录。","operationId":"get_stock_name_history_v1_stocks_name_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选，不填返回全量)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选，不填返回全量)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockNameHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/ipo":{"get":{"tags":["股票基础与行情","股票基础与行情"],"summary":"IPO新股列表","description":"获取新股发行上市列表，包含发行价、市盈率、募资金额等。","operationId":"get_stock_new_list_v1_stocks_ipo_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IPO日期起 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"IPO日期起 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"IPO日期止 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"IPO日期止 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IPOListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/risk-board":{"get":{"tags":["股票基础与行情","股票基础与行情"],"summary":"风险警示板/ST股票","description":"获取当前处于风险警示板（ST/*ST/SST）的股票列表。","operationId":"get_stock_risk_board_v1_stocks_risk_board_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数 (兼容参数)","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskBoardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/delisted":{"get":{"tags":["股票基础与行情","股票基础与行情"],"summary":"退市股票列表","description":"获取历史退市股票列表（含上交所、深交所、两网及退市整理股）。","operationId":"get_stock_delisted_v1_stocks_delisted_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所过滤 (SSE=上交所, SZSE=深交所, BSE=北交所) (可选)","title":"Exchange"},"description":"交易所过滤 (SSE=上交所, SZSE=深交所, BSE=北交所) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelistedStockResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/esg-rating":{"get":{"tags":["股票基础与行情"],"summary":"股票 ESG 评级","description":"获取股票的 ESG 评级和各项得分 (包括环境、社会、治理以及争议得分)。","operationId":"get_stock_esg_rating_v1_stocks_esg_rating_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"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":{"$ref":"#/components/schemas/ESGRatingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/search":{"get":{"tags":["股票基础与行情"],"summary":"股票搜索","description":"按代码或名称模糊搜索股票。","operationId":"stock_search_v1_stocks_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"搜索关键词 (代码或名称)","title":"Q"},"description":"搜索关键词 (代码或名称)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"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"}}}}}}},"/v1/stocks/screen":{"get":{"tags":["股票基础与行情"],"summary":"多因子选股","description":"按因子排名阈值、行业与自定义权重筛选股票。","operationId":"stock_screen_v1_stocks_screen_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"pe_rank_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"PE 排名上限 (越小越便宜)","title":"Pe Rank Max"},"description":"PE 排名上限 (越小越便宜)"},{"name":"pb_rank_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"PB 排名上限","title":"Pb Rank Max"},"description":"PB 排名上限"},{"name":"roic_rank_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"ROIC 排名下限 (越高越好)","title":"Roic Rank Min"},"description":"ROIC 排名下限 (越高越好)"},{"name":"roe_rank_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"ROE 排名下限","title":"Roe Rank Min"},"description":"ROE 排名下限"},{"name":"momentum_1m_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"1月动量排名下限","title":"Momentum 1M Min"},"description":"1月动量排名下限"},{"name":"momentum_12m_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"12月动量排名下限","title":"Momentum 12M Min"},"description":"12月动量排名下限"},{"name":"beta_rank_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"Beta 排名上限 (越小代表越低风险)","title":"Beta Rank Max"},"description":"Beta 排名上限 (越小代表越低风险)"},{"name":"composite_score_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"综合得分下限","title":"Composite Score Min"},"description":"综合得分下限"},{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"申万一级行业过滤","title":"Industry"},"description":"申万一级行业过滤"},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"排序字段 (如 -composite_score)","title":"Sort"},"description":"排序字段 (如 -composite_score)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"交易日 (默认最新)","title":"Date"},"description":"交易日 (默认最新)"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"返回字段 (默认精简集, '*' 返回全量)","title":"Fields"},"description":"返回字段 (默认精简集, '*' 返回全量)"},{"name":"weights","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"自定义7维权重,逗号分隔: value,quality,momentum,capital,risk,expectation,governance (如: 0.30,0.30,0.15,0.10,0.05,0.05,0.05)","title":"Weights"},"description":"自定义7维权重,逗号分隔: value,quality,momentum,capital,risk,expectation,governance (如: 0.30,0.30,0.15,0.10,0.05,0.05,0.05)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stocks/compare":{"get":{"tags":["股票基础与行情"],"summary":"多股对比","description":"横向对比多只股票的因子得分。","operationId":"stock_compare_v1_stocks_compare_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"逗号分隔的股票代码 (如 sh.600519,sz.000858)","title":"Symbols"},"description":"逗号分隔的股票代码 (如 sh.600519,sz.000858)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"交易日 (默认最新)","title":"Date"},"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":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indices/info":{"get":{"tags":["指数数据"],"summary":"指数列表","description":"获取指数列表","operationId":"get_index_list_v1_indices_info_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"代码/名称关键词 (可选)","title":"Keyword"},"description":"代码/名称关键词 (可选)"},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所过滤 (SSE/SZSE/BSE) (可选)","title":"Exchange"},"description":"交易所过滤 (SSE/SZSE/BSE) (可选)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/indices/history":{"get":{"tags":["指数数据","股票基础与行情"],"summary":"指数历史行情","description":"获取指数历史K线数据","operationId":"get_index_history_v1_indices_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"指数代码 (如: sh.000001, sz.399001)","title":"Symbol"},"description":"指数代码 (如: sh.000001, sz.399001)"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (日线/周线/月线)","default":"daily","title":"Interval"},"description":"K线周期 (日线/周线/月线)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数 (兼容参数)","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bonds/info":{"get":{"tags":["债券数据"],"summary":"债券列表","description":"获取债券列表","operationId":"get_bond_list_v1_bonds_info_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"代码/名称/类型关键词 (可选)","title":"Keyword"},"description":"代码/名称/类型关键词 (可选)"},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所过滤 (SSE/SZSE/BSE) (可选)","title":"Exchange"},"description":"交易所过滤 (SSE/SZSE/BSE) (可选)"},{"name":"security_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"债券类型过滤 (可选)","title":"Security Type"},"description":"债券类型过滤 (可选)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BondListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bonds/detail":{"get":{"tags":["债券数据","股票基础与行情"],"summary":"债券详情","description":"获取可转债详细信息","operationId":"get_bond_detail_v1_bonds_detail_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"证券代码 (可选)","title":"Symbol"},"description":"证券代码 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bonds/history":{"get":{"tags":["债券数据","股票基础与行情"],"summary":"债券历史行情","description":"获取债券历史K线数据","operationId":"get_bond_history_v1_bonds_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"债券代码 (如: sz.123059)","title":"Symbol"},"description":"债券代码 (如: sz.123059)"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (日线/周线/月线)","default":"daily","title":"Interval"},"description":"K线周期 (日线/周线/月线)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数 (兼容参数)","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/cpi":{"get":{"tags":["宏观经济数据"],"summary":"CPI（居民消费价格指数）数据","description":"获取CPI（居民消费价格指数）数据。\n\n返回月度CPI数值、同比增长率和累计值。","operationId":"get_cpi_v1_macro_cpi_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数（默认10年）","default":120,"title":"Limit"},"description":"最大记录数（默认10年）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/ppi":{"get":{"tags":["宏观经济数据"],"summary":"PPI（工业生产者出厂价格指数）数据","description":"获取PPI（工业生产者出厂价格指数）数据。\n\n返回月度PPI数值、同比增长率和累计值。","operationId":"get_ppi_v1_macro_ppi_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/gdp":{"get":{"tags":["宏观经济数据"],"summary":"GDP（国内生产总值）数据","description":"获取GDP（国内生产总值）数据。\n\n返回季度GDP、同比增长率和三次产业分解（第一/第二/第三产业）。","operationId":"get_gdp_v1_macro_gdp_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始季度 (YYYY-MM-DD)","title":"Start Date"},"description":"开始季度 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束季度 (YYYY-MM-DD)","title":"End Date"},"description":"结束季度 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"最大记录数（默认10年）","default":40,"title":"Limit"},"description":"最大记录数（默认10年）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/money-supply":{"get":{"tags":["宏观经济数据"],"summary":"货币供应量（M0/M1/M2）数据","description":"获取货币供应量（M0/M1/M2）数据。\n\n返回月度M0、M1、M2数值及其同比增长率。","operationId":"get_money_supply_v1_macro_money_supply_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/lpr":{"get":{"tags":["宏观经济数据"],"summary":"LPR（贷款市场报价利率）数据","description":"获取LPR（贷款市场报价利率）数据。\n\n返回1年期和5年期LPR利率。","operationId":"get_lpr_v1_macro_lpr_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/pmi":{"get":{"tags":["宏观经济数据"],"summary":"PMI（采购经理指数）数据","description":"获取PMI（采购经理指数）数据。\n\n返回制造业和非制造业PMI。","operationId":"get_pmi_v1_macro_pmi_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/social-finance":{"get":{"tags":["宏观经济数据"],"summary":"社会融资规模数据","description":"获取社会融资规模数据。\n\n返回月度社会融资增量（亿元）。","operationId":"get_social_finance_v1_macro_social_finance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/new-loans":{"get":{"tags":["宏观经济数据"],"summary":"新增人民币贷款数据","description":"获取新增人民币贷款数据。\n\n返回月度新增贷款和累计贷款金额。","operationId":"get_new_loans_v1_macro_new_loans_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/fx-reserves":{"get":{"tags":["宏观经济数据"],"summary":"外汇储备数据","description":"获取外汇储备数据。\n\n返回月度外汇储备（亿美元）和同比增长率。","operationId":"get_fx_reserves_v1_macro_fx_reserves_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/consumer-confidence":{"get":{"tags":["宏观经济数据"],"summary":"消费者信心指数","description":"获取消费者信心指数。","operationId":"get_consumer_confidence_v1_macro_consumer_confidence_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/enterprise-boom":{"get":{"tags":["宏观经济数据"],"summary":"企业景气指数","description":"获取企业景气指数。","operationId":"get_enterprise_boom_v1_macro_enterprise_boom_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/fdi":{"get":{"tags":["宏观经济数据"],"summary":"外国直接投资（FDI）数据","description":"获取外国直接投资（FDI）数据。","operationId":"get_fdi_v1_macro_fdi_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/fixed-investment":{"get":{"tags":["宏观经济数据"],"summary":"固定资产投资数据","description":"获取固定资产投资数据。","operationId":"get_fixed_investment_v1_macro_fixed_investment_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/industrial-production":{"get":{"tags":["宏观经济数据"],"summary":"工业增加值同比增长率","description":"获取工业增加值同比增长率。","operationId":"get_industrial_production_v1_macro_industrial_production_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/new-house-price":{"get":{"tags":["宏观经济数据"],"summary":"新建住宅价格指数","description":"获取新建住宅价格指数。","operationId":"get_new_house_price_v1_macro_new_house_price_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/passenger-load-factor":{"get":{"tags":["宏观经济数据"],"summary":"铁路/民航客座率","description":"获取铁路/民航客座率。","operationId":"get_passenger_load_factor_v1_macro_passenger_load_factor_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/real-estate":{"get":{"tags":["宏观经济数据"],"summary":"房地产景气指数","description":"获取房地产景气指数。","operationId":"get_real_estate_v1_macro_real_estate_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/retail-sales":{"get":{"tags":["宏观经济数据"],"summary":"社会消费品零售总额","description":"获取社会消费品零售总额。","operationId":"get_retail_sales_v1_macro_retail_sales_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/rrr":{"get":{"tags":["宏观经济数据"],"summary":"存款准备金率（RRR）","description":"获取存款准备金率（RRR）。","operationId":"get_rrr_v1_macro_rrr_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/shibor":{"get":{"tags":["宏观经济数据"],"summary":"上海银行间同业拆借利率（Shibor）","description":"获取上海银行间同业拆借利率（Shibor）。","operationId":"get_shibor_v1_macro_shibor_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/society-electricity":{"get":{"tags":["宏观经济数据"],"summary":"全社会用电量","description":"获取全社会用电量。","operationId":"get_society_electricity_v1_macro_society_electricity_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/trade-balance":{"get":{"tags":["宏观经济数据"],"summary":"进出口贸易差额","description":"获取进出口贸易差额。","operationId":"get_trade_balance_v1_macro_trade_balance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/traffic-volume":{"get":{"tags":["宏观经济数据"],"summary":"客货运输量","description":"获取客货运输量。","operationId":"get_traffic_volume_v1_macro_traffic_volume_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/urban-unemployment":{"get":{"tags":["宏观经济数据"],"summary":"城镇失业率","description":"获取城镇失业率。","operationId":"get_urban_unemployment_v1_macro_urban_unemployment_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/deposit-rate":{"get":{"tags":["宏观经济数据"],"summary":"存款基准利率","description":"获取存款基准利率。","operationId":"get_deposit_rate_v1_macro_deposit_rate_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":1,"description":"最大记录数","default":120,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/migration-scale":{"get":{"tags":["宏观经济数据"],"summary":"中国迁徙规模指数（日频）","description":"获取中国迁徙规模指数（日频）。","operationId":"get_migration_scale_v1_macro_migration_scale_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"area","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"区域（城市或省份）","title":"Area"},"description":"区域（城市或省份）"},{"name":"indicator","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"方向（move_in / move_out）","title":"Indicator"},"description":"方向（move_in / move_out）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"最大记录数","default":200,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/migration-area":{"get":{"tags":["宏观经济数据"],"summary":"中国迁徙城市分布明细（日频）","description":"获取中国迁徙城市分布明细（日频）。","operationId":"get_migration_area_v1_macro_migration_area_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"area","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"区域（城市或省份）","title":"Area"},"description":"区域（城市或省份）"},{"name":"indicator","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"方向（move_in / move_out）","title":"Indicator"},"description":"方向（move_in / move_out）"},{"name":"city_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"城市名称","title":"City Name"},"description":"城市名称"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/epu-index":{"get":{"tags":["宏观经济数据"],"summary":"政策不确定性指数（月频）","description":"获取政策不确定性指数（月频）。","operationId":"get_epu_index_v1_macro_epu_index_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"国家/区域","title":"Country"},"description":"国家/区域"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"最大记录数","default":200,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/oil-price-adjustment":{"get":{"tags":["宏观经济数据"],"summary":"中国成品油调价历史","description":"获取中国成品油调价历史。","operationId":"get_oil_price_adjustment_v1_macro_oil_price_adjustment_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"最大记录数","default":200,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/oil-price-region":{"get":{"tags":["宏观经济数据"],"summary":"中国分地区油价明细","description":"获取中国分地区油价明细。","operationId":"get_oil_price_region_v1_macro_oil_price_region_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"province","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"省份","title":"Province"},"description":"省份"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"description":"最大记录数","default":500,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/commodity-daily":{"get":{"tags":["宏观经济数据"],"summary":"国际大宗商品日频数据","description":"获取国际大宗商品日频数据。","operationId":"get_commodity_daily_v1_macro_commodity_daily_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"品种符号（如 XAUUSD / USO）","title":"Symbol"},"description":"品种符号（如 XAUUSD / USO）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/forex-daily":{"get":{"tags":["宏观经济数据"],"summary":"外汇日频数据","description":"获取外汇日频数据。","operationId":"get_forex_daily_v1_macro_forex_daily_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"货币对符号（如 EURUSD）","title":"Symbol"},"description":"货币对符号（如 EURUSD）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/crypto-daily":{"get":{"tags":["宏观经济数据"],"summary":"加密资产日频数据","description":"获取加密资产日频数据。","operationId":"get_crypto_daily_v1_macro_crypto_daily_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"加密资产符号（如 BTCUSD）","title":"Symbol"},"description":"加密资产符号（如 BTCUSD）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/global-index-daily":{"get":{"tags":["宏观经济数据"],"summary":"全球核心指数历史日线","description":"获取全球核心指数历史日线。","operationId":"get_global_index_daily_v1_macro_global_index_daily_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指数符号（如 SP500）","title":"Symbol"},"description":"指数符号（如 SP500）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/global-index-spot":{"get":{"tags":["宏观经济数据"],"summary":"全球指数实时快照每日快照","description":"获取全球指数实时快照每日快照。","operationId":"get_global_index_spot_v1_macro_global_index_spot_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始快照日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始快照日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束快照日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束快照日期 (YYYY-MM-DD)"},{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指数名称","title":"Index Name"},"description":"指数名称"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/fx-spot":{"get":{"tags":["宏观经济数据"],"summary":"外汇即期报价快照每日快照","description":"获取外汇即期报价快照每日快照。","operationId":"get_fx_spot_v1_macro_fx_spot_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始快照日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始快照日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束快照日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束快照日期 (YYYY-MM-DD)"},{"name":"pair_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"货币对名称","title":"Pair Name"},"description":"货币对名称"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/energy-inventory":{"get":{"tags":["宏观经济数据"],"summary":"美国原油库存类宏观指标","description":"获取美国原油库存类宏观指标。","operationId":"get_energy_inventory_v1_macro_energy_inventory_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"indicator","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指标名称","title":"Indicator"},"description":"指标名称"},{"name":"item","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"商品项","title":"Item"},"description":"商品项"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/macro/global-risk-factor":{"get":{"tags":["宏观经济数据"],"summary":"全球风险因子（日频）","description":"获取全球风险因子（日频）。","operationId":"get_global_risk_factor_v1_macro_global_risk_factor_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"factor_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"因子名称","title":"Factor Name"},"description":"因子名称"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"最大记录数","default":300,"title":"Limit"},"description":"最大记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/money-flow/capital-flow":{"get":{"tags":["资金流向"],"summary":"个股资金流向","description":"获取个股资金流向数据，包括主力净流入、超大单/大单/中单/小单净流入等","operationId":"get_capital_flow_v1_money_flow_capital_flow_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (例如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (例如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapitalFlowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/money-flow/north-flow":{"get":{"tags":["资金流向"],"summary":"北向资金","description":"获取北向资金流入流出数据（沪股通+深股通）","operationId":"get_north_flow_v1_money_flow_north_flow_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NorthSouthFlowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/money-flow/south-flow":{"get":{"tags":["资金流向"],"summary":"南向资金","description":"获取南向资金流入流出数据（港股通）","operationId":"get_south_flow_v1_money_flow_south_flow_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NorthSouthFlowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/money-flow/capital-flow-detail":{"get":{"tags":["资金流向"],"summary":"资金流拆解","description":"提供超大单、大单、中单、小单净流入及滚动累计。","operationId":"get_capital_flow_detail_v1_money_flow_capital_flow_detail_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (例如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (例如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":30,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/info":{"get":{"tags":["财务数据"],"summary":"基金列表","description":"获取全量基金/ETF列表数据","operationId":"get_fund_list_v1_funds_info_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"代码/名称/类型关键词 (可选)","title":"Keyword"},"description":"代码/名称/类型关键词 (可选)"},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所过滤 (SSE/SZSE/BSE) (可选)","title":"Exchange"},"description":"交易所过滤 (SSE/SZSE/BSE) (可选)"},{"name":"security_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"基金类型过滤 (可选)","title":"Security Type"},"description":"基金类型过滤 (可选)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/history":{"get":{"tags":["财务数据"],"summary":"基金历史行情","description":"获取基金历史K线数据","operationId":"get_fund_history_v1_funds_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"基金代码 (如: sh.510300)","title":"Symbol"},"description":"基金代码 (如: sh.510300)"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"K线周期 (日线/周线/月线)","default":"daily","title":"Interval"},"description":"K线周期 (日线/周线/月线)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数 (兼容参数)","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/summary":{"get":{"tags":["财务数据"],"summary":"财务摘要汇总","description":"获取上市公司财务指标摘要","operationId":"get_finance_summary_v1_finance_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)","default":20,"title":"Limit"},"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/balance":{"get":{"tags":["财务数据"],"summary":"资产负债表","description":"获取上市公司资产负债表数据","operationId":"get_balance_sheet_v1_finance_balance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)","default":20,"title":"Limit"},"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceSheetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/income":{"get":{"tags":["财务数据"],"summary":"利润表","description":"获取上市公司利润表数据","operationId":"get_income_statement_v1_finance_income_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)","default":20,"title":"Limit"},"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncomeStatementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/cash-flow":{"get":{"tags":["财务数据"],"summary":"现金流量表","description":"获取上市公司现金流量表数据","operationId":"get_cash_flow_v1_finance_cash_flow_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)","default":20,"title":"Limit"},"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CashFlowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/forecast":{"get":{"tags":["财务数据"],"summary":"业绩预告","description":"获取上市公司业绩预告数据","operationId":"get_forecast_v1_finance_forecast_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)","default":100,"title":"Limit"},"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerformanceForecastResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/shares":{"get":{"tags":["财务数据"],"summary":"股本变动","description":"获取上市公司股本变动历史数据","operationId":"get_shares_v1_finance_shares_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharesDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/dividend":{"get":{"tags":["财务数据"],"summary":"分红数据","description":"获取上市公司分红送转历史数据","operationId":"get_dividend_v1_finance_dividend_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sz.000001, sh.600519)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"ex_dividend_start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"除权除息日开始 (YYYY-MM-DD) (可选)","title":"Ex Dividend Start"},"description":"除权除息日开始 (YYYY-MM-DD) (可选)"},{"name":"ex_dividend_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"除权除息日结束 (YYYY-MM-DD) (可选)","title":"Ex Dividend End"},"description":"除权除息日结束 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DividendDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/lifting":{"get":{"tags":["财务数据"],"summary":"限售解禁","description":"获取限售股解禁数据","operationId":"get_lifting_v1_finance_lifting_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiftingDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/core-index":{"get":{"tags":["财务数据"],"summary":"财务核心指标","description":"获取上市公司财务核心指标数据","operationId":"get_finance_core_index_v1_finance_core_index_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选，若指定则精确查询该期财报并忽略 limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)","default":100,"title":"Limit"},"description":"返回条数 (当不指定 date 时，获取最近 N 期数据)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceCoreIndexResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/finance/stock-repurchase":{"get":{"summary":"股票回购","operationId":"get_stock_repurchase_v1_finance_stock_repurchase_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"progress","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Progress"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供上市公司股份回购计划及实施进展。","tags":[]}},"/v1/finance/institute-recommend":{"get":{"summary":"机构评级","operationId":"get_institute_recommend_v1_finance_institute_recommend_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"rating_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供机构评级、目标价及相关研究观点。","tags":[]}},"/v1/finance/restricted-release-summary":{"get":{"summary":"限售解禁汇总","operationId":"get_restricted_release_summary_v1_finance_restricted_release_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供限售股解禁规模及市场汇总数据。","tags":[]}},"/v1/finance/restricted-release-detail":{"get":{"summary":"限售解禁明细","operationId":"get_restricted_release_detail_v1_finance_restricted_release_detail_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"default":300,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供上市公司限售股解禁明细。","tags":[]}},"/v1/finance/restricted-release-queue":{"get":{"summary":"限售解禁批次","operationId":"get_restricted_release_queue_v1_finance_restricted_release_queue_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"default":300,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供限售股分批解禁计划。","tags":[]}},"/v1/finance/restricted-release-stockholder":{"get":{"summary":"限售解禁股东明细","operationId":"get_restricted_release_stockholder_v1_finance_restricted_release_stockholder_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"shareholder_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shareholder Name"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"default":300,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供限售股解禁涉及的股东明细。","tags":[]}},"/v1/finance/ratios":{"get":{"summary":"财务衍生比率","description":"提供 ROE、ROIC、毛利率、EPS、杠杆等衍生财务比率。","operationId":"get_finance_ratios_v1_finance_ratios_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sh.600519)","title":"Symbol"},"description":"股票代码 (如: sh.600519)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"指定日期 (YYYY-MM-DD)","title":"Date"},"description":"指定日期 (YYYY-MM-DD)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":20,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/v1/finance/holder-structure":{"get":{"summary":"股东结构","description":"提供股东户数历史与十大流通股东明细。","operationId":"get_holder_structure_v1_finance_holder_structure_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sh.600519)","title":"Symbol"},"description":"股票代码 (如: sh.600519)"},{"name":"report_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD)","title":"Report Date"},"description":"报告期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"返回期数 (每期含 top10 流通股东)","default":8,"title":"Limit"},"description":"返回期数 (每期含 top10 流通股东)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/v1/finance/research-reports":{"get":{"summary":"研报数据","description":"提供卖方研报标题、机构、评级、目标价及机构调研汇总。","operationId":"get_research_reports_v1_finance_research_reports_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选)","title":"Symbol"},"description":"股票代码 (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":20,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/v1/finance/event-calendar":{"get":{"summary":"事件日历","description":"聚合分红除权、停复牌、限售解禁等公司事件。","operationId":"get_event_calendar_v1_finance_event_calendar_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sh.600519)","title":"Symbol"},"description":"股票代码 (如: sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回事件数","default":50,"title":"Limit"},"description":"返回事件数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/v1/finance/event-confidence":{"get":{"summary":"事件置信度","description":"提供市场事件对个股冲击强度的置信度评分。","operationId":"get_event_confidence_v1_finance_event_confidence_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码 (如: sh.600519)","title":"Symbol"},"description":"股票代码 (如: sh.600519)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":30,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":[]}},"/v1/sectors/concept":{"get":{"tags":["板块与行业数据"],"summary":"概念列表","description":"获取东财概念板块列表","operationId":"get_concept_list_v1_sectors_concept_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConceptListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors/concept/constituents":{"get":{"tags":["板块与行业数据"],"summary":"概念成分股","description":"获取东财概念板块成分股列表","operationId":"get_concept_constituents_v1_sectors_concept_constituents_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"concept_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"概念代码 (可选)","title":"Concept Code"},"description":"概念代码 (可选)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选，查询该股所属概念)","title":"Symbol"},"description":"股票代码 (可选，查询该股所属概念)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConceptConstituentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors/concept-ths":{"get":{"tags":["板块与行业数据"],"summary":"同花顺概念成分股","description":"获取同花顺概念板块成分股列表","operationId":"get_concept_ths_v1_sectors_concept_ths_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"concept_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"概念指数代码 (可选)","title":"Concept Code"},"description":"概念指数代码 (可选)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选)","title":"Symbol"},"description":"股票代码 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConceptConstituentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors/plate":{"get":{"tags":["板块与行业数据"],"summary":"行业板块","description":"获取行业板块列表","operationId":"get_plate_list_v1_sectors_plate_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors/industry-sw":{"get":{"tags":["板块与行业数据"],"summary":"申万行业","description":"获取申万行业分类数据","operationId":"get_industry_sw_v1_sectors_industry_sw_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"industry_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"行业代码 (可选)","title":"Industry Code"},"description":"行业代码 (可选)"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选)","title":"Symbol"},"description":"股票代码 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndustrySWResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors/industry":{"get":{"tags":["板块与行业数据"],"summary":"股票行业分类","description":"获取股票行业分类","operationId":"get_stock_industry_v1_sectors_industry_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码，从 1 开始","default":1,"title":"Page"},"description":"页码，从 1 开始"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"每页条数","default":50,"title":"Page Size"},"description":"每页条数"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"代码/名称/行业关键词 (可选)","title":"Keyword"},"description":"代码/名称/行业关键词 (可选)"},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易所过滤 (SSE/SZSE/BSE) (可选)","title":"Exchange"},"description":"交易所过滤 (SSE/SZSE/BSE) (可选)"},{"name":"industry_classification","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"行业分类过滤 (可选)","title":"Industry Classification"},"description":"行业分类过滤 (可选)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndustryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors/concept-code":{"get":{"tags":["板块与行业数据"],"summary":"概念板块代码","description":"提供概念板块代码与名称映射。","operationId":"get_concept_code_v1_sectors_concept_code_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/hot-stock":{"get":{"tags":["排行榜与人气","排行榜与人气"],"summary":"同花顺热股榜","description":"获取同花顺热门股票排行榜 TOP100","operationId":"get_hot_stock_ths_v1_rankings_hot_stock_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"},{"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":{"$ref":"#/components/schemas/HotStockResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/pop-stock":{"get":{"tags":["排行榜与人气","排行榜与人气"],"summary":"东财人气榜","description":"获取东方财富人气股票排行榜 TOP100","operationId":"get_pop_stock_east_v1_rankings_pop_stock_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"},{"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":{"$ref":"#/components/schemas/PopStockResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/hot-concept":{"get":{"tags":["排行榜与人气","排行榜与人气"],"summary":"热门概念榜","description":"获取同花顺热门概念排行榜 TOP20","operationId":"get_hot_concept_ths_v1_rankings_hot_concept_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"返回条数","default":20,"title":"Limit"},"description":"返回条数"},{"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":{"$ref":"#/components/schemas/HotConceptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/risk-scan":{"get":{"tags":["排行榜与人气","排行榜与人气"],"summary":"股票风险筛查","description":"提供股票风险指标及风险等级筛查结果。","operationId":"get_risk_scan_v1_rankings_risk_scan_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选，不填返回风险排行)","title":"Symbol"},"description":"股票代码 (可选，不填返回风险排行)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"},{"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":{"$ref":"#/components/schemas/RiskScanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/dragon-tiger":{"get":{"tags":["排行榜与人气"],"summary":"龙虎榜","description":"获取龙虎榜上榜记录列表","operationId":"get_dragon_tiger_v1_rankings_dragon_tiger_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码筛选（可选）","title":"Symbol"},"description":"股票代码筛选（可选）"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日期 (YYYY-MM-DD)","title":"Date"},"description":"交易日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DragonTigerResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/zt-pool":{"get":{"tags":["排行榜与人气"],"summary":"涨停股票池","operationId":"get_zt_pool_v1_rankings_zt_pool_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供当日涨停股票列表及行情指标。"}},"/v1/rankings/dt-pool":{"get":{"tags":["排行榜与人气"],"summary":"跌停股票池","operationId":"get_dt_pool_v1_rankings_dt_pool_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供当日跌停股票列表及行情指标。"}},"/v1/rankings/strong-pool":{"get":{"tags":["排行榜与人气"],"summary":"强势股票池","operationId":"get_strong_pool_v1_rankings_strong_pool_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供市场强势股票列表及行情指标。"}},"/v1/rankings/zb-pool":{"get":{"tags":["排行榜与人气"],"summary":"涨停开板股票池","operationId":"get_zb_pool_v1_rankings_zb_pool_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供盘中触及涨停后开板的股票列表。"}},"/v1/rankings/zt-previous":{"get":{"tags":["排行榜与人气"],"summary":"昨日涨停股票池","operationId":"get_zt_previous_v1_rankings_zt_previous_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供上一交易日涨停股票的最新表现。"}},"/v1/rankings/hsgt-hold-rank":{"get":{"tags":["排行榜与人气"],"summary":"沪深港通持股排行","operationId":"get_hsgt_hold_rank_v1_rankings_hsgt_hold_rank_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"}},{"name":"indicator","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indicator"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"提供沪深港通持股规模及变动排名。"}},"/v1/markets/stock/profile":{"get":{"tags":["数据汇总"],"summary":"股票概况汇总数据","description":"获取股票概况汇总数据。","operationId":"get_stock_profile_v1_markets_stock_profile_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数 (兼容参数)","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/finance/growth":{"get":{"tags":["数据汇总"],"summary":"财务增长指标数据","description":"获取财务增长指标数据。","operationId":"get_finance_growth_v1_markets_finance_growth_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/macro/dashboard":{"get":{"tags":["数据汇总"],"summary":"宏观经济仪表盘汇总数据","description":"获取宏观经济仪表盘汇总数据。","operationId":"get_macro_dashboard_v1_markets_macro_dashboard_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"indicators","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"逗号分隔的指标简称 (cpi,gdp,pmi,m2,lpr,...), 默认返回全部","title":"Indicators"},"description":"逗号分隔的指标简称 (cpi,gdp,pmi,m2,lpr,...), 默认返回全部"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"description":"返回条数","default":24,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/hsgt-summary":{"get":{"tags":["数据汇总"],"summary":"沪深港通流向汇总数据","description":"获取沪深港通流向汇总数据。","operationId":"get_hsgt_summary_v1_markets_market_hsgt_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"market_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"市场类型 (可选)","title":"Market Type"},"description":"市场类型 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数","default":30,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/margin-summary":{"get":{"tags":["数据汇总"],"summary":"融资融券汇总数据","description":"获取融资融券汇总数据。","operationId":"get_margin_summary_v1_markets_market_margin_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回条数","default":30,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/finance/forecast-summary":{"get":{"tags":["数据汇总"],"summary":"业绩预告与快报汇总数据","description":"获取业绩预告与快报汇总数据。","operationId":"get_forecast_summary_v1_markets_finance_forecast_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"统计日期 (YYYY-MM-DD) (可选)","title":"Date"},"description":"统计日期 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":20,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/stock/shareholder-activity":{"get":{"tags":["数据汇总"],"summary":"股东活动汇总数据","description":"获取股东活动汇总数据。","operationId":"get_shareholder_activity_v1_markets_stock_shareholder_activity_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 (YYYY-MM-DD) (可选)","title":"Date"},"description":"报告期 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":20,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/stock/pledge-risk":{"get":{"tags":["数据汇总"],"summary":"股票质押风险汇总数据","description":"获取股票质押风险汇总数据。","operationId":"get_pledge_risk_v1_markets_stock_pledge_risk_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/regime":{"get":{"tags":["数据汇总"],"summary":"市场状态汇总（regime）","description":"获取市场状态汇总（regime）。","operationId":"get_market_regime_v1_markets_market_regime_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{"$ref":"#/components/schemas/SummaryObjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/sentiment":{"get":{"tags":["数据汇总"],"summary":"市场情绪汇总（sentiment）","description":"获取市场情绪汇总（sentiment）。","operationId":"get_market_sentiment_v1_markets_market_sentiment_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{"$ref":"#/components/schemas/SummaryObjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/hot-stock-trend":{"get":{"tags":["数据汇总"],"summary":"热股趋势汇总","description":"获取热股趋势汇总。","operationId":"get_hot_stock_trend_v1_markets_market_hot_stock_trend_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/sector/rotation":{"get":{"tags":["数据汇总"],"summary":"板块轮动汇总","description":"获取板块轮动汇总。","operationId":"get_sector_rotation_v1_markets_sector_rotation_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选，不填返回最新)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选，不填返回最新)"},{"name":"sector_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(concept|plate|sw|all)$","description":"板块类型 (concept/plate/sw/all)","default":"all","title":"Sector Type"},"description":"板块类型 (concept/plate/sw/all)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数 (兼容参数)","default":20,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/sector/concept-heat":{"get":{"tags":["数据汇总"],"summary":"概念热度汇总","description":"获取概念热度汇总。","operationId":"get_concept_heat_v1_markets_sector_concept_heat_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"plate_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"板块代码 (可选)","title":"Plate Code"},"description":"板块代码 (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/sector/breadth":{"get":{"tags":["数据汇总"],"summary":"板块广度汇总","description":"获取板块广度汇总。","operationId":"get_sector_breadth_v1_markets_sector_breadth_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选，不填返回最新)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选，不填返回最新)"},{"name":"sector_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(concept|plate|sw|all)$","description":"板块类型 (concept/plate/sw/all)","default":"all","title":"Sector Type"},"description":"板块类型 (concept/plate/sw/all)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数 (兼容参数)","default":20,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/opportunity/watchlist":{"get":{"tags":["数据汇总"],"summary":"机会观察池汇总","description":"获取机会观察池汇总。","operationId":"get_opportunity_watchlist_v1_markets_opportunity_watchlist_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD，可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD，可选)"},{"name":"watch_action","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(observe|candidate|hold_and_validate|replace_target|avoid)$"},{"type":"null"}],"description":"观察动作筛选 (可选)","title":"Watch Action"},"description":"观察动作筛选 (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/risk/invalidation":{"get":{"tags":["数据汇总"],"summary":"风险失效/撤销逻辑汇总","description":"获取风险失效/撤销逻辑汇总。","operationId":"get_risk_invalidation_v1_markets_risk_invalidation_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选)","title":"Symbol"},"description":"股票代码 (可选)"},{"name":"logic_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"逻辑类型 (可选)","title":"Logic Type"},"description":"逻辑类型 (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD，可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD，可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/stock/snapshot":{"get":{"tags":["数据汇总"],"summary":"个股快照汇总","description":"获取个股快照汇总。","operationId":"get_stock_snapshot_v1_markets_stock_snapshot_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"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":{"$ref":"#/components/schemas/SummaryObjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/stock/event-timeline":{"get":{"tags":["数据汇总"],"summary":"个股事件时间线汇总","description":"获取个股事件时间线汇总。","operationId":"get_stock_event_timeline_v1_markets_stock_event_timeline_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Symbol"},"description":"股票代码"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD，可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD，可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD，可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD，可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/finance/analyst-consensus":{"get":{"tags":["数据汇总"],"summary":"分析师一致预期汇总数据","description":"获取分析师一致预期汇总数据。\n\n包含机构评级、目标价、盈利预测等分析师共识数据。","operationId":"get_analyst_consensus_v1_markets_finance_analyst_consensus_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码（可选，不填返回全市场）","title":"Symbol"},"description":"股票代码（可选，不填返回全市场）"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"统计日期 (YYYY-MM-DD，可选)","title":"Date"},"description":"统计日期 (YYYY-MM-DD，可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始统计日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始统计日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束统计日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束统计日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/dragon-tiger-stats":{"get":{"tags":["数据汇总"],"summary":"龙虎榜统计汇总数据","description":"获取龙虎榜统计汇总数据。\n\n包含龙虎榜上榜频次、买卖净额等聚合统计。","operationId":"get_dragon_tiger_stats_v1_markets_market_dragon_tiger_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数","default":30,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market/limit-stats":{"get":{"tags":["数据汇总"],"summary":"涨跌停统计汇总数据","description":"获取涨跌停统计汇总数据。\n\n包含涨停（ZT）/ 跌停（DT）次数、连续天数等统计。","operationId":"get_limit_stats_v1_markets_market_limit_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/bond/profile":{"get":{"tags":["数据汇总"],"summary":"债券综合信息汇总数据","description":"获取债券综合信息汇总数据。\n\n包含可转债溢价率、转股价值、到期收益率等综合指标。","operationId":"get_bond_profile_v1_markets_bond_profile_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"债券代码（可选）","title":"Symbol"},"description":"债券代码（可选）"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":100,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/momentum":{"get":{"tags":["市场统计与广度"],"summary":"盘中动量汇总","description":"获取盘中动量汇总。","operationId":"get_intraday_momentum_v1_markets_momentum_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (可选)","title":"Symbol"},"description":"股票代码 (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD，可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD，可选)"},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},{"type":"null"}],"description":"开始时间片 (HH:MM，可选)","title":"Start Time"},"description":"开始时间片 (HH:MM，可选)"},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},{"type":"null"}],"description":"结束时间片 (HH:MM，可选)","title":"End Time"},"description":"结束时间片 (HH:MM，可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":120,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/sector-pulse":{"get":{"tags":["市场统计与广度"],"summary":"盘中板块脉冲汇总","description":"获取盘中板块脉冲汇总。","operationId":"get_intraday_sector_pulse_v1_markets_sector_pulse_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"sector_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"板块名称 (可选)","title":"Sector Name"},"description":"板块名称 (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD，可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD，可选)"},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},{"type":"null"}],"description":"开始时间片 (HH:MM，可选)","title":"Start Time"},"description":"开始时间片 (HH:MM，可选)"},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},{"type":"null"}],"description":"结束时间片 (HH:MM，可选)","title":"End Time"},"description":"结束时间片 (HH:MM，可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":120,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/market-breadth":{"get":{"tags":["市场统计与广度"],"summary":"盘中市场广度汇总","description":"获取盘中市场广度汇总。","operationId":"get_intraday_market_breadth_v1_markets_market_breadth_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD，可选)","title":"Date"},"description":"交易日 (YYYY-MM-DD，可选)"},{"name":"start_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},{"type":"null"}],"description":"开始时间片 (HH:MM，可选)","title":"Start Time"},"description":"开始时间片 (HH:MM，可选)"},{"name":"end_time","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},{"type":"null"}],"description":"结束时间片 (HH:MM，可选)","title":"End Time"},"description":"结束时间片 (HH:MM，可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数","default":240,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/factors/library":{"get":{"tags":["因子与回测数据"],"summary":"因子库","description":"提供多因子标准化打分库，覆盖估值、质量、动量、资金、风险、预期、治理七维。","operationId":"get_factor_library_v1_factors_library_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选, 不填返回全市场)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选, 不填返回全市场)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"申万一级行业过滤 (可选)","title":"Industry"},"description":"申万一级行业过滤 (可选)"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"返回字段, 逗号分隔 (默认精简集, '*' 返回全量)","title":"Fields"},"description":"返回字段, 逗号分隔 (默认精简集, '*' 返回全量)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":200,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/factors/ranking":{"get":{"tags":["因子与回测数据"],"summary":"因子排名","description":"按指定因子对全市场股票进行横截面排名，支持行业过滤与中性化。","operationId":"get_factor_ranking_v1_factors_ranking_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"factor","in":"query","required":false,"schema":{"type":"string","pattern":"^(capital_score|composite_score|expectation_score|f_capital_main_rank|f_capital_north_rank|f_expectation_revision_rank|f_governance_inst_rank|f_governance_shareholder_rank|f_momentum_12m_rank|f_momentum_1m_rank|f_momentum_3m_rank|f_momentum_6m_rank|f_quality_fcf_growth_rank|f_quality_margin_rank|f_quality_roe_rank|f_quality_roic_rank|f_risk_beta_rank|f_risk_drawdown_rank|f_risk_vol_rank|f_size_ln_cap_rank|f_turnover_rank|f_value_fcf_rank|f_value_pb_rank|f_value_pe_rank|governance_score|momentum_score|quality_score|risk_score|value_score)$","description":"排名依据 (27 项: composite_score, value_score, f_momentum_1m_rank, ...)","default":"composite_score","title":"Factor"},"description":"排名依据 (27 项: composite_score, value_score, f_momentum_1m_rank, ...)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)"},{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"申万一级行业过滤 (可选)","title":"Industry"},"description":"申万一级行业过滤 (可选)"},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回前 N 名","default":50,"title":"Top N"},"description":"返回前 N 名"},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","description":"排序方向: asc (升序) / desc (降序)","default":"desc","title":"Order"},"description":"排序方向: asc (升序) / desc (降序)"},{"name":"neutralize","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(industry)$"},{"type":"null"}],"description":"中性化: 设为 'industry' 进行行业内排名 (扣除行业均值)","title":"Neutralize"},"description":"中性化: 设为 'industry' 进行行业内排名 (扣除行业均值)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/factors/industries":{"get":{"tags":["因子与回测数据"],"summary":"行业列表","description":"提供因子库中所有申万一级行业名称，用于筛选参数发现。","operationId":"get_factor_industries_v1_factors_industries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/factors/performance":{"get":{"tags":["因子与回测数据"],"summary":"因子绩效","description":"提供各因子的 Rank IC 均值、信息比率与胜率统计。","operationId":"get_factor_performance_v1_factors_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"factor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"单因子列名 (不填返回全部)","title":"Factor"},"description":"单因子列名 (不填返回全部)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/factors/backtest-data":{"get":{"tags":["因子与回测数据"],"summary":"回测数据","description":"提供因子回测宽表，含市场数据、标准化因子与前瞻收益。","operationId":"get_backtest_data_v1_factors_backtest_data_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sz.000001, sh.600519) (可选)","title":"Symbol"},"description":"股票代码 (如: sz.000001, sh.600519) (可选)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)","title":"Date"},"description":"交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD) (可选)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD) (可选)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD) (可选)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD) (可选)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryListAsOfResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/futures/index/history":{"get":{"tags":["期货数据"],"summary":"股指期货K线","description":"提供股指期货主力连续日K线 (IF/IC/IM/IH)。","operationId":"get_futures_index_history_v1_futures_index_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":12,"description":"品种代码 (IF/IC/IM/IH)","default":"IF","title":"Symbol"},"description":"品种代码 (IF/IC/IM/IH)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/futures/commodity/history":{"get":{"tags":["期货数据"],"summary":"商品期货K线","description":"提供商品期货主力连续日K线 (RB/SC/AU/CU/AL/M/RM/CF/SR 等)。","operationId":"get_futures_commodity_history_v1_futures_commodity_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"品种代码 (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG)","default":"RB","title":"Symbol"},"description":"品种代码 (RB/SC/AU/CU/AL/M/RM/CF/SR/HC/FU/AG)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数","default":500,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/futures/index/snapshot":{"get":{"tags":["期货数据"],"summary":"股指期货快照","description":"提供指定股指期货品种的最新报价及持仓量。","operationId":"get_futures_index_snapshot_v1_futures_index_snapshot_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":12,"description":"品种代码 (IF/IC/IM/IH)","default":"IF","title":"Symbol"},"description":"品种代码 (IF/IC/IM/IH)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"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"}}}}}}},"/v1/futures/symbols":{"get":{"tags":["期货数据"],"summary":"期货品种列表","description":"提供所有可用期货品种、交易所与中文名称。","operationId":"get_futures_symbols_v1_futures_symbols_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/news/articles":{"get":{"tags":["新闻数据"],"summary":"新闻聚合","description":"提供个股新闻与宏观新闻聚合查询。","operationId":"get_news_articles_v1_news_articles_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码 (如: sh.600519)","title":"Symbol"},"description":"股票代码 (如: sh.600519)"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["company","policy","market"],"type":"string"},{"type":"null"}],"description":"新闻类别 (company/policy/market)","title":"Category"},"description":"新闻类别 (company/policy/market)"},{"name":"news_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["stock","macro"],"type":"string"},{"type":"null"}],"description":"新闻类型 (stock/macro) — 优先于 category","title":"News Type"},"description":"新闻类型 (stock/macro) — 优先于 category"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"开始日期 (YYYY-MM-DD)","title":"Start Date"},"description":"开始日期 (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"结束日期 (YYYY-MM-DD)","title":"End Date"},"description":"结束日期 (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"返回条数","default":50,"title":"Limit"},"description":"返回条数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/markets/chart/storage":{"post":{"summary":"生成K线图表","description":"根据行情数据和技术指标生成可下载的K线图表。","operationId":"create_kline_chart_v1_markets_chart_storage_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KLineRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}],"tags":[]}}},"components":{"schemas":{"AdjustFactor":{"properties":{"symbol":{"type":"string","title":"Symbol","description":"Stock code"},"divid_operate_date":{"type":"string","format":"date","title":"Divid Operate Date","description":"Dividend operate date"},"fore_adjust_factor":{"type":"number","title":"Fore Adjust Factor","description":"Forward adjust factor"},"back_adjust_factor":{"type":"number","title":"Back Adjust Factor","description":"Backward adjust factor"}},"type":"object","required":["symbol","divid_operate_date","fore_adjust_factor","back_adjust_factor"],"title":"AdjustFactor","description":"Adjust factor from stock_adjust_factor."},"AdjustFactorResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/AdjustFactor"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"AdjustFactorResponse","description":"Response for adjust factor endpoint."},"BalanceSheet":{"properties":{"symbol":{"type":"string","title":"Symbol"},"date":{"type":"string","format":"date","title":"Date"},"total_assets":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Assets"},"total_liability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Liability"},"total_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Equity"}},"type":"object","required":["symbol","date"],"title":"BalanceSheet","description":"Balance sheet data."},"BalanceSheetResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/BalanceSheet"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"BalanceSheetResponse","description":"Response for balance sheet endpoint."},"BlockTradeDaily":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"total_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Amount"},"premium_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Premium Amount"},"premium_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Premium Ratio"},"discount_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Discount Amount"},"discount_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Discount Ratio"}},"type":"object","required":["date"],"title":"BlockTradeDaily","description":"Block trade daily summary."},"BlockTradeDailyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/BlockTradeDaily"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"BlockTradeDailyResponse","description":"Response for block-trade-daily endpoint."},"BlockTradeDetail":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"deal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deal Type"},"buyer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer"},"seller":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seller"},"premium_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Premium Rate"}},"type":"object","required":["date"],"title":"BlockTradeDetail","description":"Block trade detail record."},"BlockTradeDetailResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/BlockTradeDetail"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"BlockTradeDetailResponse","description":"Response for block-trade-detail endpoint."},"BoardSummary":{"properties":{"trade_date":{"type":"string","format":"date","title":"Trade Date"},"exchange":{"type":"string","title":"Exchange"},"item":{"type":"string","title":"Item"},"total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total"},"main_board":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Main Board"},"star_board":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Star Board"},"gem_board":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gem Board"}},"type":"object","required":["trade_date","exchange","item"],"title":"BoardSummary","description":"Board-level summary statistics."},"BoardSummaryResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/BoardSummary"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"BoardSummaryResponse","description":"Response for board summary endpoint."},"BondInfo":{"properties":{"bond_code":{"type":"string","title":"Bond Code"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"list_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"List Date"},"delist_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Delist Date"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"type":"object","required":["bond_code"],"title":"BondInfo","description":"Bond info from dwd_bond_list."},"BondListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/BondInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"BondListResponse","description":"Response for bond list endpoint."},"CapitalFlow":{"properties":{"symbol":{"type":"string","title":"Symbol"},"date":{"type":"string","format":"date","title":"Date"},"main_net_inflow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Main Net Inflow"},"main_net_inflow_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Main Net Inflow Pct"},"super_big_net_inflow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Super Big Net Inflow"},"big_net_inflow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Big Net Inflow"},"mid_net_inflow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mid Net Inflow"},"small_net_inflow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Small Net Inflow"}},"type":"object","required":["symbol","date"],"title":"CapitalFlow","description":"Capital flow data for a stock."},"CapitalFlowResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/CapitalFlow"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"CapitalFlowResponse","description":"Response for capital flow endpoint."},"CashFlowResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/CashFlowStatement"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"CashFlowResponse","description":"Response for cash-flow endpoint."},"CashFlowStatement":{"properties":{"symbol":{"type":"string","title":"Symbol"},"date":{"type":"string","format":"date","title":"Date"},"net_operate_cash_flow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Operate Cash Flow"},"net_invest_cash_flow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Invest Cash Flow"},"net_finance_cash_flow":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Finance Cash Flow"}},"type":"object","required":["symbol","date"],"title":"CashFlowStatement","description":"Cash flow statement data."},"Concept":{"properties":{"concept_code":{"type":"string","title":"Concept Code"},"concept_name":{"type":"string","title":"Concept Name"}},"type":"object","required":["concept_code","concept_name"],"title":"Concept","description":"Concept data."},"ConceptConstituent":{"properties":{"concept_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Concept Code"},"concept_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Concept Name"},"symbol":{"type":"string","title":"Symbol"},"stock_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stock Name"}},"type":"object","required":["symbol"],"title":"ConceptConstituent","description":"Concept constituent stock."},"ConceptConstituentResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/ConceptConstituent"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"ConceptConstituentResponse","description":"Response for concept constituent endpoints."},"ConceptListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/Concept"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"ConceptListResponse","description":"Response for concept list endpoint."},"DelistedStockInfo":{"properties":{"symbol":{"type":"string","title":"Symbol"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"list_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"List Date"},"delist_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Delist Date"}},"type":"object","required":["symbol"],"title":"DelistedStockInfo","description":"Delisted stock record."},"DelistedStockResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/DelistedStockInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"DelistedStockResponse","description":"Response for delisted stocks endpoint."},"DividendData":{"properties":{"symbol":{"type":"string","title":"Symbol"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"dividend_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dividend Plan"},"ex_dividend_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Ex Dividend Date"},"dividend_per_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Dividend Per Share"}},"type":"object","required":["symbol"],"title":"DividendData","description":"Dividend data."},"DividendDataResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/DividendData"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"DividendDataResponse","description":"Response for dividend endpoint."},"DragonTiger":{"properties":{"symbol":{"type":"string","title":"Symbol"},"stock_name":{"type":"string","title":"Stock Name"},"date":{"type":"string","format":"date","title":"Date"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"buy_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Buy Amount"},"sell_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sell Amount"},"net_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Amount"}},"type":"object","required":["symbol","stock_name","date"],"title":"DragonTiger","description":"Dragon tiger list data."},"DragonTigerResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/DragonTiger"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"DragonTigerResponse","description":"Response for dragon-tiger endpoint."},"ESGRating":{"properties":{"as_of_date":{"type":"string","format":"date","title":"As Of Date"},"stock_code":{"type":"string","title":"Stock Code"},"stock_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stock Name"},"esg_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Esg Rating"},"esg_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Esg Score"},"env_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Env Score"},"env_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Env Rating"},"social_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Social Score"},"social_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Social Rating"},"governance_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Governance Score"},"governance_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Governance Rating"},"controversy_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Controversy Score"},"controversy_rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Controversy Rating"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"}},"type":"object","required":["as_of_date","stock_code"],"title":"ESGRating","description":"ESG rating details."},"ESGRatingResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/ESGRating"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"ESGRatingResponse","description":"Response for ESG ratings endpoint."},"FinanceCoreIndex":{"properties":{"stock_code":{"type":"string","title":"Stock Code"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"report_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Type"},"notice_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"},{"type":"string"},{"type":"null"}],"title":"Notice Date"},"basic_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Basic Eps"},"diluted_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Diluted Eps"},"roe_wtd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe Wtd"},"gross_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gross Margin"},"net_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Margin"},"curr_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Curr Ratio"},"quick_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quick Ratio"},"asset_liab_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Asset Liab Ratio"}},"type":"object","required":["stock_code"],"title":"FinanceCoreIndex","description":"Finance core index data."},"FinanceCoreIndexResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/FinanceCoreIndex"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"FinanceCoreIndexResponse","description":"Response for finance core-index endpoint."},"FinanceSummary":{"properties":{"symbol":{"type":"string","title":"Symbol"},"date":{"type":"string","format":"date","title":"Date"},"pub_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Pub Date"},"current_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Ratio"},"quick_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quick Ratio"},"cash_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cash Ratio"},"liability_to_asset":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liability To Asset"},"roe_avg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe Avg"},"np_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Np Margin"},"gp_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gp Margin"},"net_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Profit"},"eps_ttm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps Ttm"},"cfo_to_np":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cfo To Np"},"cfo_to_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cfo To Revenue"}},"type":"object","required":["symbol","date"],"title":"FinanceSummary","description":"ADS financial summary data."},"FinanceSummaryResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"type":"string","title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/FinanceSummary"},"type":"array","title":"Data"}},"type":"object","required":["symbol","count","data"],"title":"FinanceSummaryResponse","description":"Response for finance summary endpoint."},"FundInfo":{"properties":{"fund_code":{"type":"string","title":"Fund Code"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"list_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"List Date"},"delist_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Delist Date"},"security_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Type"}},"type":"object","required":["fund_code"],"title":"FundInfo","description":"Fund info from dwd_fund_list."},"FundListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/FundInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"FundListResponse","description":"Response for fund list endpoint."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HotConcept":{"properties":{"concept_name":{"type":"string","title":"Concept Name"},"rank":{"type":"integer","title":"Rank"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"concept_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Concept Code"},"change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change Pct"},"hot_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hot Value"},"hot_tag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hot Tag"},"plate_type":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Plate Type"}},"type":"object","required":["concept_name","rank"],"title":"HotConcept","description":"Hot concept ranking data."},"HotConceptResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"交易日期，不传 trade_date 时为最新可用交易日"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/HotConcept"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"HotConceptResponse","description":"Response for hot-concept endpoint."},"HotStock":{"properties":{"symbol":{"type":"string","title":"Symbol"},"stock_name":{"type":"string","title":"Stock Name"},"rank":{"type":"integer","title":"Rank"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"hot_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hot Value"}},"type":"object","required":["symbol","stock_name","rank"],"title":"HotStock","description":"Hot stock ranking data."},"HotStockResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"交易日期，不传 trade_date 时为最新可用交易日"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/HotStock"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"HotStockResponse","description":"Response for hot-stock endpoint."},"IPOInfo":{"properties":{"symbol":{"type":"string","title":"Symbol"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"ipo_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Ipo Date"},"issue_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Issue Date"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price","description":"Issue price (发行价)"},"pe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pe","description":"Issue P/E ratio (发行市盈率)"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount","description":"Issue shares (万股)"},"market_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Market Amount","description":"Market float (万股)"},"limit_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Limit Amount","description":"Purchase limit per account (万股)"},"funds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Funds","description":"Funds raised (亿元)"}},"type":"object","required":["symbol"],"title":"IPOInfo","description":"IPO / new share listing record."},"IPOListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/IPOInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"IPOListResponse","description":"Response for IPO / new-share list endpoint."},"IncomeStatement":{"properties":{"symbol":{"type":"string","title":"Symbol"},"date":{"type":"string","format":"date","title":"Date"},"total_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Revenue"},"operate_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operate Profit"},"net_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Profit"}},"type":"object","required":["symbol","date"],"title":"IncomeStatement","description":"Income statement data."},"IncomeStatementResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/IncomeStatement"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"IncomeStatementResponse","description":"Response for income statement endpoint."},"IndexInfo":{"properties":{"index_code":{"type":"string","title":"Index Code"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"list_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"List Date"},"delist_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Delist Date"}},"type":"object","required":["index_code"],"title":"IndexInfo","description":"Index info from dwd_index_list."},"IndexListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/IndexInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"IndexListResponse","description":"Response for index list endpoint."},"IndustryInfo":{"properties":{"symbol":{"type":"string","title":"Symbol"},"short_name":{"type":"string","title":"Short Name"},"industry":{"type":"string","title":"Industry"},"industry_classification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry Classification"},"update_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Update Date"}},"type":"object","required":["symbol","short_name","industry"],"title":"IndustryInfo","description":"Industry info from dwd_stock_industry."},"IndustryListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/IndustryInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"IndustryListResponse","description":"Response for industry list endpoint."},"IndustrySW":{"properties":{"industry_code":{"type":"string","title":"Industry Code"},"industry_name":{"type":"string","title":"Industry Name"},"level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Level"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},"type":"object","required":["industry_code","industry_name"],"title":"IndustrySW","description":"SW Industry data."},"IndustrySWResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/IndustrySW"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"IndustrySWResponse","description":"Response for industry-sw endpoint."},"KLineRequest":{"properties":{"symbol":{"type":"string","title":"Symbol"},"interval":{"type":"string","title":"Interval","default":"1d"},"studies":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Studies"},"width":{"type":"integer","title":"Width","default":800},"height":{"type":"integer","title":"Height","default":600},"format":{"type":"string","title":"Format","default":"png"},"theme":{"type":"string","title":"Theme","default":"light"},"from_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Date"},"to_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To Date"}},"type":"object","required":["symbol"],"title":"KLineRequest"},"LiftingData":{"properties":{"symbol":{"type":"string","title":"Symbol"},"lift_date":{"type":"string","format":"date","title":"Lift Date"},"lifting_shares":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lifting Shares"},"lifting_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lifting Ratio"}},"type":"object","required":["symbol","lift_date"],"title":"LiftingData","description":"Share lifting data."},"LiftingDataResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/LiftingData"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"LiftingDataResponse","description":"Response for lifting endpoint."},"MacroDataResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"indicator":{"type":"string","title":"Indicator","description":"Indicator name (cpi, ppi, gdp, etc.)"},"count":{"type":"integer","title":"Count"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"}},"type":"object","required":["indicator","count","data"],"title":"MacroDataResponse","description":"Generic response for macro data endpoints."},"MarginData":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"margin_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Margin Balance","description":"融资余额"},"short_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Short Balance","description":"融券余额"},"margin_short_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Margin Short Balance","description":"融资融券余额"},"margin_short_diff":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Margin Short Diff","description":"融资融券差值"}},"type":"object","required":["date"],"title":"MarginData","description":"Securities margin data (DWD)."},"MarginDataResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/MarginData"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"MarginDataResponse","description":"Response for margin endpoint."},"MarketDataResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"MarketDataResponse","description":"Generic response for market data endpoints."},"NorthSouthFlow":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"market_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Type","description":"north/south"},"sh_net_buy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sh Net Buy","description":"Shanghai net buy"},"sz_net_buy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sz Net Buy","description":"Shenzhen net buy"},"total_net_buy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Net Buy","description":"Total net buy"},"sh_buy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sh Buy","description":"Shanghai buy amount"},"sh_sell":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sh Sell","description":"Shanghai sell amount"},"sz_buy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sz Buy","description":"Shenzhen buy amount"},"sz_sell":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sz Sell","description":"Shenzhen sell amount"},"sh_deal_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sh Deal Amount","description":"Shanghai turnover amount"},"sz_deal_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sz Deal Amount","description":"Shenzhen turnover amount"},"total_deal_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Deal Amount","description":"Total turnover amount"}},"type":"object","required":["date"],"title":"NorthSouthFlow","description":"North/South capital flow data."},"NorthSouthFlowResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/NorthSouthFlow"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"NorthSouthFlowResponse","description":"Response for north/south flow endpoints."},"OptionSnapshot":{"properties":{"as_of_date":{"type":"string","format":"date","title":"As Of Date"},"market":{"type":"string","title":"Market"},"underlying":{"type":"string","title":"Underlying"},"contract_code":{"type":"string","title":"Contract Code"},"contract_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Name"},"last_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Price"},"change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change Pct"},"volume":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume"},"open_interest":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open Interest"},"expire_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Expire Date"},"strike_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Strike Price"},"option_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Option Type"},"contract_unit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Contract Unit"},"exercise_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Exercise Date"},"prev_settlement":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Prev Settlement"}},"type":"object","required":["as_of_date","market","underlying","contract_code"],"title":"OptionSnapshot","description":"Option snapshot details."},"OptionSnapshotResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/OptionSnapshot"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"OptionSnapshotResponse","description":"Response for option snapshot endpoint."},"Pagination":{"properties":{"current_page":{"type":"integer","title":"Current Page"},"page_size":{"type":"integer","title":"Page Size"},"total_items":{"type":"integer","title":"Total Items"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["current_page","page_size","total_items","total_pages"],"title":"Pagination","description":"Pagination metadata for list responses."},"PerformanceForecast":{"properties":{"symbol":{"type":"string","title":"Symbol"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"forecast_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Type"},"forecast_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Category"},"change_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Summary"},"change_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Range"},"last_year_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Year Profit"},"announce_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Announce Date"},"report_period":{"anyOf":[{"type":"string"},{"type":"string","format":"date"},{"type":"null"}],"title":"Report Period"}},"type":"object","required":["symbol"],"title":"PerformanceForecast","description":"Performance forecast data."},"PerformanceForecastResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/PerformanceForecast"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"PerformanceForecastResponse","description":"Response for performance forecast endpoint."},"Plate":{"properties":{"plate_code":{"type":"string","title":"Plate Code"},"plate_name":{"type":"string","title":"Plate Name"},"stock_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stock Count"}},"type":"object","required":["plate_code","plate_name"],"title":"Plate","description":"Industry plate data."},"PlateResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/Plate"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"PlateResponse","description":"Response for plate endpoint."},"PopStock":{"properties":{"symbol":{"type":"string","title":"Symbol"},"stock_name":{"type":"string","title":"Stock Name"},"rank":{"type":"integer","title":"Rank"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change"},"change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change Pct"}},"type":"object","required":["symbol","stock_name","rank"],"title":"PopStock","description":"Popular stock ranking data."},"PopStockResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"交易日期，不传 trade_date 时为最新可用交易日"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/PopStock"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"PopStockResponse","description":"Response for pop-stock endpoint."},"RiskBoardInfo":{"properties":{"symbol":{"type":"string","title":"Symbol"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"latest_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Price","description":"Latest price (最新价)"},"change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change Pct","description":"Change percentage (涨跌幅)"}},"type":"object","required":["symbol"],"title":"RiskBoardInfo","description":"Risk-warning board (ST/风险警示板) stock record."},"RiskBoardResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/RiskBoardInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"RiskBoardResponse","description":"Response for risk board endpoint."},"RiskScan":{"properties":{"symbol":{"type":"string","title":"Symbol"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"f_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"F Type","description":"一级分类"},"s_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"S Type","description":"二级分类"},"t_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"T Type","description":"三级分类"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"扫雷说明"}},"type":"object","required":["symbol"],"title":"RiskScan","description":"Risk scan data from stock_mine_clearance_tdx."},"RiskScanResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"交易日期，不传 trade_date 时为最新可用交易日"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/RiskScan"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"RiskScanResponse","description":"Response for risk-scan endpoint."},"SharesData":{"properties":{"symbol":{"type":"string","title":"Symbol"},"change_date":{"anyOf":[{"type":"string","format":"date"},{"type":"string","format":"date-time"},{"type":"string"}],"title":"Change Date"},"total_shares":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Shares"},"float_shares":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Float Shares"},"restricted_shares":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Restricted Shares"}},"type":"object","required":["symbol","change_date"],"title":"SharesData","description":"Share capital data."},"SharesDataResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"count":{"type":"integer","title":"Count"},"data":{"items":{"$ref":"#/components/schemas/SharesData"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"SharesDataResponse","description":"Response for shares endpoint."},"StockInfo":{"properties":{"symbol":{"type":"string","title":"Symbol"},"short_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Short Name"},"list_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"List Date"},"delist_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Delist Date"},"security_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Type"}},"type":"object","required":["symbol"],"title":"StockInfo","description":"Stock info from dwd_stock_list."},"StockListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/StockInfo"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"StockListResponse","description":"Response for stock list endpoint."},"StockNameHistory":{"properties":{"symbol":{"type":"string","title":"Symbol"},"name":{"type":"string","title":"Name"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"change_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Reason"}},"type":"object","required":["symbol","name"],"title":"StockNameHistory","description":"Historical stock name record (曾用名)."},"StockNameHistoryResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/StockNameHistory"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"StockNameHistoryResponse","description":"Response for stock name history endpoint."},"SummaryListAsOfResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string","format":"date"},{"type":"string"},{"type":"null"}],"title":"As Of"},"count":{"type":"integer","title":"Count"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"SummaryListAsOfResponse","description":"Generic response for list-style summary endpoints with as_of."},"SummaryObjectResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"as_of":{"anyOf":[{"type":"string","format":"date"},{"type":"string"},{"type":"null"}],"title":"As Of"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["data"],"title":"SummaryObjectResponse","description":"Generic response for object-style summary endpoints."},"TradeCalendarEntry":{"properties":{"exchange":{"type":"string","title":"Exchange","description":"Exchange (SSE/SZSE)"},"date":{"type":"string","format":"date","title":"Date","description":"Trade date"},"is_trading_day":{"type":"integer","title":"Is Trading Day","description":"Is trading day (1=yes, 0=no)"}},"type":"object","required":["exchange","date","is_trading_day"],"title":"TradeCalendarEntry","description":"Trade calendar entry from trade_calendar."},"TradeCalendarResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ok"},"count":{"type":"integer","title":"Count"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"null"}]},"data":{"items":{"$ref":"#/components/schemas/TradeCalendarEntry"},"type":"array","title":"Data"}},"type":"object","required":["count","data"],"title":"TradeCalendarResponse","description":"Response for trade calendar endpoint."},"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"}}},"tags":[{"name":"股票基础与行情","description":"股票列表、公司概况、复权因子及每日指标。"},{"name":"指数数据","description":"指数列表及历史行情。"},{"name":"债券数据","description":"债券基础信息及历史行情。"},{"name":"宏观经济数据","description":"中国及全球宏观经济与跨市场指标。"},{"name":"资金流向","description":"个股、沪深港通及市场资金流向。"},{"name":"财务数据","description":"财务报表、公司行为、机构评级及限售解禁数据。"},{"name":"板块与行业数据","description":"概念板块、行业分类及成分证券。"},{"name":"排行榜与人气","description":"市场热度、涨跌停、持股排行及风险筛查。"},{"name":"数据汇总","description":"面向分析场景的综合指标与市场信号。"},{"name":"市场全局与交易机制","description":"市场状态、交易制度及全局性指标。"},{"name":"市场统计与广度","description":"市场宽度、情绪及结构性统计指标。"},{"name":"技术指标","description":"常用趋势、动量、波动率及成交量技术指标。"},{"name":"数据导出","description":"适用于研究、回测及数据分析的批量导出能力。"}],"servers":[{"url":"https://tickerlab.org","description":"Production"}]}