{ "openapi": "3.1.0", "info": { "title": "同花顺金融数据 API", "version": "1.0.0", "description": "由前端 REST 文档生成；当前前端文档为有效契约。" }, "servers": [ { "url": "https://fuyao.aicubes.cn" } ], "tags": [ { "name": "交易日历", "description": "A 股近一年交易日序列" }, { "name": "除复权", "description": "A 股复权因子事件流（分红 / 送股 / 配股）" }, { "name": "龙虎榜数据", "description": "A 股龙虎榜榜单，覆盖全部、机构榜与游资榜" }, { "name": "财务指标数据", "description": "A 股财务指标数据，一次返回成长、盈利、偿债、营运、现金流五类指标" }, { "name": "基金公司详情", "description": "按基金公司 ID 查询公司名称、类型、成立日期、基金数量与规模" }, { "name": "基金分红记录", "description": "查询单只基金的历史分红与权益登记日期" }, { "name": "基金诊断详情", "description": "查询基金诊断维度、同类对比、概率区间与韧性指标" }, { "name": "基金重仓持仓", "description": "查询基金定期披露的股票、债券与基金持仓及汇总指标" }, { "name": "基金资讯列表", "description": "查询单只基金的资讯文章并使用游标分页" }, { "name": "基金募集列表", "description": "查询当前募集或即将募集的新发基金" }, { "name": "基金基本资料", "description": "查询基金名称、规模、净值、管理人与基金经理等基本资料" }, { "name": "标的列表获取", "description": "按资产类型分页获取 A 股、指数与基金代码表" }, { "name": "标的检索", "description": "按 thscode / ticker / 名称检索 A 股、指数与基金标的" }, { "name": "估值数据", "description": "A 股多股票最新估值快照，固定返回市盈率 TTM/MRQ、市净率 MRQ、市销率 TTM 和市现率 TTM 五个估值指标" }, { "name": "指数数据", "description": "同花顺指数 / 板块的列表、成分股、行情快照与历史 K 线" }, { "name": "个股异动原因", "description": "A 股个股异动原因列表与按股票查询能力" }, { "name": "集合竞价数据", "description": "查询 A 股集合竞价快照与短线风向标竞价基准" }, { "name": "财务报表", "description": "A 股整体合并利润表 / 资产负债表 / 现金流量表多期序列" }, { "name": "基金财务数据", "description": "查询基金财务指标、利润表与资产负债表" }, { "name": "基金持有人数据", "description": "查询基金持有人结构与前十大持有人" }, { "name": "基金经理数据", "description": "查询基金经理投资风格、业绩、从业经历与详情" }, { "name": "基金行情数据", "description": "查询场内基金行情快照与场内基金历史日线行情" }, { "name": "基金业绩与回撤", "description": "查询基金净值、区间收益、净值波动、趋势强弱、估值百分位与最大回撤" }, { "name": "基金持仓与资产配置", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置" }, { "name": "同花顺热榜", "description": "A 股热度榜单、历史热股排行与个股排名走势" }, { "name": "涨跌停与炸板数据", "description": "A 股涨停、跌停、炸板股票池与连板天梯" }, { "name": "股票行情数据", "description": "A 股行情快照与历史 K 线接口" } ], "paths": { "/api/a-share/calendar/trading-days": { "get": { "tags": [ "交易日历" ], "summary": "交易日历", "description": "A 股近一年交易日序列，固定窗口为 [今日 - 1 年, 今日]（Asia/Shanghai 自然日），无任何请求参数。", "operationId": "get_a_share_calendar_trading_days", "parameters": [], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1748102400000, "item": [ { "date_ms": 1716566400000, "date": "20250525" }, { "date_ms": 1716652800000, "date": "20250526" }, { "date_ms": 1716739200000, "date": "20250527" } ] } } } } } }, "externalDocs": { "description": "查看交易日历接口文档", "url": "/docs/api-reference/calendar" } } }, "/api/a-share/corporate-actions/adjustment-factors": { "get": { "tags": [ "除复权" ], "summary": "除复权", "description": "获取单只标的的 A 股复权因子事件流。每次请求仅一个 thscode。", "operationId": "get_a_share_corporate_actions_adjustment_factors", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只标的 thscode，不接受逗号。", "example": "600519.SH" }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "事件起始日，格式 YYYY-MM-DD。" }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" }, "description": "事件截止日，格式 YYYY-MM-DD。" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "558c1d59d2e548149fb27b83eca5016a", "data": { "thscode": "600519.SH", "ticker": "600519", "item": [ { "ticker": "600519", "ex_date_ms": 1766073600000, "dividend_per_share": 23.957, "per_share_bonus": 0 }, { "ticker": "600519", "ex_date_ms": 1437062400000, "dividend_per_share": 4.374, "per_share_bonus": 0.1 } ] } } } } } }, "externalDocs": { "description": "查看除复权接口文档", "url": "/docs/api-reference/corporate-actions" } } }, "/api/a-share/special-data/dragon-tiger-list": { "get": { "tags": [ "龙虎榜数据" ], "summary": "龙虎榜数据", "description": "按交易日返回龙虎榜首页整体榜单。省略 date 时，若今天是交易日则默认取上一个交易日；若今天不是交易日，则默认取今天之前最近一个交易日。 显式传入非交易日会返回参数错误，不自动回退。", "operationId": "get_a_share_special_data_dragon_tiger_list", "parameters": [ { "name": "board_type", "in": "query", "required": false, "schema": { "type": "string", "default": "all", "enum": [ "all", "org", "hot_money" ] }, "description": "榜单类型：all 全部 / org 机构榜 / hot_money 游资榜。" }, { "name": "date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "目标交易日，格式 yyyy-MM-dd；只支持一年内数据。显式传入非交易日返回 code=1002。" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1782921600000, "board_type": "all", "trade_date": "2026-07-01", "count": 80, "stock_count": 75, "stock_items": [ { "thscode": "002407.SZ", "ticker": "002407", "name": "多氟多", "change": 0.09994, "net_value": 1786253128.23, "net_rate": 0.11901893, "hot_rank": 2, "buy_value": 2674755016.05, "sell_value": 888501887.82, "limit_reason": "半导体级氢氟酸涨价+六氟磷酸锂+大圆柱电池", "range_days": 3 } ], "hot_money_items": [] } } } } } }, "externalDocs": { "description": "查看龙虎榜数据接口文档", "url": "/docs/api-reference/dragon-tiger-data" } } }, "/api/a-share/financials/indicators": { "get": { "tags": [ "财务指标数据" ], "summary": "财务指标数据", "description": "GET /api/a-share/financials/indicators", "operationId": "get_a_share_financials_indicators", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只标的 thscode，含交易所后缀，如 300033.SZ。", "example": "300033.SZ" }, { "name": "report", "in": "query", "required": true, "schema": { "type": "string" }, "description": "报告期，示例 2025-1；格式见上方通用约定。", "example": "2025-1" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "thscode": "300033.SZ", "report": "2025-1", "abilities": [ { "ability": "growth", "indicators": [ { "index_id": "total_assets_growth_ratio", "value": "-16.0031" } ] }, { "ability": "profitability", "indicators": [ { "index_id": "sale_gross_margin", "value": "89.12000000" }, { "index_id": "earned_interest_multiple", "value": null } ] } ] } } } } } }, "externalDocs": { "description": "查看财务指标数据接口文档", "url": "/docs/api-reference/financial-indicators" } } }, "/api/fund/companies/detail": { "get": { "tags": [ "基金公司详情" ], "summary": "基金公司详情", "description": "按基金公司 ID 查询公司名称、类型、成立日期、基金数量与规模", "operationId": "get_fund_companies_detail", "parameters": [ { "name": "company_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "基金公司 ID，可从基金基本资料的 company_id 获取。", "example": "00089990" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "3193d28e58b1477cb41ff1780d0c627d", "data": { "timestamp": 1787140798465, "item": [ { "company_id": "00089990", "company_name": "华泰柏瑞基金管理有限公司", "company_type": "基金管理公司", "established_date_ms": 1100707200000, "fund_count": 356, "scale": 621043562116.96 } ] } } } } } }, "externalDocs": { "description": "查看基金公司详情接口文档", "url": "/docs/api-reference/fund-company" } } }, "/api/fund/corporate-actions/dividends": { "get": { "tags": [ "基金分红记录" ], "summary": "基金分红记录", "description": "查询单只基金的历史分红与权益登记日期", "operationId": "get_fund_corporate_actions_dividends", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "40ca837351bd497f99348b04ffc5c9af", "data": { "timestamp": 1786690800000, "dividend_count": 1, "dividend_total": 0.8, "item": [ { "per_ten_cash_before_tax": 0.8, "per_ten_cash_after_tax": 0.8, "progress": "实施", "publish_date_ms": 1764547200000, "registration_date_ms": 1765152000000, "ex_dividend_date_ms": 1765238400000, "payment_date_ms": 1765324800000, "reinvestment_date_ms": 1765324800000, "profit_base_date_ms": 1764460800000, "in_dividend_date_ms": 1765324800000 } ] } } } } } }, "externalDocs": { "description": "查看基金分红记录接口文档", "url": "/docs/api-reference/fund-corporate-actions" } } }, "/api/fund/diagnostics/detail": { "get": { "tags": [ "基金诊断详情" ], "summary": "基金诊断详情", "description": "查询基金诊断维度、同类对比、概率区间与韧性指标", "operationId": "get_fund_diagnostics_detail", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "5fbfa0f95b854564bc40dfa027868544", "data": { "timestamp": 1786690800000, "item": [ { "thscode": "510300.SH", "ticker": "510300", "fund_type": "exchange", "peer_code": "ETF-INDEX", "dimensions": {}, "peer_dimensions": {}, "probabilities": {}, "ranges": {}, "resilience": {}, "peer_resilience": {} } ] } } } } } }, "externalDocs": { "description": "查看基金诊断详情接口文档", "url": "/docs/api-reference/fund-diagnostics" } } }, "/api/fund/portfolio/holdings": { "get": { "tags": [ "基金重仓持仓" ], "summary": "基金重仓持仓", "description": "查询基金定期披露的股票、债券与基金持仓及汇总指标", "operationId": "get_fund_portfolio_holdings", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀，如 025480.OF。", "example": "025480.OF" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "0045aff2514c4e098212db69f88a5fa5", "data": { "timestamp": 0, "item": [ { "thscode": "300750.SZ", "ticker": "300750", "stock_name": "宁德时代", "hold_ratio": 4.67, "asset_type": "stock", "position_capital": 123456789.12, "position_count": 1234567, "security_market_value_rate_pct": 4.67, "period_increase_rate_pct": 0.12, "investment_rank": 1, "end_date_ms": 1785513600000 } ], "total_stock_ratio_pct": 82.3, "total_bond_ratio_pct": 5.2, "total_fund_ratio_pct": 0, "turnover_rate_pct": 96.4, "stock_ratio_pct": 82.3, "main_industry": "电子", "concentration_ratio": 48.6 } } } } } }, "externalDocs": { "description": "查看基金重仓持仓接口文档", "url": "/docs/api-reference/fund-holdings" } } }, "/api/fund/news/article-list": { "get": { "tags": [ "基金资讯列表" ], "summary": "基金资讯列表", "description": "查询单只基金的资讯文章并使用游标分页", "operationId": "get_fund_news_article_list", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "返回条数。", "example": 20 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "string" }, "description": "不透明翻页游标；下一页应原样回传上一页的 data.offset。" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "4132cc25f7be4c70aa490ef02b8a66bf", "data": { "timestamp": 1786690800000, "limit": 20, "offset": "next-page-cursor", "has_more": false, "item": [ { "id": "article-001", "content_type": "news", "title": "基金资讯标题", "summary": "基金资讯摘要", "source": "公开资讯", "url": "https://example.com/article-001", "image_url": null, "author": "编辑部", "publish_time_ms": 1786687200000, "top": false } ] } } } } } }, "externalDocs": { "description": "查看基金资讯列表接口文档", "url": "/docs/api-reference/fund-news" } } }, "/api/fund/offerings/list": { "get": { "tags": [ "基金募集列表" ], "summary": "基金募集列表", "description": "查询当前募集或即将募集的新发基金", "operationId": "get_fund_offerings_list", "parameters": [ { "name": "subscribe", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "active", "upcoming" ] }, "description": "active（当前募集）或 upcoming（即将募集）。", "example": "active" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "78ae6cdd0e384175a669dcf11a36a4da", "data": { "timestamp": 1786690800000, "item": [ { "thscode": "025480.OF", "ticker": "025480", "subscription_start_ms": 1786579200000, "subscription_end_ms": 1787184000000 } ] } } } } } }, "externalDocs": { "description": "查看基金募集列表接口文档", "url": "/docs/api-reference/fund-offerings" } } }, "/api/fund/profile/detail": { "get": { "tags": [ "基金基本资料" ], "summary": "基金基本资料", "description": "查询基金名称、规模、净值、管理人与基金经理等基本资料", "operationId": "get_fund_profile_detail", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀，如 025480.OF / 510300.SH。", "example": "025480.OF" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "353e202c28494f8f98bef62d83dbfcaf", "data": { "timestamp": 1784210313786, "item": [ { "thscode": "025480.OF", "ticker": "025480", "fund_name": "沪深300A", "estab_date": 1767024000000, "company_id": "80000222", "mgmt_name": "华夏基金管理有限公司", "manager_name": "靖博灵", "fund_scale": 1234567890.12, "unit_nav": 1.2345, "manager_info": [], "trade_rule": [], "rate_info": [] } ] } } } } } }, "externalDocs": { "description": "查看基金基本资料接口文档", "url": "/docs/api-reference/fund-profile" } } }, "/api/meta/tickers/list": { "get": { "tags": [ "标的列表获取" ], "summary": "标的列表获取", "description": "批量获取代码表，支持按资产类型过滤。采用 offset / limit 分页， 调用方循环递增 offset 直到 item.length < limit 即可取尽。", "operationId": "get_meta_tickers_list", "parameters": [ { "name": "asset_type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "规范化资产类型，支持单值或逗号分隔多值；省略时返回全部类型。", "example": "a-share" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 1000 }, "description": "单页条数，最大 10000。", "example": 1000 }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "分页偏移。", "example": 0 } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "f7g8h9i0", "data": { "timestamp": 1716105600000, "item": [ { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台", "exchange": "SH", "asset_type": "a-share", "currency": "CNY" } ] } } } } } }, "externalDocs": { "description": "查看标的列表获取接口文档", "url": "/docs/api-reference/ticker-list" } } }, "/api/meta/tickers/search": { "get": { "tags": [ "标的检索" ], "summary": "标的检索", "description": "按关键词（thscode / ticker / 中英文名称）跨市场消歧，支持子串匹配。", "operationId": "get_meta_tickers_search", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "搜索关键词：完整 thscode、ticker 代码或中英文名称（支持子串匹配）。", "example": "平安" }, { "name": "exchange", "in": "query", "required": false, "schema": { "type": "string" }, "description": "交易所过滤：SH / SZ / BJ；场外基金不参与该过滤。" }, { "name": "asset_type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "规范化资产类型，支持单值或逗号分隔多值；完整枚举见下方。" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10 }, "description": "返回上限，最大 50。", "example": 20 } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "c3d4e5f6", "data": { "timestamp": 1716105600000, "item": [ { "thscode": "601318.SH", "ticker": "601318", "name": "中国平安", "exchange": "SH", "asset_type": "a-share", "currency": "CNY" } ] } } } } } }, "externalDocs": { "description": "查看标的检索接口文档", "url": "/docs/api-reference/ticker-search" } } }, "/api/a-share/valuations/snapshot": { "get": { "tags": [ "估值数据" ], "summary": "估值数据", "description": "GET /api/a-share/valuations/snapshot", "operationId": "get_a_share_valuations_snapshot", "parameters": [ { "name": "thscodes", "in": "query", "required": true, "schema": { "type": "string" }, "description": "英文逗号分隔的 A 股 thscode 列表，如 600519.SH,000001.SZ；每项必须为六位数字加 .SH、.SZ 或 .BJ。", "example": "600519.SH,000001.SZ" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1784736000000, "total": 1, "item": [ { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台", "pe_ttm": 21.3567, "pe_mrq": 20.8841, "pb_mrq": 7.1532, "ps_ttm": 10.3284, "pcf_ttm": 19.7716 } ] } } } } } }, "externalDocs": { "description": "查看估值数据接口文档", "url": "/docs/api-reference/valuations" } } }, "/api/a-share-index/catalog/ths-index-list": { "get": { "tags": [ "指数数据" ], "summary": "同花顺指数列表", "description": "按 tag（概念 / 区域 / 特色 / 行业）列出同花顺指数清单，单 tag 一次性全量返回， 无分页参数。", "operationId": "get_a_share_index_catalog_ths_index_list", "parameters": [ { "name": "tag", "in": "query", "required": false, "schema": { "type": "string", "default": "cn_concept" }, "description": "标签白名单：cn_concept(A 股概念) / region(区域指数) / tszs(特色指数) / industry(行业指数)。大小写不敏感。", "example": "cn_concept" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "e5f6g7h8", "data": { "timestamp": 1748102400000, "item": [ { "thscode": "886042.TI", "name": "白酒概念" }, { "thscode": "886041.TI", "name": "新能源车" } ] } } } } } }, "externalDocs": { "description": "查看同花顺指数列表接口文档", "url": "/docs/api-reference/a-share-index" } } }, "/api/a-share-index/constituents/ths-stock-list": { "get": { "tags": [ "指数数据" ], "summary": "同花顺指数成分股", "description": "按单个指数 thscode 返回当前成分股清单。 支持同花顺板块指数（如 886042.TI）与标准指数（如沪深 300 000300.SH / 399300.SZ）。", "operationId": "get_a_share_index_constituents_ths_stock_list", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "指数 thscode，形如 {ticker}.{suffix}。入参会被 trim().toUpperCase() 标准化；不接受逗号，单次仅支持一个指数。", "example": "{ticker}.{suffix}" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "f6g7h8i9", "data": { "timestamp": 1748102400000, "item": [ { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台" }, { "thscode": "000858.SZ", "ticker": "000858", "name": "五粮液" } ] } } } } } }, "externalDocs": { "description": "查看同花顺指数成分股接口文档", "url": "/docs/api-reference/a-share-index" } } }, "/api/a-share-index/prices/snapshot": { "get": { "tags": [ "指数数据" ], "summary": "指数行情快照", "description": "按 thscodes 批量获取指数最新行情。与 A 股行情快照不同，本接口必须传 thscodes， 不支持空入参枚举全指数；limit / offset 仅为签名对齐保留，对当前接口无效。", "operationId": "get_a_share_index_prices_snapshot", "parameters": [ { "name": "thscodes", "in": "query", "required": true, "schema": { "type": "string" }, "description": "逗号分隔的指数 thscode 列表，如 000001.SH,399001.SZ,886042.TI,881101.TI。", "example": "000001.SH,399001.SZ,886042.TI,881101.TI" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "与 A 股行情快照签名对齐，对本接口无效。" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "与 A 股行情快照签名对齐，对本接口无效。" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "7e25804be878464ba420037155f041e6", "data": { "timestamp": 1784275991000, "total": 4, "item": [ { "thscode": "000001.SH", "ticker": "000001", "last_price": 3388.06, "price_change": 12.21, "price_change_ratio_pct": 0.3617, "open_price": 3370.25, "high_price": 3392.18, "low_price": 3365.4, "prev_price": 3375.85, "volume": 321000000, "turnover": 420000000000 } ] } } } } } }, "externalDocs": { "description": "查看指数行情快照接口文档", "url": "/docs/api-reference/a-share-index" } } }, "/api/a-share-index/prices/historical": { "get": { "tags": [ "指数数据" ], "summary": "指数历史 K 线", "description": "获取单只指数的历史 K 线序列。每次请求仅支持一个 thscode，只支持 start / end 时间区间模式， 窗口跨度不超过 10 年。指数无复权语义，因此没有 adjust 参数；本接口也没有 offset 参数。", "operationId": "get_a_share_index_prices_historical", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只指数 thscode，不接受逗号。", "example": "000001.SH" }, { "name": "interval", "in": "query", "required": true, "schema": { "type": "string", "default": "1d", "enum": [ "1d" ] }, "description": "K 线周期，当前仅支持 1d（日线）。", "example": "1d" }, { "name": "start", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "起始时间，毫秒 Unix 时间戳。", "example": 1716105600000, "x-ui-control": "date-ms", "x-default-days-ago": 30 }, { "name": "end", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "结束时间，毫秒 Unix 时间戳。end - start 超过 10 年返回 code=1003。", "example": 1747641600000, "x-ui-control": "date-ms", "x-default-days-ago": 0 } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "b9f91af9c77a42d6b8a04738793d2fa2", "data": { "timestamp": 1747584000000, "adjust": null, "item": [ { "date_ms": 1716134400000, "open_price": 3108.22, "high_price": 3125.74, "low_price": 3101.15, "close_price": 3120.68, "volume": 281000000, "turnover": 360000000000 } ] } } } } } }, "externalDocs": { "description": "查看指数历史 K 线接口文档", "url": "/docs/api-reference/a-share-index" } } }, "/api/a-share/special-data/anomaly-analysis-list": { "get": { "tags": [ "个股异动原因" ], "summary": "个股异动原因列表", "description": "查询当日个股异动原因，可选按异动标签过滤；不传 tag_codes 时返回全部当日记录。 该接口仅提供 REST API，不同步为 MCP 工具。", "operationId": "get_a_share_special_data_anomaly_analysis_list", "parameters": [ { "name": "tag_codes", "in": "query", "required": false, "schema": { "type": "string" }, "description": "异动标签，逗号分隔，多个值为 OR 关系；大小写不敏感，重复值自动去重。合法值见下方标签表。", "example": "LIMIT_UP,SHARP_FALL" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1751260800000, "item": [ { "stock_name": "贵州茅台", "analysis_content": "公司股价出现异动，相关解读内容以服务端快照为准。", "keyword_list": [ "白酒", "消费" ], "thscode": "600519.SH", "tag_name": "大涨" } ] } } } } } }, "externalDocs": { "description": "查看个股异动原因列表接口文档", "url": "/docs/api-reference/anomaly-analysis" } } }, "/api/a-share/special-data/anomaly-analysis-stock": { "get": { "tags": [ "个股异动原因" ], "summary": "按股票查询个股异动原因", "description": "按同花顺代码批量查询当日个股异动原因，按请求代码首次出现顺序返回匹配记录；格式合法但当日无异动的代码会被忽略。", "operationId": "get_a_share_special_data_anomaly_analysis_stock", "parameters": [ { "name": "thscodes", "in": "query", "required": true, "schema": { "type": "string" }, "description": "逗号分隔的同花顺代码列表，支持 SH / SZ / BJ 后缀，大小写不敏感；去重前最多 50 个 token。", "example": "600519.SH,000001.SZ" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1751260800000, "item": [ { "stock_name": "贵州茅台", "analysis_content": "公司股价出现异动，相关解读内容以服务端快照为准。", "keyword_list": [ "白酒", "消费" ], "thscode": "600519.SH", "tag_name": "大涨" } ] } } } } } }, "externalDocs": { "description": "查看按股票查询个股异动原因接口文档", "url": "/docs/api-reference/anomaly-analysis" } } }, "/api/a-share/auction/snapshot": { "get": { "tags": [ "集合竞价数据" ], "summary": "A股集合竞价快照", "description": "查询 A 股集合竞价快照与短线风向标竞价基准", "operationId": "get_a_share_auction_snapshot", "parameters": [ { "name": "thscodes", "in": "query", "required": true, "schema": { "type": "string" }, "description": "一个或多个 A 股 thscode，使用英文逗号分隔；单次请求当前最多 100 个，按分隔后的原始 token 数在去重前校验。服务端按请求顺序去重返回。", "example": "600519.SH,000001.SZ" }, { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "final", "enum": [ "live", "final" ] }, "description": "live（实时阶段）或 final（终态）。", "example": "final" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "99f4d83804b54d1c90681add4505eca0", "data": { "timestamp": 1786689000000, "auction_phase": "final", "data_status": "ready", "total": 1, "item": [ { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台", "auction_price": 1421, "auction_pct": 0.35, "auction_volume": 12600, "auction_amount": 17904600, "auction_unmatched": 800, "auction_turnover_pct": 0.01, "auction_yesterday_ratio_pct": 82.4, "auction_volume_ratio": 1.12, "pre_close_price": 1416.04, "open_price": 1421, "last_price": 1421, "float_market_cap": 1785000000000 } ] } } } } } }, "externalDocs": { "description": "查看A股集合竞价快照接口文档", "url": "/docs/api-reference/auction" } } }, "/api/a-share/auction/short-term-benchmark": { "get": { "tags": [ "集合竞价数据" ], "summary": "短线风向标竞价基准", "description": "查询 A 股集合竞价快照与短线风向标竞价基准", "operationId": "get_a_share_auction_short_term_benchmark", "parameters": [ { "name": "date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "查询日期，格式 yyyy-MM-dd；缺失或传入空字符串时使用 Asia/Shanghai 当日，显式指定非交易日时不自动回退。", "example": "2026-08-14" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "4e2f1c8c38e54ff1be9be3d17533bef9", "data": { "timestamp": 1786690800000, "date": "2026-08-14", "date_ms": 1786636800000, "item": [ { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台", "auction_pct": 0.35, "tags": [ "高开", "放量" ] } ] } } } } } }, "externalDocs": { "description": "查看短线风向标竞价基准接口文档", "url": "/docs/api-reference/auction" } } }, "/api/a-share/financials/income-statements": { "get": { "tags": [ "财务报表" ], "summary": "利润表", "description": "A 股整体合并利润表多期序列。取数模式与参数见上文。", "operationId": "get_a_share_financials_income_statements", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只标的 thscode，不接受逗号；含交易所后缀。", "example": "600519.SH" }, { "name": "period", "in": "query", "required": true, "schema": { "type": "string", "default": "annual", "enum": [ "annual", "quarterly" ] }, "description": "annual（仅 Q4 报告期）/ quarterly（每个季度末）。", "example": "annual" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 4 }, "description": "最近 N 期模式，范围 [1, 20]；与 start / end 互斥。", "example": 3 }, { "name": "start", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "时间区间模式起始毫秒戳，需与 end 同传。", "x-ui-control": "date-ms" }, { "name": "end", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "时间区间模式结束毫秒戳，需满足 end >= start。", "x-ui-control": "date-ms" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "e5f6g7h8", "data": { "timestamp": 1735574400000, "item": [ { "thscode": "600519.SH", "ticker": "600519", "period": "annual", "fiscal_year": 2024, "fiscal_period": "FY", "report_date_ms": 1735574400000, "period_end_ms": 1735574400000, "currency": "CNY", "operating_income": 174144000000, "operating_costs": 13000000000, "operating_expenses": 50000000000, "sales_fee": 5000000000, "manage_fee": 9000000000, "research_and_development_expenses": 150000000, "operating_profit": 124000000000, "interest_expenses": 0, "profit_total": 124000000000, "income_tax_expense": 31000000000, "net_profit": 93000000000, "parent_holder_net_profit": 86000000000, "basic_eps": 68.5 } ] } } } } } }, "externalDocs": { "description": "查看利润表接口文档", "url": "/docs/api-reference/financials" } } }, "/api/a-share/financials/balance-sheets": { "get": { "tags": [ "财务报表" ], "summary": "资产负债表", "description": "A 股整体合并资产负债表多期序列。取数模式与参数同利润表。", "operationId": "get_a_share_financials_balance_sheets", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只标的 thscode，不接受逗号；含交易所后缀。", "example": "000858.SZ" }, { "name": "period", "in": "query", "required": true, "schema": { "type": "string", "default": "annual", "enum": [ "annual", "quarterly" ] }, "description": "annual（仅 Q4 报告期）/ quarterly（每个季度末）。", "example": "quarterly" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 4 }, "description": "最近 N 期模式，范围 [1, 20]；与 start / end 互斥。" }, { "name": "start", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "时间区间模式起始毫秒戳，需与 end 同传。", "x-ui-control": "date-ms" }, { "name": "end", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "时间区间模式结束毫秒戳，需满足 end >= start。", "x-ui-control": "date-ms" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "f6g7h8i9", "data": { "timestamp": 1735574400000, "item": [ { "thscode": "000858.SZ", "ticker": "000858", "period": "quarterly", "fiscal_year": 2024, "fiscal_period": "Q4", "report_date_ms": 1735574400000, "period_end_ms": 1735574400000, "currency": "CNY", "assets_total": 250000000000, "total_current_assets": 200000000000, "non_current_nets_total": 50000000000, "cash": 130000000000, "accounts_receivable": 500000000, "total_debt": 60000000000, "holder_equity_total": 190000000000 } ] } } } } } }, "externalDocs": { "description": "查看资产负债表接口文档", "url": "/docs/api-reference/financials" } } }, "/api/a-share/financials/cash-flow-statements": { "get": { "tags": [ "财务报表" ], "summary": "现金流量表", "description": "A 股整体合并现金流量表多期序列。取数模式与参数同利润表。", "operationId": "get_a_share_financials_cash_flow_statements", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只标的 thscode，不接受逗号；含交易所后缀。", "example": "600519.SH" }, { "name": "period", "in": "query", "required": true, "schema": { "type": "string", "default": "annual", "enum": [ "annual", "quarterly" ] }, "description": "annual（仅 Q4 报告期）/ quarterly（每个季度末）。", "example": "annual" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 4 }, "description": "最近 N 期模式，范围 [1, 20]；与 start / end 互斥。" }, { "name": "start", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "时间区间模式起始毫秒戳，需与 end 同传。", "example": 1577808000000, "x-ui-control": "date-ms" }, { "name": "end", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "时间区间模式结束毫秒戳，需满足 end >= start。", "example": 1735574400000, "x-ui-control": "date-ms" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "g7h8i9j0", "data": { "timestamp": 1735574400000, "item": [ { "thscode": "600519.SH", "ticker": "600519", "period": "annual", "fiscal_year": 2024, "fiscal_period": "FY", "report_date_ms": 1735574400000, "period_end_ms": 1735574400000, "currency": "CNY", "act_cash_flow_net": 92000000000, "invest_cash_flow_net": -3000000000, "financing_cash_flow_net": -65000000000, "pay_fixed_assets_etc_cash": 3500000000, "pay_dividends_profits_interest_cash": 64000000000, "cash_equivalents_net_addition": 24000000000 } ] } } } } } }, "externalDocs": { "description": "查看现金流量表接口文档", "url": "/docs/api-reference/financials" } } }, "/api/fund/financials/indicators": { "get": { "tags": [ "基金财务数据" ], "summary": "基金财务指标", "description": "查询基金财务指标、利润表与资产负债表", "operationId": "get_fund_financials_indicators", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "8e6d6e85c99447a2ae89e87b98aa9e7e", "data": { "timestamp": 1786690800000, "item": [ { "start_date_ms": 1751328000000, "end_date_ms": 1759190400000, "publish_date_ms": 1760054400000, "distribution_profit": 1250000000.5, "current_profit": 1180000000.2, "share_nav": 4.753, "nav_rate": 3.21 } ] } } } } } }, "externalDocs": { "description": "查看基金财务指标接口文档", "url": "/docs/api-reference/fund-financials" } } }, "/api/fund/financials/income-statements": { "get": { "tags": [ "基金财务数据" ], "summary": "基金利润表", "description": "查询基金财务指标、利润表与资产负债表", "operationId": "get_fund_financials_income_statements", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "5bbd57b24cdd41c9b30f50ca5a57df6c", "data": { "timestamp": 1786690800000, "item": [ { "start_date_ms": 1751328000000, "end_date_ms": 1759190400000, "publish_date_ms": 1760054400000, "total_income": 1680000000.2, "total_fee": 320000000.4, "total_profit": 1360000000.8, "net_profit": 1360000000.8 } ] } } } } } }, "externalDocs": { "description": "查看基金利润表接口文档", "url": "/docs/api-reference/fund-financials" } } }, "/api/fund/financials/balance-sheets": { "get": { "tags": [ "基金财务数据" ], "summary": "基金资产负债表", "description": "查询基金财务指标、利润表与资产负债表", "operationId": "get_fund_financials_balance_sheets", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "aaf01838ef4e44eda1a89a8a750f6fb1", "data": { "timestamp": 1786690800000, "item": [ { "start_date_ms": 1751328000000, "end_date_ms": 1759190400000, "publish_date_ms": 1760054400000, "total_assets": 168000000000, "total_liability": 1200000000, "owner_total_equity": 166800000000, "liability_and_owner_equity": 168000000000 } ] } } } } } }, "externalDocs": { "description": "查看基金资产负债表接口文档", "url": "/docs/api-reference/fund-financials" } } }, "/api/fund/holders/detail": { "get": { "tags": [ "基金持有人数据" ], "summary": "基金持有人结构", "description": "查询基金持有人结构与前十大持有人", "operationId": "get_fund_holders_detail", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀。", "example": "161725.SZ" }, { "name": "merge_scope", "in": "query", "required": false, "schema": { "type": "string", "default": "all", "enum": [ "all", "merged", "separate" ] }, "description": "all（分别返回合并/独立份额的最新记录）/ merged（A/C 等份额合并披露）/ separate（当前份额独立披露）。", "example": "all" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "efcdf379c79349ec8a2eb7bdf0d27882", "data": { "timestamp": 1767110400000, "item": [ { "merge_scope": "merged", "report_date_ms": 1609344000000, "ins_position": 0.18, "holder_amount": 7058156, "avg_holder_share": 4819.42, "psnl_rate": 99.82, "mgmt_staff_hold_rate": 0.0062 }, { "merge_scope": "separate", "report_date_ms": 1767110400000, "ins_position": 0.97, "holder_amount": 3951034, "avg_holder_share": 10159.83, "psnl_rate": 99.03, "mgmt_staff_hold_rate": 0.0097 } ] } } } } } }, "externalDocs": { "description": "查看基金持有人结构接口文档", "url": "/docs/api-reference/fund-holders" } } }, "/api/fund/holders/top": { "get": { "tags": [ "基金持有人数据" ], "summary": "基金前十大持有人", "description": "查询基金持有人结构与前十大持有人", "operationId": "get_fund_holders_top", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "返回条数，最大为 10。", "example": 10 } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "e4a3af1cf0b14210b98d023297740324", "data": { "timestamp": 1786690800000, "limit": 10, "item": [ { "holder_id": "holder-001", "holder_code": "H001", "holder_name": "示例持有人", "holder_type": "institution", "rank": 1, "hold_share": 125000000, "hold_rate_pct": 8.25, "report_date_ms": 1785513600000, "publish_date_ms": 1786118400000 } ] } } } } } }, "externalDocs": { "description": "查看基金前十大持有人接口文档", "url": "/docs/api-reference/fund-holders" } } }, "/api/fund/managers/investment-style": { "get": { "tags": [ "基金经理数据" ], "summary": "投资风格", "description": "查询基金经理投资风格、业绩、从业经历与详情", "operationId": "get_fund_managers_investment_style", "parameters": [ { "name": "manager_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "基金经理 ID。", "example": "H000200384" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "46fded1c293c473a8b406fafe60d4b6b", "data": { "timestamp": 1787140798489, "item": [ { "representative_fund_thscode": "510300.SH", "representative_fund_ticker": "510300", "representative_fund_name": "华泰柏瑞沪深300ETF", "investment_idea": null, "total_fund_scale": null, "industry_preferences": [ { "report_tag": "2022", "percent": [ 0.07, 0.26, 0.11, 0.27, 0.05, 0, 0.23 ], "total_fund_scale": 23304220274.36 } ] } ] } } } } } }, "externalDocs": { "description": "查看投资风格接口文档", "url": "/docs/api-reference/fund-managers" } } }, "/api/fund/managers/performance": { "get": { "tags": [ "基金经理数据" ], "summary": "基金经理业绩", "description": "查询基金经理投资风格、业绩、从业经历与详情", "operationId": "get_fund_managers_performance", "parameters": [ { "name": "manager_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "基金经理 ID。", "example": "H000200384" }, { "name": "range", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "month", "tmonth", "year", "nowyear", "now" ] }, "description": "month / tmonth / year / nowyear / now。", "example": "year" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "89385428873f44a98cc27530b88c01c2", "data": { "timestamp": 1787140798642, "item": [ { "date_ms": 1774281600000, "manager_return_pct": 2.2001672, "peer_return_pct": 5.75548505, "benchmark_return_pct": 4474.72 } ] } } } } } }, "externalDocs": { "description": "查看基金经理业绩接口文档", "url": "/docs/api-reference/fund-managers" } } }, "/api/fund/managers/experience": { "get": { "tags": [ "基金经理数据" ], "summary": "从业经历", "description": "查询基金经理投资风格、业绩、从业经历与详情", "operationId": "get_fund_managers_experience", "parameters": [ { "name": "manager_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "基金经理 ID。", "example": "H000200384" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "4b211e1309d441db9b243cfc30a2556e", "data": { "timestamp": 1787140798437, "item": [ { "awards": null, "heavy_assets": { "stock": [ { "trade_name": "贵州茅台", "trade_code": "600519", "market_value": 2403228884.47, "scale": 1.92 } ] }, "investment_history": { "460300": { "code": "460300", "name": "华泰柏瑞沪深300ETF联接A", "start": "2012-05-29", "end": "至今" } } } ] } } } } } }, "externalDocs": { "description": "查看从业经历接口文档", "url": "/docs/api-reference/fund-managers" } } }, "/api/fund/managers/detail": { "get": { "tags": [ "基金经理数据" ], "summary": "基金经理详情", "description": "查询基金经理投资风格、业绩、从业经历与详情", "operationId": "get_fund_managers_detail", "parameters": [ { "name": "manager_id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "基金经理 ID。", "example": "H000200384" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "4d1f41d3e8084e57ae45bd03e3a6a331", "data": { "timestamp": 1787140798517, "item": [ { "manager_id": "H000200384", "manager_name": "柳军", "sex": "m", "degree": null, "company_id": "00089990", "company_name": "华泰柏瑞基金管理有限公司", "photo_url": "https://fund.10jqka.com.cn/photos/20210702,etool_11214328996.jpg", "annual_return_pct": 0.05096597, "maximum_return_pct": -0.45588366644825656 } ] } } } } } }, "externalDocs": { "description": "查看基金经理详情接口文档", "url": "/docs/api-reference/fund-managers" } } }, "/api/fund/market/snapshot": { "get": { "tags": [ "基金行情数据" ], "summary": "场内基金行情快照", "description": "仅支持 ETF。LOF、场外基金、REITs 或尚未开放的基金叶子类型返回 code=3004。", "operationId": "get_fund_market_snapshot", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只 ETF 的完整 thscode，必须保留市场后缀，如 510300.SH；不接受逗号分隔的多个值。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "558cdc5105964a93953b1a541e7af901", "data": { "timestamp": 1784210584000, "item": [ { "thscode": "510300.SH", "ticker": "510300", "last_price": 4.753, "open_price": 4.775, "high_price": 4.825, "low_price": 4.724, "prev_price": 4.838, "price_change_ratio_pct": -1.756924, "price_change": -0.085, "price_amplitude_ratio_pct": 2.08764, "volume": 1657822800, "turnover": 7909234100, "turnover_ratio_pct": 9.012068 } ] } } } } } }, "externalDocs": { "description": "查看场内基金行情快照接口文档", "url": "/docs/api-reference/fund-market" } } }, "/api/fund/market/historical": { "get": { "tags": [ "基金行情数据" ], "summary": "场内基金历史日线行情", "description": "仅支持 ETF；单次只允许一个 thscode，查询窗口最长 5 个自然年。", "operationId": "get_fund_market_historical", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只 ETF 的完整 thscode，必须保留市场后缀；不接受逗号分隔的多个值。", "example": "510300.SH" }, { "name": "interval", "in": "query", "required": false, "schema": { "type": "string", "default": "1d", "enum": [ "1d" ] }, "description": "K 线周期，当前仅支持 1d（日线）。", "example": "1d" }, { "name": "start", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "起始时间，毫秒级 Unix 时间戳。", "example": 1626451200000, "x-ui-control": "date-ms", "x-default-days-ago": 30 }, { "name": "end", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "结束时间，毫秒级 Unix 时间戳；必须不早于 start，且窗口最长 5 个自然年。", "example": 1784217600000, "x-ui-control": "date-ms", "x-default-days-ago": 0 } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "f47444ed0e0d4e1c883ecb66511dc311", "data": { "timestamp": 1784131200000, "thscode": "510300.SH", "interval": "1d", "adjust": null, "item": [ { "date_ms": 1626624000000, "volume": 332046160, "turnover": 1709347700, "open_price": 4.728, "high_price": 4.769, "low_price": 4.687, "close_price": 4.759 }, { "date_ms": 1626710400000, "volume": 306679330, "turnover": 1581145200, "open_price": 4.721, "high_price": 4.76, "low_price": 4.712, "close_price": 4.746 } ] } } } } } }, "externalDocs": { "description": "查看场内基金历史日线行情接口文档", "url": "/docs/api-reference/fund-market" } } }, "/api/fund/performance/nav": { "get": { "tags": [ "基金业绩与回撤" ], "summary": "基金净值", "description": "查询基金净值、区间收益、净值波动、趋势强弱、估值百分位与最大回撤", "operationId": "get_fund_performance_nav", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀。", "example": "510300.SH" }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "week", "month", "tmonth", "hyear", "year", "twoyear", "tyear", "fyear" ] }, "description": "week / month / tmonth / hyear / year / twoyear / tyear / fyear。", "example": "year" }, { "name": "nav_type", "in": "query", "required": false, "schema": { "type": "string", "default": "unit,adj", "enum": [ "unit", "adj", "unit,adj" ] }, "description": "unit（单位净值）/ adj（复权净值）/ unit,adj（同时返回）。", "example": "unit" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "97634b0fbf4746afaa32e8a71adbd636", "data": { "timestamp": 1784131200000, "item": [ { "nav_date": 1752595200000, "unit_nav": 4.0713 }, { "nav_date": 1752681600000, "unit_nav": 4.1015 } ] } } } } } }, "externalDocs": { "description": "查看基金净值接口文档", "url": "/docs/api-reference/fund-performance" } } }, "/api/fund/performance/returns": { "get": { "tags": [ "基金业绩与回撤" ], "summary": "基金区间收益", "description": "查询基金净值、区间收益、净值波动、趋势强弱、估值百分位与最大回撤", "operationId": "get_fund_performance_returns", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode，必须保留市场后缀。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "61cb2a8b9340483aaf00e36748f77918", "data": { "timestamp": 0, "item": [ { "return_month": -3.33, "return_tmonth": 0.03, "return_hyear": 0.19, "return_year": 19.66, "return_tyear": 28.69, "return_fyear": 1.77, "return_nowyear": 2.49, "return_now": 121.58 } ] } } } } } }, "externalDocs": { "description": "查看基金区间收益接口文档", "url": "/docs/api-reference/fund-performance" } } }, "/api/fund/performance/indicators-historical": { "get": { "tags": [ "基金业绩与回撤" ], "summary": "基金历史业绩指标", "description": "查询基金净值、区间收益、净值波动、趋势强弱、估值百分位与最大回撤", "operationId": "get_fund_performance_indicators_historical", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "start", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "起始时间，毫秒 Unix 时间戳。", "example": 1735689600000, "x-ui-control": "date-ms", "x-default-days-ago": 30 }, { "name": "end", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "结束时间，毫秒 Unix 时间戳。", "example": 1767225599000, "x-ui-control": "date-ms", "x-default-days-ago": 0 } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "046f8a0b787c44a7b995c568096fa16c", "data": { "timestamp": 1767225599000, "item": [ { "date_ms": 1767139200000, "rsi_pct": 53.8, "donchian_channel": 0.42, "track_index_pe_ttm_five_year_percentile": 61.3 } ] } } } } } }, "externalDocs": { "description": "查看基金历史业绩指标接口文档", "url": "/docs/api-reference/fund-performance" } } }, "/api/fund/performance/drawdowns": { "get": { "tags": [ "基金业绩与回撤" ], "summary": "基金最大回撤", "description": "查询基金净值、区间收益、净值波动、趋势强弱、估值百分位与最大回撤", "operationId": "get_fund_performance_drawdowns", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "7c7fdfe771fc4c61bbab8410a250b61e", "data": { "timestamp": 1786690800000, "item": [ { "thscode": "510300.SH", "ticker": "510300", "week": -1.2, "month": -3.6, "tmonth": -6.8, "hyear": -9.1, "year": -12.5, "twoyear": -18.4, "tyear": -21.7, "fyear": -28.9, "nowyear": -7.3, "now": -31.2 } ] } } } } } }, "externalDocs": { "description": "查看基金最大回撤接口文档", "url": "/docs/api-reference/fund-performance" } } }, "/api/fund/portfolio/stock-history": { "get": { "tags": [ "基金持仓与资产配置" ], "summary": "基金历史股票持仓", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置", "operationId": "get_fund_portfolio_stock_history", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "report_type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "报告类型。", "example": "quarter" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string" }, "description": "报告截止日期，格式 yyyy-MM-dd。", "example": "2026-06-30" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "e9738357ba1b4ec98849276fe5367a19", "data": { "timestamp": 1786690800000, "item": [ { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台", "asset_type": "stock", "hold_ratio": 4.67, "market_value": 123456789.12, "period_increase_pct": 0.12, "rank": 1, "report_type": "quarter", "end_date_ms": 1782748800000 } ] } } } } } }, "externalDocs": { "description": "查看基金历史股票持仓接口文档", "url": "/docs/api-reference/fund-portfolio" } } }, "/api/fund/portfolio/bond-history": { "get": { "tags": [ "基金持仓与资产配置" ], "summary": "基金历史债券持仓", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置", "operationId": "get_fund_portfolio_bond_history", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "report_type", "in": "query", "required": true, "schema": { "type": "string" }, "description": "报告类型。", "example": "quarter" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string" }, "description": "报告截止日期，格式 yyyy-MM-dd。", "example": "2026-06-30" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "6816bf90628e49388d8e14adaf751bc6", "data": { "timestamp": 1786690800000, "item": [ { "thscode": "019547.SH", "ticker": "019547", "name": "示例国债", "asset_type": "bond", "hold_ratio": 2.35, "market_value": 62500000, "period_increase_pct": -0.08, "rank": 1, "report_type": "quarter", "end_date_ms": 1782748800000 } ] } } } } } }, "externalDocs": { "description": "查看基金历史债券持仓接口文档", "url": "/docs/api-reference/fund-portfolio" } } }, "/api/fund/portfolio/stock-report-dates": { "get": { "tags": [ "基金持仓与资产配置" ], "summary": "基金股票持仓报告日期", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置", "operationId": "get_fund_portfolio_stock_report_dates", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "report_type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "报告类型。", "example": "quarter" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "b134e73e088341a791a3194c57b5fb0b", "data": { "timestamp": 1786690800000, "item": [ { "report_type": "quarter", "report_type_name": "季报", "start_date_ms": 1775001600000, "end_date_ms": 1782748800000 } ] } } } } } }, "externalDocs": { "description": "查看基金股票持仓报告日期接口文档", "url": "/docs/api-reference/fund-portfolio" } } }, "/api/fund/portfolio/bond-report-dates": { "get": { "tags": [ "基金持仓与资产配置" ], "summary": "基金债券持仓报告日期", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置", "operationId": "get_fund_portfolio_bond_report_dates", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" }, { "name": "report_type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "报告类型。", "example": "quarter" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a5eaa47bf5bd4ff5b21e7235bb011123", "data": { "timestamp": 1786690800000, "item": [ { "report_type": "quarter", "report_type_name": "季报", "start_date_ms": 1775001600000, "end_date_ms": 1782748800000 } ] } } } } } }, "externalDocs": { "description": "查看基金债券持仓报告日期接口文档", "url": "/docs/api-reference/fund-portfolio" } } }, "/api/fund/portfolio/asset-allocation": { "get": { "tags": [ "基金持仓与资产配置" ], "summary": "基金资产配置", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置", "operationId": "get_fund_portfolio_asset_allocation", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "fb4a567d631a4fafbc9ac39f2a4cc264", "data": { "timestamp": 1786690800000, "item": [ { "report_date_ms": 1782748800000, "stock_ratio_pct": 82.3, "bond_ratio_pct": 5.2, "deposit_ratio_pct": 8.1, "other_ratio_pct": 4.4 } ] } } } } } }, "externalDocs": { "description": "查看基金资产配置接口文档", "url": "/docs/api-reference/fund-portfolio" } } }, "/api/fund/portfolio/industry-allocation": { "get": { "tags": [ "基金持仓与资产配置" ], "summary": "基金行业配置", "description": "查询基金历史股票债券持仓、报告期、资产配置与行业配置", "operationId": "get_fund_portfolio_industry_allocation", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "完整基金 thscode。", "example": "510300.SH" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "6999bcf53d024fabbba27486c8a421a4", "data": { "timestamp": 1786690800000, "item": [ { "report_period": "2026Q2", "industry_name": "金融", "ratio_pct": 18.6 } ] } } } } } }, "externalDocs": { "description": "查看基金行业配置接口文档", "url": "/docs/api-reference/fund-portfolio" } } }, "/api/a-share/special-data/skyrocket-list": { "get": { "tags": [ "同花顺热榜" ], "summary": "飙升榜", "description": "查询 A 股热度排名飙升榜 Top30。period=day 返回日榜，period=hour 返回小时榜；省略 period 时默认返回日榜。", "operationId": "get_a_share_special_data_skyrocket_list", "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "day", "enum": [ "day", "hour" ] }, "description": "榜单周期：day 日榜 / hour 小时榜。", "example": "hour" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1748102400000, "item": [ { "thscode": "603822.SH", "ticker": "603822", "name": "嘉澳环保", "rank": 1, "heat": "1941909", "rank_change": 7, "rank_trend": "up" } ] } } } } } }, "externalDocs": { "description": "查看飙升榜接口文档", "url": "/docs/api-reference/hot-list-data" } } }, "/api/a-share/special-data/hot-stock-list": { "get": { "tags": [ "同花顺热榜" ], "summary": "A股热股榜单", "description": "查询 A 股热股榜单 Top30。period=day 返回 24 小时级别榜单，period=hour 返回小时级别榜单；省略 period 时默认返回 24 小时级别榜单。", "operationId": "get_a_share_special_data_hot_stock_list", "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "day", "enum": [ "day", "hour" ] }, "description": "榜单周期：day 24 小时级别 / hour 小时级别。", "example": "day" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1748102400000, "item": [ { "thscode": "603822.SH", "ticker": "603822", "name": "嘉澳环保", "rank": 1, "heat": "1941909", "rank_change": 7, "rank_trend": "up" } ] } } } } } }, "externalDocs": { "description": "查看A股热股榜单接口文档", "url": "/docs/api-reference/hot-list-data" } } }, "/api/a-share/special-data/hot-stock-list-history": { "get": { "tags": [ "同花顺热榜" ], "summary": "历史热股排行", "description": "按自然日返回历史热股榜排行。对外只接受 date=yyyy-MM-dd，服务端统一按 Asia/Shanghai 当日 00:00 转上游秒级时间戳，避免调用方直接传时间戳导致未对齐自然日。", "operationId": "get_a_share_special_data_hot_stock_list_history", "parameters": [ { "name": "date", "in": "query", "required": true, "schema": { "type": "string" }, "description": "目标自然日，格式 yyyy-MM-dd；只支持一年内数据。", "example": "2026-06-21" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "date": "2026-06-21", "date_ms": 1781971200000, "item": [ { "thscode": "000725.SZ", "ticker": "000725", "name": "京东方A", "rank": 1 } ] } } } } } }, "externalDocs": { "description": "查看历史热股排行接口文档", "url": "/docs/api-reference/hot-list-data" } } }, "/api/a-share/special-data/hot-stock-rank-trend": { "get": { "tags": [ "同花顺热榜" ], "summary": "个股排名走势", "description": "查询单只 A 股在一段自然日窗口内的热榜排名走势。窗口和日期都限制在一年内，返回点位与上游日线序列对齐。 该接口返回的是走势点位，不做 Top30 截断。", "operationId": "get_a_share_special_data_hot_stock_rank_trend", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只 A 股标的，含交易所后缀，例如 300034.SZ。", "example": "300034.SZ" }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string" }, "description": "起始自然日，格式 yyyy-MM-dd。", "example": "2026-06-21" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string" }, "description": "结束自然日，格式 yyyy-MM-dd；需大于等于 start_date。", "example": "2026-07-01" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1781971200000, "item": [ { "thscode": "300034.SZ", "ticker": "300034", "date": "2026-06-21", "date_ms": 1781971200000, "rank": 1740 } ] } } } } } }, "externalDocs": { "description": "查看个股排名走势接口文档", "url": "/docs/api-reference/hot-list-data" } } }, "/api/a-share/special-data/limit-up-pool": { "get": { "tags": [ "涨跌停与炸板数据" ], "summary": "涨停股票池", "description": "按交易日返回 A 股涨停 / 连板股票池，后端固定取全部连板与 main,chinext,ssestar,north 四类板块，支持分页与排序。 返回字段聚焦涨停语义（涨停时间、原因、连板天数、封单额等），不含资金流 / 行业 / 分时预览等通用字段。", "operationId": "get_a_share_special_data_limit_up_pool", "parameters": [ { "name": "date_ms", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "查询交易日 Unix 毫秒戳（Asia/Shanghai 00:00:00）；省略时回退到服务端当前自然日。", "x-ui-control": "date-ms" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 1 }, "description": "页码，必须 >= 1。", "example": 1 }, { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "default": 50 }, "description": "分页大小，取值范围 1 到 200。", "example": 50 }, { "name": "sort_field", "in": "query", "required": false, "schema": { "type": "string", "default": "last_price", "enum": [ "last_price", "continue_day_cnt", "seal_money", "limit_up_time" ] }, "description": "排序字段：last_price / continue_day_cnt / seal_money / limit_up_time。", "example": "limit_up_time" }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] }, "description": "排序方向：asc / desc。", "example": "desc" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1748102400000, "pagination": { "total": 126, "pages": 3, "size": 50, "page": 1 }, "item": [ { "thscode": "603986.SH", "ticker": "603986", "name": "兆易创新", "is_st": false, "is_new": false, "last_price": 118.23, "price_change_ratio_pct": 10.0008, "limit_up_time": "09:34", "limit_up_reason": "存储芯片", "continue_day_text": "2连板", "continue_day_cnt": 2, "seal_money": 123456789.12, "max_seal_money": 234567890.12 } ] } } } } } }, "externalDocs": { "description": "查看涨停股票池接口文档", "url": "/docs/api-reference/limit-up-data" } } }, "/api/a-share/special-data/limit-down-pool": { "get": { "tags": [ "涨跌停与炸板数据" ], "summary": "跌停股票池", "description": "按交易日返回 A 股跌停股票池，首次与最后跌停时间统一为上海时区 HH:mm。", "operationId": "get_a_share_special_data_limit_down_pool", "parameters": [ { "name": "date_ms", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "交易日的上海时区零点毫秒时间戳。", "x-ui-control": "date-ms" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 1 }, "description": "页码，从 1 开始。", "example": 1 }, { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "default": 50 }, "description": "单页条数，范围 1..200。", "example": 50 }, { "name": "sort_field", "in": "query", "required": false, "schema": { "type": "string", "default": "last_limit_time", "enum": [ "last_limit_time", "first_limit_time", "last_price", "price_change_ratio_pct", "turnover_ratio_pct" ] }, "description": "last_limit_time / first_limit_time / last_price / price_change_ratio_pct / turnover_ratio_pct。", "example": "last_limit_time" }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] }, "description": "asc / desc。", "example": "desc" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "5d0430b287ab4fdc89f3c47cd080aa8e", "data": { "timestamp": 1786690800000, "pagination": { "total": 1, "pages": 1, "size": 50, "page": 1 }, "item": [ { "thscode": "600000.SH", "ticker": "600000", "name": "示例股票", "last_price": 9.8, "price_change_ratio_pct": -10, "first_limit_time": "09:35", "last_limit_time": "14:56", "turnover_ratio_pct": 4.2 } ] } } } } } }, "externalDocs": { "description": "查看跌停股票池接口文档", "url": "/docs/api-reference/limit-up-data" } } }, "/api/a-share/special-data/limit-break-pool": { "get": { "tags": [ "涨跌停与炸板数据" ], "summary": "炸板股票池", "description": "按交易日返回 A 股涨停炸板股票池；接口直接消费炸板集合，不在服务端生成或归因。", "operationId": "get_a_share_special_data_limit_break_pool", "parameters": [ { "name": "date_ms", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "交易日的上海时区零点毫秒时间戳。", "x-ui-control": "date-ms" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 1 }, "description": "页码，从 1 开始。", "example": 1 }, { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "default": 50 }, "description": "单页条数，范围 1..200。", "example": 50 }, { "name": "sort_field", "in": "query", "required": false, "schema": { "type": "string", "default": "price_change_ratio_pct", "enum": [ "price_change_ratio_pct", "open_times", "last_price", "turnover_ratio_pct", "turnover" ] }, "description": "price_change_ratio_pct / open_times / last_price / turnover_ratio_pct / turnover。", "example": "open_times" }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "enum": [ "asc", "desc" ] }, "description": "asc / desc。", "example": "desc" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "90015f998b184711bd65152750320b47", "data": { "timestamp": 1786690800000, "pagination": { "total": 1, "pages": 1, "size": 50, "page": 1 }, "item": [ { "thscode": "000001.SZ", "ticker": "000001", "name": "示例股票", "last_price": 12.5, "price_change_ratio_pct": 7.6, "open_times": 3, "turnover_ratio_pct": 8.1, "turnover": 1250000000 } ] } } } } } }, "externalDocs": { "description": "查看炸板股票池接口文档", "url": "/docs/api-reference/limit-up-data" } } }, "/api/a-share/special-data/limit-up-ladder": { "get": { "tags": [ "涨跌停与炸板数据" ], "summary": "连板天梯", "description": "返回 A 股近 30 个交易日的连板梯队矩阵（按日期 -> 6 个板 -> 股票列表），用于近期连板分布、次日晋级追踪等分析。 无入参；上游当前固定返回 30 日，每个板位最多 4 只。", "operationId": "get_a_share_special_data_limit_up_ladder", "parameters": [], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "a1b2c3d4e5f6789012345678abcdef01", "data": { "timestamp": 1748102400000, "window": { "length": 30, "date_list": [ "20250620", "20250619" ], "board_caps": { "two_board": 4, "three_board": 4, "four_board": 4, "five_board": 4, "six_board": 4, "seven_over": 4 } }, "item": [ { "date": "20250620", "boards": { "two_board": [ { "thscode": "603986.SH", "ticker": "603986", "name": "兆易创新", "board_num": 2, "seal_nextday": null, "sign_level": 1 } ], "three_board": [], "four_board": [], "five_board": [], "six_board": [], "seven_over": [] } } ] } } } } } }, "externalDocs": { "description": "查看连板天梯接口文档", "url": "/docs/api-reference/limit-up-data" } } }, "/api/a-share/prices/snapshot": { "get": { "tags": [ "股票行情数据" ], "summary": "行情快照", "description": "获取 A 股行情快照。thscodes 显式传入（逗号分隔）时按入参顺序批量取数、不分页； 省略时遍历完整 A 股代码表（按 thscode 升序），并按 limit / offset 分页。", "operationId": "get_a_share_prices_snapshot", "parameters": [ { "name": "thscodes", "in": "query", "required": false, "schema": { "type": "string" }, "description": "逗号分隔的 thscode 列表，如 600519.SH,000001.SZ。给定时忽略分页参数。", "example": "600519.SH,000001.SZ" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100 }, "description": "分页大小，仅在 thscodes 省略时生效。" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "分页偏移，仅在 thscodes 省略时生效。" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "7e25804be878464ba420037155f041e6", "data": { "timestamp": 1784275991000, "total": 2, "item": [ { "thscode": "600519.SH", "ticker": "600519", "volume": 3098875, "turnover": 3937375200, "last_price": 1277.8, "price_change": 21.8, "price_change_ratio_pct": 1.735669, "open_price": 1252.08, "high_price": 1282, "low_price": 1250.21, "prev_price": 1256 } ] } } } } } }, "externalDocs": { "description": "查看行情快照接口文档", "url": "/docs/api-reference/prices" } } }, "/api/a-share/prices/historical": { "get": { "tags": [ "股票行情数据" ], "summary": "历史 K 线", "description": "获取单只标的的 A 股历史 K 线序列。接口层强约束：每次请求仅一个 thscode， 且 [start, end] 窗口跨度不超过 10 年。", "operationId": "get_a_share_prices_historical", "parameters": [ { "name": "thscode", "in": "query", "required": true, "schema": { "type": "string" }, "description": "单只标的 thscode，不接受逗号。多标的请分多次请求。", "example": "600519.SH" }, { "name": "interval", "in": "query", "required": true, "schema": { "type": "string", "default": "1d", "enum": [ "1d" ] }, "description": "K 线周期，当前仅支持 1d(日线)。", "example": "1d" }, { "name": "start", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "起始时间，毫秒 Unix 时间戳。缺失返回 code=1001。", "example": 1716105600000, "x-ui-control": "date-ms", "x-default-days-ago": 30 }, { "name": "end", "in": "query", "required": true, "schema": { "type": "integer" }, "description": "结束时间，毫秒 Unix 时间戳。end - start 超过 10 年返回 code=1003。", "example": 1747641600000, "x-ui-control": "date-ms", "x-default-days-ago": 0 }, { "name": "adjust", "in": "query", "required": false, "schema": { "type": "string", "default": "forward", "enum": [ "none", "forward", "backward" ] }, "description": "复权方式：none / forward(前复权) / backward(后复权)。", "example": "forward" } ], "responses": { "200": { "description": "统一 ApiResponse 响应。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse" }, "example": { "code": 0, "message": "success", "request_id": "b9f91af9c77a42d6b8a04738793d2fa2", "data": { "timestamp": 1747584000000, "item": [ { "date_ms": 1716134400000, "open_price": 1611.602, "high_price": 1626.602, "low_price": 1601.722, "close_price": 1602.612, "volume": 3142572, "turnover": 5401389334.87 } ] } } } } } }, "externalDocs": { "description": "查看历史 K 线接口文档", "url": "/docs/api-reference/prices" } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-api-key", "description": "API Key" } }, "schemas": { "ApiResponse": { "type": "object", "required": [ "code", "message", "request_id", "data" ], "properties": { "code": { "type": "integer", "description": "业务状态码；0 表示成功。" }, "message": { "type": "string", "description": "业务状态说明。" }, "request_id": { "type": "string", "description": "请求追踪 ID。" }, "data": {} } } } }, "security": [ { "ApiKeyAuth": [] } ] }