{"openapi":"3.0.1","info":{"title":"Stock API v2 · 开放平台","description":"本页用于普通用户调试开放接口。先在门户申请并复制 Token，再到本页点击 Authorize 填写 `Bearer <Token>` 后发起请求。 文档仅包含开放接口（不含门户与管理端内部接口），响应统一为 JSON（code/message/data/requestId/ts）。","termsOfService":"/legal/terms","contact":{"name":""},"version":"2.0"},"servers":[{"url":"https://stock.xray.top","description":"Generated server url"}],"tags":[{"name":"开放 · 元数据","description":"连通性、只读库健康检查、数据日期边界与覆盖范围。"},{"name":"开放 · 数据质量","description":"区间覆盖、缺口检查与数据完整性排查。"},{"name":"开放 · 行情","description":"证券检索（代码/名称）、交易日历、个股日 K、日快照、板块（行业/概念）与涨停池。"},{"name":"开放 · 批量行情","description":"跨日期、跨板块、跨股票集合的通用批量读取接口。"},{"name":"开放 · 外盘行情","description":"外盘股票/ETF 与商品/期货标的字典。"},{"name":"开放 · 外盘批量行情","description":"外盘股票/ETF 与商品/期货日线批量读取接口。"}],"paths":{"/api/v2/open/meta/ping":{"get":{"tags":["开放 · 元数据"],"summary":"连通性探测（Ping）","description":"校验 Bearer Token 是否有效，并回显 Token 主键、授权 scope 与请求路径。 调试时可在 Knife4j「文档管理 → 全局参数设置」或本页「Authorize」中配置 Authorization。 成功时 HTTP 200，业务 code=0；未授权 401，限流 429。\n\nRequired scope: `market:meta:read`；`market:read` 可作为兼容总读权限访问。","operationId":"ping","parameters":[{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseOpenApiPing（统一响应信封（连通性探测））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:meta:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/health":{"get":{"tags":["开放 · 元数据"],"summary":"只读库健康检查","description":"检查只读连接池是否注入成功，并对 stock 库执行 SELECT 1。\n\nRequired scope: `market:meta:read`；`market:read` 可作为兼容总读权限访问。","operationId":"health","parameters":[{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketHealthDto（统一响应信封（健康检查））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:meta:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/meta/latest-session":{"get":{"tags":["开放 · 元数据"],"summary":"最新可用交易日","description":"返回交易日历与核心行情表的最新交易日，便于调用方识别不同数据集刷新是否同步。\n\nRequired scope: `market:meta:read`；`market:read` 可作为兼容总读权限访问。","operationId":"latestSession","parameters":[{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketLatestSession（统一响应信封（最新可用交易日））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:meta:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/meta/coverage":{"get":{"tags":["开放 · 元数据"],"summary":"数据覆盖范围","description":"返回核心或指定行情数据集的最早/最新日期、去重交易日数和行数。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；本接口不分页。\n\nRequired scope: `market:meta:read`；`market:read` 可作为兼容总读权限访问。","operationId":"coverage","parameters":[{"name":"start","in":"query","description":"统计起始日（可选）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"统计结束日（可选）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"datasets","in":"query","description":"逗号分隔数据集名称；不传则返回核心数据集","required":false,"schema":{"type":"string"},"example":"board_concept_history,zt_pool"},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketCoverageRecordsDto（统一响应信封（数据覆盖范围））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:meta:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/quality/coverage-check":{"get":{"tags":["开放 · 数据质量"],"summary":"区间数据覆盖检查","description":"返回核心行情数据集在指定区间内的交易日覆盖、行数与缺失开市日。 该接口只描述数据事实，不给策略结论。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；本接口不分页。\n\nRequired scope: `market:quality:read`；`market:read` 可作为兼容总读权限访问。","operationId":"coverageCheck","parameters":[{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"boardTypes","in":"query","description":"板块类型：concept、industry 或 concept,industry；不传默认 concept,industry","required":false,"schema":{"type":"string"},"example":"concept,industry"},{"name":"boardCodes","in":"query","description":"逗号分隔板块代码；仅作用于 board_* 数据集","required":false,"schema":{"type":"string"},"example":"BK0420,BK0425"},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketCoverageCheckRecordsDto（统一响应信封（区间数据覆盖检查））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:quality:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/calendar":{"get":{"tags":["开放 · 行情"],"summary":"交易日历","description":"查询闭区间 [start, end] 内每日是否开市（is_open）。不传 start/end，则默认返回当月日历。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；本接口不分页，nextCursor=null、hasMore=false。\n\nRequired scope: `market:calendar:read`；`market:read` 可作为兼容总读权限访问。","operationId":"calendar","parameters":[{"name":"start","in":"query","description":"区间起始日（可选；不传则默认当月）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日（可选；不传则默认当月）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketCalendarRecordsDto（统一响应信封（交易日历列表））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:calendar:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/bars/daily/{symbol}":{"get":{"tags":["开放 · 行情"],"summary":"个股日 K（单券）","description":"等价于 symbols 仅含一个代码的批量日 K。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore。\n\nRequired scope: `market:kline:read`；`market:read` 可作为兼容总读权限访问。","operationId":"barsDailyOne","parameters":[{"name":"symbol","in":"path","description":"证券代码","required":true,"schema":{"type":"string"},"example":"000001"},{"name":"start","in":"query","description":"区间起始","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"adj","in":"query","description":"复权：none / hfq","required":false,"schema":{"type":"string","default":"none"},"example":"none"},{"name":"cursor","in":"query","description":"分页游标","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"fields","in":"query","description":"预留，忽略","required":false,"schema":{"type":"string"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBarsDailyPageDto（统一响应信封（个股日 K 分页））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:kline:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/bars/daily":{"get":{"tags":["开放 · 行情"],"summary":"个股日 K（批量）","description":"symbols 为英文逗号分隔，数量受 stock-api.market.max-symbols-per-request 限制。 adj=none 是不复权数据；adj=hfq 是后复权数据。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:kline:read`；`market:read` 可作为兼容总读权限访问。","operationId":"barsDaily","parameters":[{"name":"symbols","in":"query","description":"标的列表，逗号分隔","required":true,"schema":{"type":"string"},"example":"000001,000002"},{"name":"start","in":"query","description":"K 线区间起始","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"K 线区间结束（闭区间）","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"adj","in":"query","description":"复权：none 不复权；hfq 后复权","required":false,"schema":{"type":"string","default":"none"},"example":"none"},{"name":"cursor","in":"query","description":"分页游标，上一页返回的 nextCursor","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"fields","in":"query","description":"预留字段裁剪，当前版本忽略","required":false,"schema":{"type":"string"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBarsDailyPageDto（统一响应信封（个股日 K 分页））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:kline:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/snapshots/daily/{symbol}":{"get":{"tags":["开放 · 行情"],"summary":"个股日快照（单券）","description":"区间内无数据时返回 404。参数规则：trade_date 与 start/end 二选一。若 trade_date 与 start/end 同时传入，则以 start/end 为准（忽略 trade_date）。 约定：trade_date 默认取最近交易日；若不传任何日期参数，则默认按最近交易日查询；若当天不是交易日则会回退到上一交易日。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:snapshot:read`；`market:read` 可作为兼容总读权限访问。","operationId":"snapshotsDailyOne","parameters":[{"name":"symbol","in":"path","description":"证券代码","required":true,"schema":{"type":"string"},"example":"000001"},{"name":"trade_date","in":"query","description":"单日快照交易日（与 start/end 二选一）。默认最近交易日；若当天不是交易日则为空，建议显式传入。","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"start","in":"query","description":"区间起始（与 trade_date 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束（与 trade_date 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大返回行数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketSnapshotDailyRecordsDto（统一响应信封（日快照））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:snapshot:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/snapshots/daily":{"get":{"tags":["开放 · 行情"],"summary":"个股日快照（批量）","description":"stock_individual_info_daily 主要是标的的基本信息 参数规则：trade_date 与 start/end 二选一。若 trade_date 与 start/end 同时传入，则以 start/end 为准（忽略 trade_date）。 约定：trade_date 默认取最近交易日；若不传任何日期参数，则默认按最近交易日查询；若当天不是交易日则会回退到上一交易日。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:snapshot:read`；`market:read` 可作为兼容总读权限访问。","operationId":"snapshotsDaily","parameters":[{"name":"symbols","in":"query","description":"逗号分隔 symbol 列表","required":true,"schema":{"type":"string"},"example":"000001,000002"},{"name":"trade_date","in":"query","description":"单日快照交易日（与 start/end 二选一）。默认最近交易日；若当天不是交易日则为空，建议显式传入。","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"start","in":"query","description":"区间起始（与 trade_date 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束（与 trade_date 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大返回行数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketSnapshotDailyRecordsDto（统一响应信封（日快照））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:snapshot:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/securities/{symbol}":{"get":{"tags":["开放 · 行情"],"summary":"证券检索（单条）","description":"stock_code_name，按精确 symbol 查询（ 6 位代码）。\n\nRequired scope: `market:security:read`；`market:read` 可作为兼容总读权限访问。","operationId":"securityBySymbol","parameters":[{"name":"symbol","in":"path","description":"证券代码","required":true,"schema":{"type":"string"},"example":"000001"},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketSecurity（统一响应信封（证券主数据））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:security:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/securities":{"get":{"tags":["开放 · 行情"],"summary":"证券检索（分页）","description":"stock_code_name，按 symbol 升序分页；q 对代码或名称做包含匹配，code 只匹配 symbol，name 只匹配名称。显式 code/name 优先于 q。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore。\n\nRequired scope: `market:security:read`；`market:read` 可作为兼容总读权限访问。","operationId":"securities","parameters":[{"name":"q","in":"query","description":"统一关键词，匹配代码或名称中的任意位置；如 31 可命中 000031，银行可命中名称","required":false,"schema":{"type":"string"}},{"name":"code","in":"query","description":"代码关键词，仅匹配 symbol 任意位置；如 31 可命中 000031","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","description":"名称关键词，仅匹配 name 任意位置；如 银行","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor；不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"每页条数；缺省使用服务端 stock-api.market.default-page-limit，上限见 max-page-limit","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketSecuritiesPageDto（统一响应信封（证券分页））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:security:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/pools/limit-up":{"get":{"tags":["开放 · 行情"],"summary":"涨停池","description":"zt_pool涨停池数据。 trade_date 与 start/end 二选一。若 trade_date 与 start/end 同时传入，则以 start/end 为准（忽略 trade_date）。 约定：trade_date 默认取最近交易日；若不传任何日期参数，则默认按最近交易日查询；若当天不是交易日则会回退到上一交易日。 单日按 symbol 升序；区间按 trade_date、symbol 升序。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:pool:read`；`market:read` 可作为兼容总读权限访问。","operationId":"limitUpPool","parameters":[{"name":"trade_date","in":"query","description":"涨停池数据交易日（可选；与 start/end 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"start","in":"query","description":"区间起始（可选；与 trade_date 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束（可选；与 trade_date 二选一）","required":false,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大行数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketLimitUpPoolRecordsDto（统一响应信封（涨停池））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:pool:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/dimensions":{"get":{"tags":["开放 · 行情"],"summary":"板块维度列表","description":"board_dimension，按 boardType、isActive、boardCode 升序返回板块维度字典。 可选按 isActive、boardType 筛选；不传 limit 时默认使用服务端 stock-api.market.default-page-limit（当前默认 100）。 响应 data 为 MarketBoardDimensionRecords，统一包含 items、count、total、totalRelation、nextCursor、hasMore； 分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardDimensions","parameters":[{"name":"isActive","in":"query","description":"是否有效：1=有效，0=无效；不传则不过滤","required":false,"schema":{"type":"integer","format":"int32"},"example":1},{"name":"boardType","in":"query","description":"板块类型/维度类型；不传则不过滤","required":false,"schema":{"type":"string"},"example":"industry"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大行数；不传默认 100，且不超过服务端 max-page-limit","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardDimensionRecordsDto（统一响应信封（板块维度））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/industry":{"get":{"tags":["开放 · 行情"],"summary":"行业板块清单（指定交易日）","description":"board_industry_list，取指定 trade_date 的快照，按 change_percent 降序（涨跌幅从高到低）。 不传 limit 时默认 100；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。 响应 data 为 MarketBoardIndustryListRecords，统一包含 items、count、total、totalRelation、nextCursor、hasMore，其中 items 元素类型为 MarketBoardIndustryListItem；\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardIndustry","parameters":[{"name":"trade_date","in":"query","description":"列表快照对应的交易日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大行数；不传默认 100，且不超过服务端 max-page-limit","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardIndustryListRecordsDto（统一响应信封（行业板块清单））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/concept":{"get":{"tags":["开放 · 行情"],"summary":"概念板块清单（指定交易日）","description":"数据源：board_concept_list。取指定 trade_date 的快照，按 change_percent 降序（涨跌幅从高到低）。 不传 limit 时默认 100；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。 响应 data 为 MarketBoardConceptListRecords，统一包含 items、count、total、totalRelation、nextCursor、hasMore，其中 items 元素类型为 MarketBoardConceptListItem；\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardConcept","parameters":[{"name":"trade_date","in":"query","description":"列表快照交易日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大行数；不传默认 100，且不超过服务端 max-page-limit","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardConceptListRecordsDto（统一响应信封（概念板块清单））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/industry/{board_code}/constituents":{"get":{"tags":["开放 · 行情"],"summary":"行业板块成分股","description":"数据源：board_industry_constituent。取指定 board_code 与 trade_date 的成分股快照。 按 symbol 升序分页；不传 limit 时默认 100；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。 响应 data 为 MarketBoardIndustryConstituentRecords，统一包含 items、count、total、totalRelation、nextCursor、hasMore，其中 items 元素类型为 MarketBoardIndustryConstituent；\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardIndustryConstituents","parameters":[{"name":"board_code","in":"path","description":"行业板块代码","required":true,"schema":{"type":"string"},"example":"BK0420"},{"name":"trade_date","in":"query","description":"成分股快照交易日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大行数；不传默认 100，且不超过服务端 max-page-limit","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardIndustryConstituentRecordsDto（统一响应信封（行业成分股））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/concept/{board_code}/constituents":{"get":{"tags":["开放 · 行情"],"summary":"概念板块成分股","description":"数据源：board_concept_constituent。取指定 board_code 与 trade_date 的成分股快照。 按 symbol 升序分页；不传 limit 时默认 100；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。 响应 data 为 MarketBoardConceptConstituentRecords，统一包含 items、count、total、totalRelation、nextCursor、hasMore，其中 items 元素类型为 MarketBoardConceptConstituent；\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardConceptConstituents","parameters":[{"name":"board_code","in":"path","description":"概念板块代码","required":true,"schema":{"type":"string"},"example":"BK0425"},{"name":"trade_date","in":"query","description":"成分股快照交易日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"最大行数；不传默认 100，且不超过服务端 max-page-limit","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardConceptConstituentRecordsDto（统一响应信封（概念成分股））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/industry/{board_code}/bars/daily":{"get":{"tags":["开放 · 行情"],"summary":"行业板块日 K","description":"board_industry_history。GET 仅使用 Query：start、end、可选 cursor、limit。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardIndustryBars","parameters":[{"name":"board_code","in":"path","description":"行业板块代码","required":true,"schema":{"type":"string"},"example":"BK0420"},{"name":"start","in":"query","description":"K 线起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"K 线结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardBarsDailyPageDto（统一响应信封（板块日 K 分页））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/concept/{board_code}/bars/daily":{"get":{"tags":["开放 · 行情"],"summary":"概念板块日 K","description":"board_concept_history；参数含义与行业板块日 K 相同。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore。\n\nRequired scope: `market:board:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardConceptBars","parameters":[{"name":"board_code","in":"path","description":"概念板块代码","required":true,"schema":{"type":"string"},"example":"BK0425"},{"name":"start","in":"query","description":"K 线起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"K 线结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardBarsDailyPageDto（统一响应信封（板块日 K 分页））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:board:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/bars/daily":{"get":{"tags":["开放 · 批量行情"],"summary":"批量板块日 K","description":"一次读取多个行业/概念板块历史 K。 boardTypes 支持 concept、industry、concept,industry；不传默认两者都查。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:batch:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardBarsDailyBatch","parameters":[{"name":"boardTypes","in":"query","description":"板块类型：concept、industry 或 concept,industry；不传默认 concept,industry","required":false,"schema":{"type":"string"},"example":"concept,industry"},{"name":"boardCodes","in":"query","description":"逗号分隔板块代码；不传表示全部并分页","required":false,"schema":{"type":"string"},"example":"BK0420,BK0425"},{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardBatchBarsDailyPageDto（统一响应信封（批量板块日 K））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:batch:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/constituents":{"get":{"tags":["开放 · 批量行情"],"summary":"批量板块成分股","description":"一次读取多个行业/概念板块、多日成分股快照。 withStockInfo=true 时按证券代码补充 stock_individual_info_daily 原始事实：优先取不晚于成分股交易日的最近快照，若该股票快照起始日晚于成分股交易日则回退到最早快照。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:batch:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardConstituentsBatch","parameters":[{"name":"boardTypes","in":"query","description":"板块类型：concept、industry 或 concept,industry；不传默认 concept,industry","required":false,"schema":{"type":"string"},"example":"concept,industry"},{"name":"boardCodes","in":"query","description":"逗号分隔板块代码；不传表示全部并分页","required":false,"schema":{"type":"string"},"example":"BK0420,BK0425"},{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"withStockInfo","in":"query","description":"是否左连接个股日信息；默认 true","required":false,"schema":{"type":"boolean"},"example":true},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardBatchConstituentPageDto（统一响应信封（批量板块成分股））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:batch:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/boards/symbols":{"get":{"tags":["开放 · 批量行情"],"summary":"板块股票池（去重）","description":"从区间内行业/概念板块成分股提取去重股票代码和名称集合，用于后续批量拉取个股 K 线或可交易事实。 与批量板块成分股不同，本接口只返回去重后的 symbol/name。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:batch:read`；`market:read` 可作为兼容总读权限访问。","operationId":"boardSymbols","parameters":[{"name":"boardTypes","in":"query","description":"板块类型：concept、industry 或 concept,industry；不传默认 concept,industry","required":false,"schema":{"type":"string"},"example":"concept,industry"},{"name":"boardCodes","in":"query","description":"逗号分隔板块代码；不传表示全部","required":false,"schema":{"type":"string"},"example":"BK0420,BK0425"},{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketBoardSymbolRecordsDto（统一响应信封（板块股票池（去重）））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:batch:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/tradeability/facts":{"get":{"tags":["开放 · 批量行情"],"summary":"个股可交易原始事实","description":"返回不复权日 K 与涨停池事实字段，不判断是否可买入。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:batch:read`；`market:read` 可作为兼容总读权限访问。","operationId":"tradeabilityFacts","parameters":[{"name":"symbols","in":"query","description":"逗号分隔证券代码","required":true,"schema":{"type":"string"},"example":"000001,000002"},{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketTradeabilityFactPageDto（统一响应信封（个股可交易原始事实））"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:batch:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/external/instruments":{"get":{"tags":["开放 · 外盘行情"],"summary":"外盘标的/商品列表","description":"聚合 external_market_daily 与 external_commodity_daily，返回可查询的外盘股票/ETF 与商品/期货标的。 assetType 可选 market 或 commodity；不传返回全部。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:external:read`；`market:read` 可作为兼容总读权限访问。","operationId":"externalInstruments","parameters":[{"name":"assetType","in":"query","description":"资产类型：market=外盘股票/ETF，commodity=商品/期货；不传返回全部","required":false,"schema":{"type":"string"},"example":"market"},{"name":"q","in":"query","description":"关键词，匹配代码、原始代码或名称","required":false,"schema":{"type":"string"},"example":"NVDA"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor，不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketExternalInstrumentRecords"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:external:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/external/markets/daily":{"get":{"tags":["开放 · 外盘批量行情"],"summary":"外盘股票/ETF 日 K","description":"external_market_daily，按 sourceTradeDate、ticker、sourceSymbol 升序分页。 tickers 可选，逗号分隔；不传表示全部。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:external:read`；`market:read` 可作为兼容总读权限访问。","operationId":"externalMarketsDaily","parameters":[{"name":"tickers","in":"query","description":"逗号分隔外盘股票/ETF 代码；不传表示全部","required":false,"schema":{"type":"string"},"example":"NVDA,QQQ,SPY"},{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor；不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketExternalMarketDailyPage"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:external:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}},"/api/v2/open/market/external/commodities/daily":{"get":{"tags":["开放 · 外盘批量行情"],"summary":"外盘商品/期货日 K","description":"external_commodity_daily，按 sourceTradeDate、commodity、sourceSymbol 升序分页。 commodities 可选，逗号分隔；不传表示全部。 列表型 data 统一包含 items、count、total、totalRelation、nextCursor、hasMore；分页游标为上一页响应 data.nextCursor；不透明字符串，请原样传回。\n\nRequired scope: `market:external:read`；`market:read` 可作为兼容总读权限访问。","operationId":"externalCommoditiesDaily","parameters":[{"name":"commodities","in":"query","description":"逗号分隔商品代码；不传表示全部","required":false,"schema":{"type":"string"},"example":"gold,copper,wti_oil"},{"name":"start","in":"query","description":"区间起始日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-04-17"},{"name":"end","in":"query","description":"区间结束日","required":true,"schema":{"type":"string","format":"date"},"example":"2026-05-21"},{"name":"cursor","in":"query","description":"分页游标：上一页响应 data.nextCursor；不透明字符串，请原样传回","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"本页最大条数","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"includeTotal","in":"query","description":"是否返回符合当前筛选条件的精确总数；默认 false，开启后可能增加耗时","required":false,"schema":{"type":"boolean","default":false}},{"name":"Authorization","in":"header","description":"默认参数：Bearer stk_","required":false,"schema":{"type":"string","default":"Bearer stk_"}},{"name":"X-Request-Id","in":"header","description":"可选，客户端请求关联 ID。","required":false,"schema":{"type":"string"}},{"name":"X-Client-Name","in":"header","description":"可选，调用方名称或脚本标识。","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"建议 application/json。","required":false,"schema":{"type":"string","default":"application/json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseMarketExternalCommodityDailyPage"}}}}},"security":[{"Authorization":[]}],"x-required-scope":"market:external:read","x-market-read-compatible":true,"x-token-types":["open_user","admin"]}}},"components":{"schemas":{"MarketBarDaily（个股日 K 行（OHLCV））":{"type":"object","properties":{"symbol":{"type":"string","description":"证券代码","example":"000001"},"tradeDate":{"type":"string","description":"交易日","format":"date","example":"2026-04-17"},"open":{"type":"number","description":"开盘价"},"high":{"type":"number","description":"最高价"},"low":{"type":"number","description":"最低价"},"close":{"type":"number","description":"收盘价"},"volume":{"type":"integer","description":"成交量","format":"int64"},"amount":{"type":"number","description":"成交额"},"amplitude":{"type":"number","description":"振幅（%）"},"changePercent":{"type":"number","description":"涨跌幅（%）"},"changeAmount":{"type":"number","description":"涨跌额"},"turnoverRate":{"type":"number","description":"换手率（%）"}},"description":"个股日 K 线（不复权或后复权表字段一致，由 adj 区分来源表）"},"MarketBarsDailyPageDto（个股日 K 分页结果）":{"type":"object","properties":{"adj":{"type":"string","description":"复权方式：none=不复权表 stock_hist_raw_daily；hfq=后复权表 stock_hist_hfq_daily","example":"none"},"items":{"type":"array","description":"K 线数据行，按 trade_date、symbol 升序","items":{"$ref":"#/components/schemas/MarketBarDaily（个股日 K 行（OHLCV））"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","example":"2026-04-10|000001"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"个股日 K 分页结果；区间为闭区间 [start, end]。"},"MarketBoardBarDaily（板块日 K 行）":{"type":"object","properties":{"boardCode":{"type":"string","description":"板块代码","example":"BK0420"},"tradeDate":{"type":"string","description":"交易日","format":"date","example":"2026-04-17"},"open":{"type":"number","description":"开盘价"},"high":{"type":"number","description":"最高价"},"low":{"type":"number","description":"最低价"},"close":{"type":"number","description":"收盘价"},"volume":{"type":"integer","description":"成交量","format":"int64"},"amount":{"type":"number","description":"成交额"},"amplitude":{"type":"number","description":"振幅（%）"},"changePercent":{"type":"number","description":"涨跌幅（%）"},"changeAmount":{"type":"number","description":"涨跌额"},"turnoverRate":{"type":"number","description":"换手率（%）"}},"description":"行业或概念板块指数日 K（board_*_history）"},"MarketBoardBarsDailyPageDto（板块日 K 分页结果）":{"type":"object","properties":{"items":{"type":"array","description":"板块 K 线行","items":{"$ref":"#/components/schemas/MarketBoardBarDaily（板块日 K 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","example":"2026-04-10|BK0420"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"板块日 K 分页；按 trade_date 升序。"},"MarketBoardBatchBarDaily（批量板块日 K 行）":{"type":"object","properties":{"boardType":{"type":"string","description":"板块类型：concept 或 industry","example":"industry"},"boardCode":{"type":"string","description":"板块代码","example":"BK0420"},"tradeDate":{"type":"string","description":"交易日","example":"2026-04-17"},"open":{"type":"number","description":"开盘价"},"high":{"type":"number","description":"最高价"},"low":{"type":"number","description":"最低价"},"close":{"type":"number","description":"收盘价"},"volume":{"type":"integer","description":"成交量","format":"int64"},"amount":{"type":"number","description":"成交额"},"amplitude":{"type":"number","description":"振幅（%）"},"changePercent":{"type":"number","description":"涨跌幅（%）"},"changeAmount":{"type":"number","description":"涨跌额"},"turnoverRate":{"type":"number","description":"换手率（%）"}},"description":"批量板块日 K 行（行业/概念统一结构）"},"MarketBoardBatchBarsDailyPageDto（批量板块日 K 分页结果）":{"type":"object","properties":{"items":{"type":"array","description":"批量板块日 K 数组","items":{"$ref":"#/components/schemas/MarketBoardBatchBarDaily（批量板块日 K 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"批量板块日 K 分页结果"},"MarketBoardBatchConstituentPageDto（批量板块成分股分页结果）":{"type":"object","properties":{"items":{"type":"array","description":"批量板块成分股数组","items":{"$ref":"#/components/schemas/MarketBoardBatchConstituent（批量板块成分股行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"批量板块成分股分页结果"},"MarketBoardBatchConstituent（批量板块成分股行）":{"type":"object","properties":{"boardType":{"type":"string","description":"板块类型：concept 或 industry","example":"industry"},"tradeDate":{"type":"string","description":"交易日","example":"2026-04-17"},"boardCode":{"type":"string","description":"板块代码","example":"BK0420"},"symbol":{"type":"string","description":"证券代码","example":"000089"},"name":{"type":"string","description":"证券简称","example":"深圳机场"},"sequenceNo":{"type":"integer","description":"源表序号/排序号","format":"int32"},"latestPrice":{"type":"number","description":"最新价/收盘价（口径以源表为准）"},"changePercent":{"type":"number","description":"涨跌幅（%）"},"changeAmount":{"type":"number","description":"涨跌额"},"volume":{"type":"integer","description":"成交量","format":"int64"},"amount":{"type":"number","description":"成交额"},"amplitude":{"type":"number","description":"振幅（%）"},"highPrice":{"type":"number","description":"最高价"},"lowPrice":{"type":"number","description":"最低价"},"openPrice":{"type":"number","description":"开盘价"},"prevClose":{"type":"number","description":"昨收/前收"},"turnoverRate":{"type":"number","description":"换手率（%）"},"peDynamic":{"type":"number","description":"动态市盈率"},"pb":{"type":"number","description":"市净率 PB"},"floatMarketValue":{"type":"number","description":"流通市值；仅 withStockInfo=true 时补充"},"totalMarketValue":{"type":"number","description":"总市值；仅 withStockInfo=true 时补充"},"totalShares":{"type":"number","description":"总股本；仅 withStockInfo=true 时补充"},"floatShares":{"type":"number","description":"流通股本；仅 withStockInfo=true 时补充"},"industryName":{"type":"string","description":"所属行业；仅 withStockInfo=true 时补充"},"listingDate":{"type":"string","description":"上市日期；仅 withStockInfo=true 时补充"}},"description":"批量板块成分股快照行（行业/概念统一结构）"},"MarketBoardConceptConstituentRecordsDto（概念板块成分股）":{"type":"object","properties":{"items":{"type":"array","description":"记录数组","items":{"$ref":"#/components/schemas/MarketBoardConceptConstituent（board_concept_constituent 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true,"example":"300999"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"概念板块成分股（board_concept_constituent）记录列表"},"MarketBoardConceptConstituent（board_concept_constituent 行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日（yyyy-MM-dd）","example":"2026-04-17"},"boardCode":{"type":"string","description":"板块代码（如 BK0425）","example":"BK0425"},"symbol":{"type":"string","description":"证券代码","example":"000089"},"name":{"type":"string","description":"证券简称","example":"深圳机场"},"sequenceNo":{"type":"integer","description":"序号（sequence_no；源表口径字段）","format":"int32","example":1},"changePercent":{"type":"number","description":"涨跌幅（%）","example":0.17},"changeAmount":{"type":"number","description":"涨跌额","example":0.01},"latestPrice":{"type":"number","description":"最新价/收盘价（口径以数据源为准）","example":6.84},"amount":{"type":"number","description":"成交额","example":238185772.65},"volume":{"type":"integer","description":"成交量","format":"int64","example":34938},"turnoverRate":{"type":"number","description":"换手率（%）","example":0.17},"amplitude":{"type":"number","description":"振幅（%）（若源表提供）","example":1.02},"highPrice":{"type":"number","description":"最高价（若源表提供）","example":6.86},"lowPrice":{"type":"number","description":"最低价（若源表提供）","example":6.79},"openPrice":{"type":"number","description":"开盘价（若源表提供）","example":6.83},"prevClose":{"type":"number","description":"昨收/前收（prev_close；若源表提供）","example":6.84},"peDynamic":{"type":"number","description":"动态市盈率（若源表提供）","example":22.47},"pb":{"type":"number","description":"市净率 PB（若源表提供）","example":1.21}},"description":"board_concept_constituent 单行（概念板块成分股）。已固定过滤：source、remark、raw_payload、updated_at。"},"MarketBoardConceptListItem（board_concept_list 行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日（yyyy-MM-dd）","example":"2026-04-17"},"boardCode":{"type":"string","description":"板块代码（如 BK0425）","example":"BK0425"},"boardName":{"type":"string","description":"板块名称（如概念中文名）","example":"低空经济"},"rankNo":{"type":"integer","description":"清单内排序/排名（数据源自 rank_no 等，具体口径以库表为准）","format":"int32","example":1},"changePercent":{"type":"number","description":"涨跌幅（%）：可为负；口径以数据源为准","example":4.29},"changeAmount":{"type":"number","description":"涨跌额（可为负；口径以数据源为准）","example":389.87},"turnoverRate":{"type":"number","description":"换手率（%）","example":4.1},"upCount":{"type":"integer","description":"上涨家数（若源表提供）","format":"int32","example":26},"downCount":{"type":"integer","description":"下跌家数（若源表提供）","format":"int32","example":2},"leadingStockName":{"type":"string","description":"领涨/代表性股票简称（若源表提供）","example":"示例股份"},"latestPrice":{"type":"number","description":"最新价/指数点位（口径以数据源为准）","example":9472.74},"totalMarketValue":{"type":"number","description":"总市值（大整数；单位与口径以数据源为准）","example":654326320000}},"description":"board_concept_list 单行。已固定过滤：source、remark、raw_payload、updated_at。"},"MarketBoardConceptListRecordsDto（概念板块清单）":{"type":"object","properties":{"items":{"type":"array","description":"记录数组，按接口排序规则返回","items":{"$ref":"#/components/schemas/MarketBoardConceptListItem（board_concept_list 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true,"example":"1.06|300|BK1574"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"概念板块清单（board_concept_list）记录列表。items 字段与 board_concept_list 业务列对齐，不包含 source、raw_payload、updated_at、remark。"},"MarketBoardDimensionRecordsDto（板块维度记录列表）":{"type":"object","properties":{"items":{"type":"array","description":"记录数组","items":{"$ref":"#/components/schemas/MarketBoardDimension（board_dimension 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true,"example":"industry|1|BK1289"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"board_dimension 记录列表"},"MarketBoardDimension（board_dimension 行）":{"type":"object","properties":{"boardCode":{"type":"string","description":"板块代码","example":"BK0420"},"boardName":{"type":"string","description":"板块名称","example":"航空机场"},"boardType":{"type":"string","description":"板块类型/维度类型（视源表）","example":"industry"},"isActive":{"type":"integer","description":"是否有效（1=有效，0=无效）","format":"int32","example":1},"firstSeenDate":{"type":"string","description":"首次发现日期（yyyy-MM-dd）","example":"2026-04-17"},"lastSeenDate":{"type":"string","description":"最近发现日期（yyyy-MM-dd）","example":"2026-04-17"}},"description":"board_dimension 维度字典行。已固定过滤：source、remark、raw_payload、updated_at。"},"MarketBoardIndustryConstituentRecordsDto（行业板块成分股）":{"type":"object","properties":{"items":{"type":"array","description":"记录数组","items":{"$ref":"#/components/schemas/MarketBoardIndustryConstituent（board_industry_constituent 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true,"example":"300999"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"行业板块成分股（board_industry_constituent）记录列表"},"MarketBoardIndustryConstituent（board_industry_constituent 行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日（yyyy-MM-dd）","example":"2026-04-17"},"boardCode":{"type":"string","description":"板块代码（如 BK0420）","example":"BK0420"},"symbol":{"type":"string","description":"证券代码","example":"000089"},"name":{"type":"string","description":"证券简称","example":"深圳机场"},"sequenceNo":{"type":"integer","description":"序号（sequence_no；源表口径字段）","format":"int32","example":1},"changePercent":{"type":"number","description":"涨跌幅（%）","example":0.17},"changeAmount":{"type":"number","description":"涨跌额","example":0.01},"latestPrice":{"type":"number","description":"最新价/收盘价（口径以数据源为准）","example":6.84},"amount":{"type":"number","description":"成交额","example":238185772.65},"volume":{"type":"integer","description":"成交量","format":"int64","example":34938},"turnoverRate":{"type":"number","description":"换手率（%）","example":0.17},"amplitude":{"type":"number","description":"振幅（%）（若源表提供）","example":1.02},"highPrice":{"type":"number","description":"最高价（若源表提供）","example":6.86},"lowPrice":{"type":"number","description":"最低价（若源表提供）","example":6.79},"openPrice":{"type":"number","description":"开盘价（若源表提供）","example":6.83},"prevClose":{"type":"number","description":"昨收/前收（prev_close；若源表提供）","example":6.84},"peDynamic":{"type":"number","description":"动态市盈率（若源表提供）","example":22.47},"pb":{"type":"number","description":"市净率 PB（若源表提供）","example":1.21}},"description":"board_industry_constituent 单行（行业板块成分股）。已固定过滤：source、remark、raw_payload、updated_at。"},"MarketBoardIndustryListItem（board_industry_list 行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日（yyyy-MM-dd）","example":"2026-04-17"},"boardCode":{"type":"string","description":"板块代码（如 BK0420）","example":"BK0420"},"boardName":{"type":"string","description":"板块名称（如行业中文名）","example":"航空机场"},"rankNo":{"type":"integer","description":"清单内排序/排名（数据源自 rank_no 等，具体口径以库表为准）","format":"int32","example":293},"changePercent":{"type":"number","description":"涨跌幅（%）：可为负；口径以数据源为准","example":-0.27},"changeAmount":{"type":"number","description":"涨跌额（可为负；口径以数据源为准）","example":-12.88},"turnoverRate":{"type":"number","description":"换手率（%）","example":0.72},"upCount":{"type":"integer","description":"上涨家数（若源表提供）","format":"int32","example":3},"downCount":{"type":"integer","description":"下跌家数（若源表提供）","format":"int32","example":8},"leadingStockName":{"type":"string","description":"领涨/代表性股票简称（若源表提供）","example":"中信海直"},"latestPrice":{"type":"number","description":"最新价/指数点位（口径以数据源为准）","example":4711.85},"totalMarketValue":{"type":"number","description":"总市值（大整数；单位与口径以数据源为准）","example":711214032000}},"description":"board_industry_list 单行。已固定过滤：source、remark、raw_payload、updated_at。"},"MarketBoardIndustryListRecordsDto（行业板块清单）":{"type":"object","properties":{"items":{"type":"array","description":"该交易日下行业板块行列表，按 changePercent 降序（涨跌幅从高到低）。 单条结构见「MarketBoardIndustryListItem」模型。","items":{"$ref":"#/components/schemas/MarketBoardIndustryListItem（board_industry_list 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true,"example":"1.06|300|BK1574"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"行业板块清单（board_industry_list）包装：data 内为 items 数组，元素类型为 MarketBoardIndustryListItem。"},"MarketBoardSymbolRecordsDto（板块股票池（去重）记录列表）":{"type":"object","properties":{"items":{"type":"array","description":"去重股票池","items":{"$ref":"#/components/schemas/MarketBoardSymbol（板块股票池（去重）行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"板块股票池（去重）记录列表"},"MarketBoardSymbol（板块股票池（去重）行）":{"type":"object","properties":{"symbol":{"type":"string","description":"证券代码","example":"000089"},"name":{"type":"string","description":"证券简称","nullable":true,"example":"深圳机场"}},"description":"板块成分股去重股票池行"},"MarketCalendarDay（交易日历（日是否开市））":{"type":"object","properties":{"tradeDate":{"type":"string","description":"日历日期","format":"date","example":"2026-04-17"},"open":{"type":"boolean","description":"是否开市（is_open）"}},"description":"trade_calendar 表单日映射"},"MarketCalendarRecordsDto（交易日历记录列表）":{"type":"object","properties":{"items":{"type":"array","description":"当前结果集记录数组","items":{"$ref":"#/components/schemas/MarketCalendarDay（交易日历（日是否开市））"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":10},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；本接口不分页，固定为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页；本接口不分页，固定为 false","example":false}},"description":"交易日历记录列表"},"MarketCoverageCheckItem（区间数据覆盖检查记录）":{"type":"object","properties":{"dataset":{"type":"string","description":"数据集名称","example":"board_concept_history"},"minDate":{"type":"string","description":"最早交易日","nullable":true,"example":"2024-01-02"},"maxDate":{"type":"string","description":"最新交易日","nullable":true,"example":"2026-04-30"},"tradeDays":{"type":"integer","description":"去重交易日数量","format":"int64","example":560},"rowCount":{"type":"integer","description":"行数","format":"int64","example":120000},"expectedOpenDays":{"type":"integer","description":"区间内交易日历开市日数量","format":"int32","example":10},"missingOpenDates":{"type":"array","description":"按交易日历开市日计算的缺失日期；只描述事实缺口，不给策略结论","items":{"type":"string","description":"按交易日历开市日计算的缺失日期；只描述事实缺口，不给策略结论"}}},"description":"单个行情数据集在指定区间内的覆盖检查结果"},"MarketCoverageCheckRecordsDto（区间数据覆盖检查记录列表）":{"type":"object","properties":{"start":{"type":"string","description":"检查区间起始日","example":"2026-04-17"},"end":{"type":"string","description":"检查区间结束日","example":"2026-04-30"},"items":{"type":"array","description":"数据覆盖检查数组","items":{"$ref":"#/components/schemas/MarketCoverageCheckItem（区间数据覆盖检查记录）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":8},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；本接口不分页，固定为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页；本接口不分页，固定为 false","example":false}},"description":"区间数据覆盖检查记录列表"},"MarketCoverageItem（数据覆盖范围记录）":{"type":"object","properties":{"dataset":{"type":"string","description":"数据集名称","example":"board_concept_history"},"minDate":{"type":"string","description":"最早交易日","nullable":true,"example":"2024-01-02"},"maxDate":{"type":"string","description":"最新交易日","nullable":true,"example":"2026-04-30"},"tradeDays":{"type":"integer","description":"去重交易日数量","format":"int64","example":560},"rowCount":{"type":"integer","description":"行数","format":"int64","example":120000}},"description":"单个行情数据集的覆盖范围"},"MarketCoverageRecordsDto（数据覆盖范围记录列表）":{"type":"object","properties":{"items":{"type":"array","description":"数据覆盖范围数组","items":{"$ref":"#/components/schemas/MarketCoverageItem（数据覆盖范围记录）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":8},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；本接口不分页，固定为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页；本接口不分页，固定为 false","example":false}},"description":"数据覆盖范围记录列表"},"MarketExternalCommodityDailyPage":{"type":"object","properties":{"items":{"type":"array","description":"外盘商品/期货日 K 行","items":{"$ref":"#/components/schemas/MarketExternalCommodityDaily（外盘商品/期货日 K 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"外盘商品/期货日 K 分页结果"},"MarketExternalCommodityDaily（外盘商品/期货日 K 行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"来源交易日","example":"2026-05-15"},"commodity":{"type":"string","description":"商品代码","example":"gold"},"displayName":{"type":"string","description":"展示名称","example":"黄金"},"sourceSymbol":{"type":"string","description":"数据源原始代码","example":"XAU"},"barTimeUtc8":{"type":"string","description":"K 线时间（Asia/Shanghai）","example":"2026-05-15 00:00:00"},"sourceMarket":{"type":"string","description":"来源市场","example":"SINA_FOREIGN"},"openPrice":{"type":"number","description":"开盘价","nullable":true,"example":4654.09},"closePrice":{"type":"number","description":"收盘价","example":4562.2},"highPrice":{"type":"number","description":"最高价","nullable":true,"example":4665.2},"lowPrice":{"type":"number","description":"最低价","nullable":true,"example":4511.84},"settlePrice":{"type":"number","description":"结算价","nullable":true},"volume":{"type":"number","description":"成交量","nullable":true},"openInterest":{"type":"number","description":"持仓量","nullable":true},"currency":{"type":"string","description":"币种","nullable":true,"example":"USD"},"unit":{"type":"string","description":"计价单位","nullable":true,"example":"troy_ounce"}},"description":"外盘商品/期货日 K 行"},"MarketExternalInstrumentRecords":{"type":"object","properties":{"items":{"type":"array","description":"外盘标的/商品列表","items":{"$ref":"#/components/schemas/MarketExternalInstrument（外盘标的/商品字典行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"外盘标的/商品字典分页结果"},"MarketExternalInstrument（外盘标的/商品字典行）":{"type":"object","properties":{"assetType":{"type":"string","description":"资产类型：market=外盘股票/ETF，commodity=商品/期货","example":"market"},"code":{"type":"string","description":"查询代码：market 对应 ticker，commodity 对应 commodity","example":"NVDA"},"sourceSymbol":{"type":"string","description":"数据源原始代码","example":"NVDA"},"name":{"type":"string","description":"名称；商品表无名称时返回规范化中文名","nullable":true,"example":"Nvidia"},"sourceMarket":{"type":"string","description":"来源市场","example":"US"},"currency":{"type":"string","description":"币种","nullable":true,"example":"USD"},"unit":{"type":"string","description":"计价单位","nullable":true,"example":"barrel"},"firstTradeDate":{"type":"string","description":"最早交易日","example":"2026-04-01"},"lastTradeDate":{"type":"string","description":"最新交易日","example":"2026-05-14"},"count":{"type":"integer","description":"记录行数","format":"int64","example":31}},"description":"外盘标的/商品字典行"},"MarketExternalMarketDailyPage":{"type":"object","properties":{"items":{"type":"array","description":"外盘股票/ETF 日 K 行","items":{"$ref":"#/components/schemas/MarketExternalMarketDaily（外盘股票/ETF 日 K 行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"外盘股票/ETF 日 K 分页结果"},"MarketExternalMarketDaily（外盘股票/ETF 日 K 行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"来源交易日","example":"2026-05-14"},"ticker":{"type":"string","description":"标的代码","example":"NVDA"},"sourceSymbol":{"type":"string","description":"数据源原始代码","example":"NVDA"},"closeTimeUtc8":{"type":"string","description":"收盘时间（Asia/Shanghai）","example":"2026-05-15 04:00:00"},"name":{"type":"string","description":"名称","nullable":true,"example":"Nvidia"},"sourceMarket":{"type":"string","description":"来源市场","example":"US"},"openPrice":{"type":"number","description":"开盘价","nullable":true,"example":517.86},"closePrice":{"type":"number","description":"收盘价","example":531.35},"highPrice":{"type":"number","description":"最高价","nullable":true,"example":533.12},"lowPrice":{"type":"number","description":"最低价","nullable":true,"example":513.5},"volume":{"type":"number","description":"成交量","nullable":true,"example":12345678},"amount":{"type":"number","description":"成交额","nullable":true}},"description":"外盘股票/ETF 日 K 行"},"MarketHealthDto（只读行情库健康检查结果）":{"type":"object","properties":{"stockReadEnabled":{"type":"boolean","description":"是否已启用并注册只读 JDBC（stock.read.enabled）"},"ok":{"type":"boolean","description":"SELECT 1 是否执行成功"},"latencyMs":{"type":"integer","description":"探测耗时（毫秒）","format":"int64"},"message":{"type":"string","description":"人类可读说明；失败时含异常类型等简要信息"}},"description":"只读 stock 库连通性探测结果"},"MarketLatestSession（最新可用交易日）":{"type":"object","properties":{"latestOpenDate":{"type":"string","description":"交易日历中不晚于当前日期的最新开市日","nullable":true,"example":"2026-04-30"},"latestConceptListDate":{"type":"string","description":"概念板块清单最新交易日","nullable":true,"example":"2026-04-30"},"latestIndustryListDate":{"type":"string","description":"行业板块清单最新交易日","nullable":true,"example":"2026-04-30"},"latestConceptHistoryDate":{"type":"string","description":"概念板块日 K 最新交易日","nullable":true,"example":"2026-04-30"},"latestIndustryHistoryDate":{"type":"string","description":"行业板块日 K 最新交易日","nullable":true,"example":"2026-04-30"},"latestConceptConstituentDate":{"type":"string","description":"概念板块成分股最新交易日","nullable":true,"example":"2026-04-30"},"latestIndustryConstituentDate":{"type":"string","description":"行业板块成分股最新交易日","nullable":true,"example":"2026-04-30"},"latestStockRawDate":{"type":"string","description":"个股不复权日 K 最新交易日","nullable":true,"example":"2026-04-30"},"latestStockHfqDate":{"type":"string","description":"个股后复权日 K 最新交易日","nullable":true,"example":"2026-04-30"},"latestStockInfoDate":{"type":"string","description":"个股日快照最新交易日","nullable":true,"example":"2026-04-30"},"latestLimitUpPoolDate":{"type":"string","description":"涨停池最新交易日","nullable":true,"example":"2026-04-30"},"latestExternalMarketDate":{"type":"string","description":"外盘市场日 K 最新交易日","nullable":true,"example":"2026-05-14"},"latestExternalCommodityDate":{"type":"string","description":"外盘商品日 K 最新交易日","nullable":true,"example":"2026-05-14"}},"description":"核心行情数据集的最新可用交易日"},"MarketLimitUpPoolDto（涨停池记录（单条））":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日（yyyy-MM-dd）","example":"2026-04-24"},"symbol":{"type":"string","description":"证券代码","example":"000001"},"name":{"type":"string","description":"证券简称"},"changePercent":{"type":"number","description":"涨跌幅（%）"},"latestPrice":{"type":"number","description":"最新价/收盘价（快照口径）"},"amount":{"type":"number","description":"成交额"},"limitUpFund":{"type":"number","description":"涨停封单资金（常用口径字段）"},"firstLimitUpTime":{"type":"string","description":"首次涨停时间（HH:mm:ss 或原始字段格式）"},"lastLimitUpTime":{"type":"string","description":"最后涨停时间（HH:mm:ss 或原始字段格式）"},"limitUpStatistics":{"type":"string","description":"涨停统计（例如 3/7，代表涨停次数/炸板次数等，具体口径以数据源为准）"},"consecutiveLimitUpDays":{"type":"integer","description":"连板天数（若数据源提供）","format":"int32"},"industryName":{"type":"string","description":"行业名称（若数据源提供）"}},"description":"涨停池记录（常用字段子集）"},"MarketLimitUpPoolRecordsDto（涨停池记录列表（items 包装））":{"type":"object","properties":{"items":{"type":"array","description":"记录数组（字段含义见 MarketLimitUpPoolDto）","items":{"$ref":"#/components/schemas/MarketLimitUpPoolDto（涨停池记录（单条））"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"涨停池记录列表（items 包装）"},"MarketSecuritiesPageDto（证券主数据分页结果）":{"type":"object","properties":{"items":{"type":"array","description":"当前页证券列表","items":{"$ref":"#/components/schemas/MarketSecurity（证券主数据（代码/名称））"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","example":"000004"},"hasMore":{"type":"boolean","description":"是否还有下一页","example":true}},"description":"证券主数据分页；按 symbol 升序。"},"MarketSecurity（证券主数据（代码/名称））":{"type":"object","properties":{"symbol":{"type":"string","description":"证券代码，形态以库内 stock_code_name.symbol 为准（常见为 6 位数字）","example":"000001"},"name":{"type":"string","description":"证券简称"}},"description":"证券主数据对外视图（仅代码与名称；不含内部 source、raw_payload、updated_at）。"},"MarketSnapshotDailyDto（个股日快照（单条记录））":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日（yyyy-MM-dd）","example":"2026-04-24"},"symbol":{"type":"string","description":"证券代码","example":"000001"},"name":{"type":"string","description":"证券简称","example":"平安银行"},"latestPrice":{"type":"number","description":"最新价/收盘价（快照口径）"},"totalMarketValue":{"type":"number","description":"总市值"},"floatMarketValue":{"type":"number","description":"流通市值"},"totalShares":{"type":"number","description":"总股本"},"floatShares":{"type":"number","description":"流通股本"},"industryName":{"type":"string","description":"行业名称"},"listingDate":{"type":"string","description":"上市日期（yyyy-MM-dd）"}},"description":"个股日快照（常用字段子集）"},"MarketSnapshotDailyRecordsDto（个股日快照（items 包装））":{"type":"object","properties":{"items":{"type":"array","description":"记录数组（字段含义见 MarketSnapshotDailyDto）","items":{"$ref":"#/components/schemas/MarketSnapshotDailyDto（个股日快照（单条记录））"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":20},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"个股日快照记录列表（items 包装）"},"MarketTradeabilityFactPageDto（个股可交易原始事实分页结果）":{"type":"object","properties":{"items":{"type":"array","description":"可交易原始事实数组","items":{"$ref":"#/components/schemas/MarketTradeabilityFact（个股可交易原始事实行）"}},"count":{"type":"integer","description":"本次返回行数，即 items.length","format":"int32","example":100},"total":{"type":"integer","description":"符合当前筛选条件的总行数；默认不计算为 null，includeTotal=true 时返回精确总数","format":"int64","nullable":true,"example":5277},"totalRelation":{"type":"string","description":"分页总数口径：unknown=未计算，exact=精确总数，estimated=估算总数","example":"unknown","enum":["unknown","exact","estimated"]},"nextCursor":{"type":"string","description":"下一页游标；不透明字符串，请原样传回；无下一页时为 null","nullable":true},"hasMore":{"type":"boolean","description":"是否还有下一页","example":false}},"description":"个股可交易原始事实分页结果"},"MarketTradeabilityFact（个股可交易原始事实行）":{"type":"object","properties":{"tradeDate":{"type":"string","description":"交易日","example":"2026-04-17"},"symbol":{"type":"string","description":"证券代码","example":"000001"},"name":{"type":"string","description":"证券简称；优先来自涨停池，可能为空","nullable":true,"example":"平安银行"},"open":{"type":"number","description":"不复权开盘价"},"high":{"type":"number","description":"不复权最高价"},"low":{"type":"number","description":"不复权最低价"},"close":{"type":"number","description":"不复权收盘价"},"volume":{"type":"integer","description":"成交量","format":"int64"},"amount":{"type":"number","description":"成交额"},"amplitude":{"type":"number","description":"振幅（%）"},"changePercent":{"type":"number","description":"涨跌幅（%）"},"changeAmount":{"type":"number","description":"涨跌额"},"turnoverRate":{"type":"number","description":"换手率（%）"},"firstLimitUpTime":{"type":"string","description":"首次封板时间；来自涨停池，可能为空"},"lastLimitUpTime":{"type":"string","description":"最后封板时间；来自涨停池，可能为空"},"breakLimitUpCount":{"type":"integer","description":"炸板次数；来自涨停池，可能为空","format":"int32"},"consecutiveLimitUpDays":{"type":"integer","description":"连续涨停天数；来自涨停池，可能为空","format":"int32"},"limitUpFund":{"type":"number","description":"封板资金；来自涨停池，可能为空"},"limitUpStatistics":{"type":"string","description":"涨停统计原始描述；来自涨停池，可能为空"}},"description":"个股可交易原始事实行，不给可买入判断"},"OpenApiPing（开放平台连通性探测结果）":{"type":"object","properties":{"message":{"type":"string","description":"连通性提示信息","example":"open api reachable"},"tokenId":{"type":"integer","description":"当前 Bearer Token 对应的内部 Token 主键","format":"int64","example":3},"scope":{"type":"string","description":"当前 Token 授权 scope","example":"market:read"},"path":{"type":"string","description":"本次请求路径","example":"/api/v2/open/meta/ping"}},"description":"开放平台连通性探测结果。"},"ApiResponseMarketBarsDailyPageDto（统一响应信封（个股日 K 分页））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBarsDailyPageDto（个股日 K 分页结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardBarsDailyPageDto（统一响应信封（板块日 K 分页））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardBarsDailyPageDto（板块日 K 分页结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardBatchBarsDailyPageDto（统一响应信封（批量板块日 K））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardBatchBarsDailyPageDto（批量板块日 K 分页结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardBatchConstituentPageDto（统一响应信封（批量板块成分股））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardBatchConstituentPageDto（批量板块成分股分页结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardConceptConstituentRecordsDto（统一响应信封（概念成分股））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardConceptConstituentRecordsDto（概念板块成分股）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardConceptListRecordsDto（统一响应信封（概念板块清单））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardConceptListRecordsDto（概念板块清单）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardDimensionRecordsDto（统一响应信封（板块维度））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardDimensionRecordsDto（板块维度记录列表）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardIndustryConstituentRecordsDto（统一响应信封（行业成分股））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardIndustryConstituentRecordsDto（行业板块成分股）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardIndustryListRecordsDto（统一响应信封（行业板块清单））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardIndustryListRecordsDto（行业板块清单）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketBoardSymbolRecordsDto（统一响应信封（板块股票池（去重）））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketBoardSymbolRecordsDto（板块股票池（去重）记录列表）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketCalendarRecordsDto（统一响应信封（交易日历列表））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketCalendarRecordsDto（交易日历记录列表）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketCoverageCheckRecordsDto（统一响应信封（区间数据覆盖检查））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketCoverageCheckRecordsDto（区间数据覆盖检查记录列表）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketCoverageRecordsDto（统一响应信封（数据覆盖范围））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketCoverageRecordsDto（数据覆盖范围记录列表）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketExternalCommodityDailyPage":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketExternalCommodityDailyPage"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketExternalInstrumentRecords":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketExternalInstrumentRecords"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketExternalMarketDailyPage":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketExternalMarketDailyPage"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketHealthDto（统一响应信封（健康检查））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketHealthDto（只读行情库健康检查结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketLatestSession（统一响应信封（最新可用交易日））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketLatestSession（最新可用交易日）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketLimitUpPoolRecordsDto（统一响应信封（涨停池））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketLimitUpPoolRecordsDto（涨停池记录列表（items 包装））"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketSecuritiesPageDto（统一响应信封（证券分页））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketSecuritiesPageDto（证券主数据分页结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketSecurity（统一响应信封（证券主数据））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketSecurity（证券主数据（代码/名称））"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketSnapshotDailyRecordsDto（统一响应信封（日快照））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketSnapshotDailyRecordsDto（个股日快照（items 包装））"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseMarketTradeabilityFactPageDto（统一响应信封（个股可交易原始事实））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/MarketTradeabilityFactPageDto（个股可交易原始事实分页结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}},"ApiResponseOpenApiPing（统一响应信封（连通性探测））":{"type":"object","properties":{"code":{"type":"integer","description":"业务错误码（0=成功，非0=失败）","format":"int32","example":0},"message":{"type":"string","description":"提示信息（成功通常为 success；失败为错误提示）","example":"success"},"data":{"$ref":"#/components/schemas/OpenApiPing（开放平台连通性探测结果）"},"requestId":{"type":"string","description":"请求追踪 ID（用于定位日志与排障）","example":"req_xxx"},"ts":{"type":"string","description":"服务端响应时间（Asia/Shanghai）","format":"date-time"}}}},"securitySchemes":{"Authorization":{"type":"http","description":"默认参数：`Bearer stk_`（后续拼接完整 Token 明文）","scheme":"bearer","bearerFormat":"API Token"}}},"x-openapi":{"x-setting":{"customCode":200,"language":"zh-CN","enableSwaggerModels":true,"swaggerModelName":"Swagger Models","enableReloadCacheParameter":false,"enableAfterScript":true,"enableDocumentManage":true,"enableVersion":false,"enableRequestCache":true,"enableFilterMultipartApis":false,"enableFilterMultipartApiMethodType":"POST","enableHost":false,"enableHostText":"","enableDynamicParameter":false,"enableDebug":true,"enableFooter":true,"enableFooterCustom":false,"enableSearch":true,"enableOpenApi":true,"enableHomeCustom":false,"homeCustomLocation":"# Stock API v2 · 开放接口使用说明（普通用户）\n\n使用顺序（建议严格按步骤）：\n\n1. 先到首页注册并完成 TOTP 绑定。\n2. 登录门户后申请 Token，审核通过后复制明文 Token。\n3. 回到本页点击 **Authorize**，输入：`Bearer 你的Token`。\n4. 先调用 `GET /api/v2/open/meta/ping`，确认 `code=0`。\n5. 再调用行情接口（如 `GET /api/v2/open/market/securities`）。\n\n重要说明：\n\n- 本文档仅开放接口：`/api/v2/open/market/**`、`/api/v2/open/meta/**`\n- 统一鉴权头：`Authorization`\n- 统一响应：`code / message / data / requestId / ts`\n- 使用前请阅读用户协议：`/legal/terms`\n","enableGroup":true,"enableResponseCode":true},"x-markdownFiles":[]}}