@dsh-ft/dsh-fft-ftshare 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/catalog.json +222 -335
  2. package/catalog.meta.json +2 -2
  3. package/lib/contract.d.ts +5 -2
  4. package/lib/contract.d.ts.map +1 -1
  5. package/lib/contract.js +5 -2
  6. package/lib/contract.js.map +1 -1
  7. package/lib/index.d.ts +16 -0
  8. package/lib/index.d.ts.map +1 -1
  9. package/lib/index.js.map +1 -1
  10. package/package.json +24 -9
package/catalog.json CHANGED
@@ -3,7 +3,7 @@
3
3
  {
4
4
  "name": "ft_v1_abnormal_trading_details",
5
5
  "title": "龙虎榜明细",
6
- "description": "查询龙虎榜明细（异动成交详情），按交易日返回当日上榜标的明细：含标的涨跌幅、收盘价、成交额，以及买入额/卖出额前 5 名营业部明细。传入 `date` 时返回指定交易日的数据，不传时返回最新数据。返回数组，并补充标的名称。提示：`date` 格式 YYYYMMDD；不传返回最新快照；金额字段单位为元。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
6
+ "description": "查询龙虎榜明细，按交易日返回当日上榜标的涨跌幅、收盘价、成交额、上榜原因，以及买入额/卖出额前 5 名营业部明细；同一标的在同一交易日可能因不同上榜原因返回多条记录。传入 `date` 时返回指定交易日的数据，不传时返回最新数据。提示：`date` 格式 YYYYMMDD；不传返回最新快照；金额字段单位为元；`top_buyers`/`top_sellers` 为买入额/卖出额排名前五的营业部，源数据缺少名次时不补空位。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
7
7
  "inputSchema": {
8
8
  "type": "object",
9
9
  "properties": {
@@ -30,7 +30,7 @@
30
30
  {
31
31
  "name": "ft_v1_abnormal_trading_overview",
32
32
  "title": "龙虎榜总览",
33
- "description": "查询龙虎榜总览（异动成交概览），按交易日返回当日上榜标的的总览信息：仅含标的代码与涨跌幅，按交易所分桶（上交所 xshg / 深交所 xshe / 北交所 bjse）。传入 `date` 时返回指定交易日的数据，不传时返回最新数据。返回单对象，并补充标的名称。提示：`date` 格式 YYYYMMDD；不传返回最新快照。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
33
+ "description": "查询龙虎榜总览，按交易日返回当日上榜标的的代码、名称、涨跌幅、收盘价、成交额和上榜原因；同一标的在同一交易日可能因不同上榜原因返回多条记录，记录按上交所、深交所、北交所顺序展平为分页列表。传入 `date` 时返回指定交易日的数据，不传时返回最新数据。提示：`date` 格式 YYYYMMDD；不传返回最新快照；不含买卖营业部明细。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
34
34
  "inputSchema": {
35
35
  "type": "object",
36
36
  "properties": {
@@ -57,12 +57,12 @@
57
57
  {
58
58
  "name": "ft_v1_block_trades",
59
59
  "title": "大宗交易",
60
- "description": "查询大宗交易明细，按交易日返回当日大宗成交记录：含标的、成交价、成交量、收盘价、溢价率，以及买方/卖方营业部名称。传入 `date` 时返回指定交易日的数据，不传时返回最新数据。返回数组，并补充标的名称。提示：`date` 格式 YYYYMMDD；不传返回最新快照；价格字段（close/price）单位为元，volume 单位为股。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
60
+ "description": "查询大宗交易明细，按交易日返回当日大宗成交记录：含标的、成交价、成交量、收盘价、溢价率，以及买方/卖方营业部名称。传入 `date` 时返回指定交易日的数据，不传时返回最新数据。返回数组，并补充标的名称。提示：`date` 格式 YYYYMMDD；不传返回最新快照；价格字段（close/price）单位为元，volume 单位为股。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
61
61
  "inputSchema": {
62
62
  "type": "object",
63
63
  "properties": {
64
64
  "date": {
65
- "description": "查询日期；格式由上游接口校验，不传则使用最新快照",
65
+ "description": "查询日期，格式 `YYYYMMDD`（其他格式返回 400）；不传则使用最新快照",
66
66
  "maxLength": 4096,
67
67
  "type": "string"
68
68
  },
@@ -199,7 +199,7 @@
199
199
  },
200
200
  "page_size": {
201
201
  "default": 100,
202
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
202
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
203
203
  "maximum": 1000,
204
204
  "minimum": 1,
205
205
  "type": "integer"
@@ -449,7 +449,7 @@
449
449
  {
450
450
  "name": "ft_v1_corporate_contract_by_symbol",
451
451
  "title": "重大合同按标的",
452
- "description": "按证券代码分页查询 A 股上市公司披露的重大合同，返回合同双方、合同类型、合同名称、合同金额、占上年营收比例、签约日期和披露日期等信息。提示：`symbol` 支持纯代码、短后缀或长后缀，MCP 自动规范化；支持 `page` 和 `page_size`。",
452
+ "description": "按证券代码分页查询 A 股上市公司披露的重大合同，返回合同双方、合同类型、合同名称、合同金额、占上年营收比例、签约日期和披露日期等信息。提示：`symbol` 支持 6 位裸码或带 .SH/.SZ/.BJ/.XSHG/.XSHE/.BJSE 后缀（无法识别的代码返回 400）；支持 `page` 和 `page_size`。",
453
453
  "inputSchema": {
454
454
  "type": "object",
455
455
  "properties": {
@@ -464,11 +464,9 @@
464
464
  "type": "integer"
465
465
  },
466
466
  "symbol": {
467
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
467
+ "description": "A 股股票代码，支持裸码（如 600519）或带 .SH/.SZ/.BJ/.XSHG/.XSHE/.BJSE 后缀；无法识别的代码返回 400",
468
468
  "examples": [
469
- "000001",
470
- "000001.SZ",
471
- "000001.XSHE"
469
+ "000001"
472
470
  ],
473
471
  "maxLength": 4096,
474
472
  "type": "string"
@@ -532,7 +530,7 @@
532
530
  "type": "object",
533
531
  "properties": {
534
532
  "since": {
535
- "description": "起始日期；格式由上游接口校验",
533
+ "description": "起始日期，格式 `YYYYMMDD`（其他格式返回 400）",
536
534
  "maxLength": 4096,
537
535
  "type": "string"
538
536
  },
@@ -541,7 +539,7 @@
541
539
  "type": "string"
542
540
  },
543
541
  "until": {
544
- "description": "结束日期；格式由上游接口校验",
542
+ "description": "截止日期，格式 `YYYYMMDD`（其他格式返回 400）",
545
543
  "maxLength": 4096,
546
544
  "type": "string"
547
545
  }
@@ -637,7 +635,7 @@
637
635
  {
638
636
  "name": "ft_v1_eastmoney_board_constituents",
639
637
  "title": "东方财富板块成分股",
640
- "description": "按板块代码查询东方财富板块的成分股列表，每条记录含板块代码、板块名称、板块类型、行业层级、股票代码（6 位，不含交易所后缀）和股票名称。覆盖行业 / 概念 / 地域三类板块，当前在线 1031 个（概念 504 / 行业 496 / 地域 31）；最大板块（如融资融券 3876 只）需翻页取全。成分股进出记录自 20260929 起采集、无历史回填；查询日早于该板块首次采集日时按首次采集日当天的在籍名单返回，不返回空。提示：`board_code` 必填，取东方财富板块代码（BK 开头，如 BK0475 银行Ⅱ、BK0490 军工、BK0153 广东板块），代码不存在时返回 400；不传 `date` 返回当前仍在板块内的成分股，传 `date` 返回截至该日的成分股（含此后已退出的）；返回的 `board_type` 取值为 industry 行业 / concept 概念 / regional 地域（地域拼写是 regional 不是 region）；`level` 仅行业板块有值（1 一级 / 2 二级 / 3 三级），概念、地域板块为 null；结果按 `stock_code` 升序。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page` 0 按 1 处理，`page_size` 0 按 1 处理、超过 500 按 500 处理。",
638
+ "description": "按板块代码查询东方财富板块的成分股列表，每条记录含板块代码、板块名称、板块类型、行业层级、股票代码（6 位，不含交易所后缀）和股票名称。覆盖行业 / 概念 / 地域三类板块，当前在线 1031 个（概念 504 / 行业 496 / 地域 31）；最大板块（如融资融券 3876 只）需翻页取全。成分股进出记录自 20260929 起采集、无历史回填；查询日早于该板块首次采集日时按首次采集日当天的在籍名单返回，不返回空。提示：`board_code` 必填，取东方财富板块代码（BK 开头，如 BK0475 银行Ⅱ、BK0490 军工、BK0153 广东板块），代码不存在时返回 400；不传 `date` 返回当前仍在板块内的成分股，传 `date` 返回截至该日的成分股（含此后已退出的）；返回的 `board_type` 取值为 industry 行业 / concept 概念 / regional 地域（地域拼写是 regional 不是 region）；`level` 仅行业板块有值（1 一级 / 2 二级 / 3 三级），概念、地域板块为 null；结果按 `stock_code` 升序。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page` 0 按 1 处理，`page_size` 0 按 1 处理、超过 500 按 500 处理。",
641
639
  "inputSchema": {
642
640
  "type": "object",
643
641
  "properties": {
@@ -671,7 +669,7 @@
671
669
  {
672
670
  "name": "ft_v1_eastmoney_board_daily_ohlc",
673
671
  "title": "东方财富板块日线OHLC",
674
- "description": "查询单个东方财富概念板块的历史日线 OHLC，返回开盘、收盘、最高、最低、成交量、成交额、振幅、涨跌幅和换手率等指标。提示：`board_code` 必填；`start_date` 和 `end_date` 可选，支持 YYYY-MM-DD 或 YYYYMMDD，同时传入时跨度不能超过 3 天；支持分页。",
672
+ "description": "查询单个东方财富概念板块的历史日线 OHLC，返回开盘、收盘、最高、最低、成交量、成交额、振幅、涨跌幅和换手率等指标。提示：`board_code` 必填；`start_date` 和 `end_date` 可选，格式 `YYYYMMDD`（其他格式返回 400），同时传入时跨度不能超过 3 天；支持分页。",
675
673
  "inputSchema": {
676
674
  "type": "object",
677
675
  "properties": {
@@ -681,7 +679,7 @@
681
679
  "type": "string"
682
680
  },
683
681
  "end_date": {
684
- "description": "截止日期（含）；不能早于 start_date",
682
+ "description": "截止日期（含），格式 `YYYYMMDD`；不能早于 start_date",
685
683
  "maxLength": 4096,
686
684
  "type": "string"
687
685
  },
@@ -696,7 +694,7 @@
696
694
  "type": "integer"
697
695
  },
698
696
  "start_date": {
699
- "description": "起始日期（含）；与 end_date 的跨度不能超过 3 天",
697
+ "description": "起始日期（含），格式 `YYYYMMDD`；与 end_date 的跨度不能超过 3 天",
700
698
  "maxLength": 4096,
701
699
  "type": "string"
702
700
  }
@@ -721,12 +719,12 @@
721
719
  {
722
720
  "name": "ft_v1_eastmoney_dapan_flow",
723
721
  "title": "东方财富大盘资金流",
724
- "description": "查询东方财富沪深市场日资金流，返回主力、超大单、大单、中单和小单的净流入及占比，以及上证、深证收盘点位和涨跌幅。提示：`trade_date` 与 `start_date`/`end_date` 互斥；资金净流入以元为单位。",
722
+ "description": "查询东方财富沪深市场日资金流，返回主力、超大单、大单、中单和小单的净流入及占比，以及上证、深证收盘点位和涨跌幅。提示：`trade_date` 与 `start_date`/`end_date` 同时提供时按交集过滤，区间可只提供单端；资金净流入以元为单位。",
725
723
  "inputSchema": {
726
724
  "type": "object",
727
725
  "properties": {
728
726
  "end_date": {
729
- "description": "区间结束日 YYYYMMDD；需与 start_date 同时提供",
727
+ "description": "区间结束日 YYYYMMDD；可只提供单端",
730
728
  "maxLength": 4096,
731
729
  "type": "string"
732
730
  },
@@ -738,18 +736,18 @@
738
736
  },
739
737
  "page_size": {
740
738
  "default": 50,
741
- "description": "每页条数；缺省 50，1 到 500，超出范围上游返回参数错误",
739
+ "description": "每页条数；缺省 50，1 到 500，超出范围返回参数错误",
742
740
  "maximum": 500,
743
741
  "minimum": 1,
744
742
  "type": "integer"
745
743
  },
746
744
  "start_date": {
747
- "description": "区间起始日 YYYYMMDD；需与 end_date 同时提供",
745
+ "description": "区间起始日 YYYYMMDD；可只提供单端",
748
746
  "maxLength": 4096,
749
747
  "type": "string"
750
748
  },
751
749
  "trade_date": {
752
- "description": "交易日 YYYYMMDD；与 start_date/end_date 互斥",
750
+ "description": "交易日 YYYYMMDD；与区间条件同时提供时按交集过滤",
753
751
  "maxLength": 4096,
754
752
  "type": "string"
755
753
  }
@@ -766,7 +764,7 @@
766
764
  "type": "object",
767
765
  "properties": {
768
766
  "end_date": {
769
- "description": "区间结束日 YYYYMMDD；需与 start_date 同时提供",
767
+ "description": "区间结束日 YYYYMMDD；可只提供单端",
770
768
  "maxLength": 4096,
771
769
  "type": "string"
772
770
  },
@@ -778,13 +776,13 @@
778
776
  },
779
777
  "page_size": {
780
778
  "default": 100,
781
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
779
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
782
780
  "maximum": 1000,
783
781
  "minimum": 1,
784
782
  "type": "integer"
785
783
  },
786
784
  "start_date": {
787
- "description": "区间起始日 YYYYMMDD；需与 end_date 同时提供",
785
+ "description": "区间起始日 YYYYMMDD；可只提供单端",
788
786
  "maxLength": 4096,
789
787
  "type": "string"
790
788
  },
@@ -794,7 +792,7 @@
794
792
  "type": "string"
795
793
  },
796
794
  "trade_date": {
797
- "description": "交易日 YYYYMMDD；与 start_date/end_date 互斥",
795
+ "description": "交易日 YYYYMMDD；与区间条件同时提供时按交集过滤",
798
796
  "maxLength": 4096,
799
797
  "type": "string"
800
798
  }
@@ -806,7 +804,7 @@
806
804
  {
807
805
  "name": "ft_v1_eastmoney_futures_position",
808
806
  "title": "东方财富期货持仓",
809
- "description": "获取东方财富期货每日成交持仓排行榜数据，按合约/会员维度给出成交量、多头、空头、净多头、净空头的排名与持仓量及变化，含多头增/减仓、空头增/减仓排名，以及结算价、多头/空头平均价。数据来源：东方财富。支持按交易所、品种、合约、会员、交易日或日期区间过滤。提示：每个合约每个交易日下会有多会员多行，总量较大，建议按合约+日期精准过滤；`trade_date` 与 `start_date`/`end_date` 互斥。",
807
+ "description": "获取东方财富期货每日成交持仓排行榜数据，按合约/会员维度给出成交量、多头、空头、净多头、净空头的排名与持仓量及变化，含多头增/减仓、空头增/减仓排名，以及结算价、多头/空头平均价。数据来源：东方财富。支持按交易所、品种、合约、会员、交易日或日期区间过滤。提示：每个合约每个交易日下会有多会员多行，总量较大，建议按合约+日期精准过滤；`trade_date` 与 `start_date`/`end_date` 同时提供时按交集过滤，区间可只提供单端。",
810
808
  "inputSchema": {
811
809
  "type": "object",
812
810
  "properties": {
@@ -816,7 +814,7 @@
816
814
  "type": "string"
817
815
  },
818
816
  "end_date": {
819
- "description": "区间结束日 YYYYMMDD；需与 start_date 同时提供",
817
+ "description": "区间结束日 YYYYMMDD；可只提供单端",
820
818
  "maxLength": 4096,
821
819
  "type": "string"
822
820
  },
@@ -838,18 +836,18 @@
838
836
  },
839
837
  "page_size": {
840
838
  "default": 50,
841
- "description": "每页条数；缺省 50，1 到 500，超出范围上游返回参数错误",
839
+ "description": "每页条数；缺省 50，1 到 500，超出范围返回参数错误",
842
840
  "maximum": 500,
843
841
  "minimum": 1,
844
842
  "type": "integer"
845
843
  },
846
844
  "start_date": {
847
- "description": "区间起始日 YYYYMMDD；需与 end_date 同时提供",
845
+ "description": "区间起始日 YYYYMMDD；可只提供单端",
848
846
  "maxLength": 4096,
849
847
  "type": "string"
850
848
  },
851
849
  "trade_date": {
852
- "description": "交易日 YYYYMMDD；与 start_date/end_date 互斥",
850
+ "description": "交易日 YYYYMMDD；与区间条件同时提供时按交集过滤",
853
851
  "maxLength": 4096,
854
852
  "type": "string"
855
853
  },
@@ -925,7 +923,7 @@
925
923
  },
926
924
  "page_size": {
927
925
  "default": 50,
928
- "description": "每页条数；缺省 50，1 到 500，超出范围上游返回参数错误",
926
+ "description": "每页条数；缺省 50，1 到 500，超出范围返回参数错误",
929
927
  "maximum": 500,
930
928
  "minimum": 1,
931
929
  "type": "integer"
@@ -975,7 +973,7 @@
975
973
  {
976
974
  "name": "ft_v1_eastmoney_sector_flow",
977
975
  "title": "东方财富板块资金流",
978
- "description": "获取东方财富板块（行业/概念/地域）日资金流数据，含主力/超大单/大单/中单/小单四档净流入及净占比。数据来源：东方财富。支持按板块代码（BK0488 等）、板块类型（industry/concept/regional）、行业层级、交易日或日期区间过滤，返回字段为 `board_code`/`board_name`/`board_type`/`board_level`。提示：`board_code` 为东财板块代码，以 BK 开头（如 BK0488）；`board_level` 行业层级 1=一级、2=二级、3=三级，概念/地域板块为 0；`trade_date` 与 `start_date`/`end_date` 互斥。",
976
+ "description": "获取东方财富板块（行业/概念/地域）日资金流数据，含主力/超大单/大单/中单/小单四档净流入及净占比。数据来源：东方财富。支持按板块代码（BK0488 等）、板块类型（industry/concept/regional）、行业层级、交易日或日期区间过滤，返回字段为 `board_code`/`board_name`/`board_type`/`board_level`。提示：`board_code` 为东财板块代码，以 BK 开头（如 BK0488）；`board_level` 行业层级 1=一级、2=二级、3=三级，概念/地域板块为 0；`trade_date` 与 `start_date`/`end_date` 同时提供时按交集过滤，区间可只提供单端。",
979
977
  "inputSchema": {
980
978
  "type": "object",
981
979
  "properties": {
@@ -996,7 +994,7 @@
996
994
  "type": "string"
997
995
  },
998
996
  "end_date": {
999
- "description": "区间结束日 YYYYMMDD；需与 start_date 同时提供",
997
+ "description": "区间结束日 YYYYMMDD；可只提供单端",
1000
998
  "maxLength": 4096,
1001
999
  "type": "string"
1002
1000
  },
@@ -1008,18 +1006,18 @@
1008
1006
  },
1009
1007
  "page_size": {
1010
1008
  "default": 50,
1011
- "description": "每页条数；缺省 50，1 到 500，超出范围上游返回参数错误",
1009
+ "description": "每页条数；缺省 50，1 到 500，超出范围返回参数错误",
1012
1010
  "maximum": 500,
1013
1011
  "minimum": 1,
1014
1012
  "type": "integer"
1015
1013
  },
1016
1014
  "start_date": {
1017
- "description": "区间起始日 YYYYMMDD；需与 end_date 同时提供",
1015
+ "description": "区间起始日 YYYYMMDD；可只提供单端",
1018
1016
  "maxLength": 4096,
1019
1017
  "type": "string"
1020
1018
  },
1021
1019
  "trade_date": {
1022
- "description": "交易日 YYYYMMDD；与 start_date/end_date 互斥",
1020
+ "description": "交易日 YYYYMMDD；与区间条件同时提供时按交集过滤",
1023
1021
  "maxLength": 4096,
1024
1022
  "type": "string"
1025
1023
  }
@@ -1031,15 +1029,14 @@
1031
1029
  {
1032
1030
  "name": "ft_v1_eastmoney_stock_flow",
1033
1031
  "title": "东方财富个股资金流",
1034
- "description": "获取东方财富个股日资金流数据，含主力、超大单、大单、中单和小单净流入及净占比，以及收盘价与涨跌幅。可按股票代码、单日或日期区间过滤；`trade_date` 与 `start_date`/`end_date` 互斥，区间起止日期必须同时提供。股票代码由上游按 A 股代码规则解析，日期格式由上游校验。",
1032
+ "description": "获取东方财富个股日资金流数据，含主力、超大单、大单、中单和小单净流入及净占比，以及收盘价与涨跌幅。可按股票代码、单日或日期区间过滤；`trade_date` 与 `start_date`/`end_date` 同时提供时按交集过滤，区间可只提供单端。股票代码支持 6 位裸码或带 `.SH/.SZ/.BJ/.XSHG/.XSHE/.BJSE` 后缀（无法识别的代码返回 400）；日期格式 `YYYYMMDD`（其他格式返回 400）。",
1035
1033
  "inputSchema": {
1036
1034
  "type": "object",
1037
1035
  "properties": {
1038
1036
  "end_date": {
1039
- "description": "区间结束日；格式由上游校验",
1037
+ "description": "区间结束日，格式 `YYYYMMDD`（其他格式返回 400）",
1040
1038
  "examples": [
1041
- "20260812",
1042
- "2026-08-12"
1039
+ "20260812"
1043
1040
  ],
1044
1041
  "maxLength": 4096,
1045
1042
  "type": "string"
@@ -1052,131 +1049,49 @@
1052
1049
  },
1053
1050
  "page_size": {
1054
1051
  "default": 50,
1055
- "description": "每页条数；缺省 50，1 到 500，超出范围上游返回参数错误",
1052
+ "description": "每页条数；缺省 50，1 到 500，超出范围返回参数错误",
1056
1053
  "maximum": 500,
1057
1054
  "minimum": 1,
1058
1055
  "type": "integer"
1059
1056
  },
1060
1057
  "start_date": {
1061
- "description": "区间起始日；格式由上游校验",
1058
+ "description": "区间起始日，格式 `YYYYMMDD`（其他格式返回 400）",
1062
1059
  "examples": [
1063
- "20260812",
1064
- "2026-08-12"
1060
+ "20260812"
1065
1061
  ],
1066
1062
  "maxLength": 4096,
1067
1063
  "type": "string"
1068
1064
  },
1069
1065
  "symbol": {
1070
- "description": "A 股股票代码；支持上游可解析的纯代码或交易所后缀格式",
1066
+ "description": "A 股股票代码，支持裸码（如 600519）或带 .SH/.SZ/.BJ/.XSHG/.XSHE/.BJSE 后缀；无法识别的代码返回 400",
1071
1067
  "examples": [
1072
- "000001",
1073
- "000001.SZ",
1074
- "000001.XSHE"
1068
+ "000001"
1075
1069
  ],
1076
1070
  "maxLength": 4096,
1077
1071
  "type": "string"
1078
1072
  },
1079
1073
  "trade_date": {
1080
- "description": "交易日；格式由上游校验",
1074
+ "description": "交易日，格式 `YYYYMMDD`（其他格式返回 400）",
1081
1075
  "examples": [
1082
- "20260812",
1083
- "2026-08-12"
1076
+ "20260812"
1084
1077
  ],
1085
1078
  "maxLength": 4096,
1086
1079
  "type": "string"
1087
1080
  }
1088
1081
  },
1089
1082
  "required": [],
1090
- "additionalProperties": false,
1091
- "oneOf": [
1092
- {
1093
- "not": {
1094
- "anyOf": [
1095
- {
1096
- "properties": {
1097
- "trade_date": {}
1098
- },
1099
- "required": [
1100
- "trade_date"
1101
- ]
1102
- },
1103
- {
1104
- "properties": {
1105
- "start_date": {}
1106
- },
1107
- "required": [
1108
- "start_date"
1109
- ]
1110
- },
1111
- {
1112
- "properties": {
1113
- "end_date": {}
1114
- },
1115
- "required": [
1116
- "end_date"
1117
- ]
1118
- }
1119
- ]
1120
- }
1121
- },
1122
- {
1123
- "not": {
1124
- "anyOf": [
1125
- {
1126
- "properties": {
1127
- "start_date": {}
1128
- },
1129
- "required": [
1130
- "start_date"
1131
- ]
1132
- },
1133
- {
1134
- "properties": {
1135
- "end_date": {}
1136
- },
1137
- "required": [
1138
- "end_date"
1139
- ]
1140
- }
1141
- ]
1142
- },
1143
- "properties": {
1144
- "trade_date": {}
1145
- },
1146
- "required": [
1147
- "trade_date"
1148
- ]
1149
- },
1150
- {
1151
- "not": {
1152
- "properties": {
1153
- "trade_date": {}
1154
- },
1155
- "required": [
1156
- "trade_date"
1157
- ]
1158
- },
1159
- "properties": {
1160
- "end_date": {},
1161
- "start_date": {}
1162
- },
1163
- "required": [
1164
- "start_date",
1165
- "end_date"
1166
- ]
1167
- }
1168
- ]
1083
+ "additionalProperties": false
1169
1084
  }
1170
1085
  },
1171
1086
  {
1172
1087
  "name": "ft_v1_eastmoney_stock_valuation",
1173
1088
  "title": "东方财富个股估值",
1174
- "description": "查询东方财富 A 股个股日估值，返回市盈率、市净率、市现率、市销率、PEG、市值和股本等指标。提示：`symbol` 支持纯代码、短后缀或长后缀，MCP 自动规范化；必须提供 `symbol`、`trade_date` 或 `start_date + end_date` 其中一种过滤条件；估值字段可能为空。",
1089
+ "description": "查询东方财富 A 股个股日估值，返回市盈率、市净率、市现率、市销率、PEG、市值和股本等指标。提示：`symbol` 需传 6 位纯代码（如 600519），带交易所后缀查不到数据；必须提供 `symbol`、`trade_date` 或 `start_date + end_date` 其中一种过滤条件；估值字段可能为空。",
1175
1090
  "inputSchema": {
1176
1091
  "type": "object",
1177
1092
  "properties": {
1178
1093
  "end_date": {
1179
- "description": "区间结束日 YYYYMMDD；需与 start_date 同时提供",
1094
+ "description": "区间结束日 YYYYMMDD；可只提供单端",
1180
1095
  "maxLength": 4096,
1181
1096
  "type": "string"
1182
1097
  },
@@ -1188,28 +1103,26 @@
1188
1103
  },
1189
1104
  "page_size": {
1190
1105
  "default": 50,
1191
- "description": "每页条数；缺省 50，1 到 200，超出范围上游返回参数错误",
1106
+ "description": "每页条数；缺省 50，1 到 200，超出范围返回参数错误",
1192
1107
  "maximum": 200,
1193
1108
  "minimum": 1,
1194
1109
  "type": "integer"
1195
1110
  },
1196
1111
  "start_date": {
1197
- "description": "区间起始日 YYYYMMDD；需与 end_date 同时提供",
1112
+ "description": "区间起始日 YYYYMMDD；可只提供单端",
1198
1113
  "maxLength": 4096,
1199
1114
  "type": "string"
1200
1115
  },
1201
1116
  "symbol": {
1202
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
1117
+ "description": "A 股股票代码，6 位纯代码（如 600519）；带交易所后缀查不到数据",
1203
1118
  "examples": [
1204
- "000001",
1205
- "000001.SZ",
1206
- "000001.XSHE"
1119
+ "000001"
1207
1120
  ],
1208
1121
  "maxLength": 4096,
1209
1122
  "type": "string"
1210
1123
  },
1211
1124
  "trade_date": {
1212
- "description": "交易日 YYYYMMDD；与 start_date/end_date 互斥",
1125
+ "description": "交易日 YYYYMMDD；与 start_date/end_date 同时提供时按交集过滤",
1213
1126
  "maxLength": 4096,
1214
1127
  "type": "string"
1215
1128
  }
@@ -1221,7 +1134,7 @@
1221
1134
  {
1222
1135
  "name": "ft_v1_eastmoney_us_stock_daily_ohlc",
1223
1136
  "title": "东方财富美股日OHLC",
1224
- "description": "查询东方财富美股日 K 线，返回开盘、收盘、最高、最低、成交量和成交额等指标。支持四种模式：按股票和日期查询历史区间、仅按股票查询最新记录、仅按日期查询全市场历史切片、无筛选查询各股票最新记录。日期区间跨度不能超过 3 天；分页参数由上游归一化。",
1137
+ "description": "查询东方财富美股日 K 线，返回开盘、收盘、最高、最低、成交量和成交额等指标。支持四种模式：按股票和日期查询历史区间、仅按股票查询最新记录、仅按日期查询全市场历史切片、无筛选查询各股票最新记录。日期区间跨度不能超过 3 天；分页参数 0 按 1 处理、超过上限按上限处理。",
1225
1138
  "inputSchema": {
1226
1139
  "type": "object",
1227
1140
  "properties": {
@@ -1283,7 +1196,7 @@
1283
1196
  {
1284
1197
  "name": "ft_v1_economic_china_cpi",
1285
1198
  "title": "CPI",
1286
- "description": "查询中国居民消费价格指数（CPI）月度汇总计算结果。按月份返回全国（含累计同比）、城市、农村三档 CPI 同比/环比/当月值。元素为 `ComputedCpi`。提示：月份字段 `month` 已格式化为中文「YYYY年MM月份」；数值字段单位为百分比（%），部分月份字段缺失时为 null。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1199
+ "description": "查询中国居民消费价格指数（CPI）月度汇总计算结果。按月份返回全国（含累计同比）、城市、农村三档 CPI 同比/环比/当月值。元素为 `ComputedCpi`。提示：月份字段 `month` 已格式化为中文「YYYY年MM月份」；数值字段单位为百分比（%），部分月份字段缺失时为 null。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1287
1200
  "inputSchema": {
1288
1201
  "type": "object",
1289
1202
  "properties": {
@@ -1305,7 +1218,7 @@
1305
1218
  {
1306
1219
  "name": "ft_v1_economic_china_credit_loans",
1307
1220
  "title": "社融信贷",
1308
- "description": "查询中国信贷数据（月度汇总计算结果。按月份返回新增信贷当月值、同比、环比、当年累计及累计同比。数据按月聚合。提示：`month` 格式化为「YYYY年MM月份」；金额字段单位见 `unit`（通常为亿元），币种见 `currency`。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1221
+ "description": "查询中国信贷数据（月度汇总计算结果。按月份返回新增信贷当月值、同比、环比、当年累计及累计同比。数据按月聚合。提示：`month` 格式化为「YYYY年MM月份」；金额字段单位见 `unit`（通常为亿元），币种见 `currency`。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1309
1222
  "inputSchema": {
1310
1223
  "type": "object",
1311
1224
  "properties": {
@@ -1471,7 +1384,7 @@
1471
1384
  {
1472
1385
  "name": "ft_v1_economic_china_money_supply",
1473
1386
  "title": "货币供应",
1474
- "description": "查询中国货币供应量（M0/M1/M2）月度汇总计算结果。按月份返回 M2、M1、M0 各自的当月数量、同比、环比。数据按月聚合。提示：`month` 格式化为「YYYY年MM月份」；数量单位见 `unit`（通常为万亿元），币种见 `currency`。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1387
+ "description": "查询中国货币供应量（M0/M1/M2）月度汇总计算结果。按月份返回 M2、M1、M0 各自的当月数量、同比、环比。数据按月聚合。提示：`month` 格式化为「YYYY年MM月份」；数量单位见 `unit`（通常为万亿元），币种见 `currency`。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1475
1388
  "inputSchema": {
1476
1389
  "type": "object",
1477
1390
  "properties": {
@@ -1493,7 +1406,7 @@
1493
1406
  {
1494
1407
  "name": "ft_v1_economic_china_pmi",
1495
1408
  "title": "PMI",
1496
- "description": "查询中国采购经理指数（PMI）月度汇总计算结果，覆盖制造业与非制造业。按月份返回制造业/非制造业 PMI 当月值、同比、环比。数据按月聚合。提示：`month` 格式化为「YYYY年MM月份」；PMI 数值单位为百分比（%），缺失为 null。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1409
+ "description": "查询中国采购经理指数（PMI）月度汇总计算结果，覆盖制造业与非制造业。按月份返回制造业/非制造业 PMI 当月值、同比、环比。数据按月聚合。提示：`month` 格式化为「YYYY年MM月份」；PMI 数值单位为百分比（%），缺失为 null。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
1497
1410
  "inputSchema": {
1498
1411
  "type": "object",
1499
1412
  "properties": {
@@ -1732,7 +1645,7 @@
1732
1645
  "type": "integer"
1733
1646
  },
1734
1647
  "symbol": {
1735
- "description": "ETF 代码；格式由上游标的解析器校验",
1648
+ "description": "ETF 代码；支持不带后缀的六位代码（如 `510300`）或带 `.SH/.SZ`、`.XSHG/.XSHE` 市场后缀；无法识别的代码返回 400",
1736
1649
  "maxLength": 4096,
1737
1650
  "type": "string"
1738
1651
  },
@@ -1780,7 +1693,7 @@
1780
1693
  "type": "object",
1781
1694
  "properties": {
1782
1695
  "end_date": {
1783
- "description": "结束日期；格式由上游接口校验",
1696
+ "description": "结束日期，格式 `YYYYMMDD`（其他格式返回 400）",
1784
1697
  "maxLength": 4096,
1785
1698
  "type": "string"
1786
1699
  },
@@ -1796,13 +1709,13 @@
1796
1709
  },
1797
1710
  "page_size": {
1798
1711
  "default": 100,
1799
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
1712
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
1800
1713
  "maximum": 1000,
1801
1714
  "minimum": 1,
1802
1715
  "type": "integer"
1803
1716
  },
1804
1717
  "start_date": {
1805
- "description": "起始日期；格式由上游接口校验",
1718
+ "description": "起始日期，格式 `YYYYMMDD`（其他格式返回 400）",
1806
1719
  "maxLength": 4096,
1807
1720
  "type": "string"
1808
1721
  }
@@ -1817,7 +1730,7 @@
1817
1730
  {
1818
1731
  "name": "ft_v1_finance_balance",
1819
1732
  "title": "A股资产负债表",
1820
- "description": "查询 A 股上市公司资产负债表。支持按 `stock_code` 查询单票全部报告期，或按 `year + report_type` 分页查询指定报告期。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀，MCP 自动转换为 `.SH/.SZ/.BJ`；传入 `stock_code` 时单票模式优先，返回全部报告期且不受分页参数限制；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `h1`（半年报兼容写法，按 `q2` 返回）。",
1733
+ "description": "查询 A 股上市公司资产负债表。支持按 `stock_code` 查询单票全部报告期，或按 `year + report_type` 分页查询指定报告期。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀；传入 `stock_code` 时单票模式优先，返回全部报告期且不受分页参数限制；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `h1`（半年报兼容写法，按 `q2` 返回）。",
1821
1734
  "inputSchema": {
1822
1735
  "type": "object",
1823
1736
  "properties": {
@@ -1844,7 +1757,7 @@
1844
1757
  "type": "string"
1845
1758
  },
1846
1759
  "stock_code": {
1847
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
1760
+ "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀",
1848
1761
  "examples": [
1849
1762
  "000001",
1850
1763
  "000001.SZ",
@@ -1886,7 +1799,7 @@
1886
1799
  {
1887
1800
  "name": "ft_v1_finance_cashflow",
1888
1801
  "title": "A股现金流量表",
1889
- "description": "查询 A 股上市公司现金流量表。支持按 `stock_code` 查询单票全部报告期，或按 `year + report_type` 分页查询指定报告期。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀，MCP 自动转换为 `.SH/.SZ/.BJ`；传入 `stock_code` 时单票模式优先，返回全部报告期且不受分页参数限制；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `h1`（半年报兼容写法，按 `q2` 返回）。",
1802
+ "description": "查询 A 股上市公司现金流量表。支持按 `stock_code` 查询单票全部报告期，或按 `year + report_type` 分页查询指定报告期。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀；传入 `stock_code` 时单票模式优先，返回全部报告期且不受分页参数限制；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `h1`（半年报兼容写法，按 `q2` 返回）。",
1890
1803
  "inputSchema": {
1891
1804
  "type": "object",
1892
1805
  "properties": {
@@ -1913,7 +1826,7 @@
1913
1826
  "type": "string"
1914
1827
  },
1915
1828
  "stock_code": {
1916
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
1829
+ "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀",
1917
1830
  "examples": [
1918
1831
  "000001",
1919
1832
  "000001.SZ",
@@ -2028,7 +1941,7 @@
2028
1941
  {
2029
1942
  "name": "ft_v1_finance_income",
2030
1943
  "title": "A股利润表",
2031
- "description": "查询 A 股上市公司利润表。支持按 `stock_code` 查询单票全部报告期，或按 `year + report_type` 分页查询指定报告期。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀，MCP 自动转换为 `.SH/.SZ/.BJ`；传入 `stock_code` 时单票模式优先，返回全部报告期且不受分页参数限制；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `h1`（半年报兼容写法，按 `q2` 返回）。",
1944
+ "description": "查询 A 股上市公司利润表。支持按 `stock_code` 查询单票全部报告期，或按 `year + report_type` 分页查询指定报告期。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀；传入 `stock_code` 时单票模式优先，返回全部报告期且不受分页参数限制；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `h1`（半年报兼容写法，按 `q2` 返回）。",
2032
1945
  "inputSchema": {
2033
1946
  "type": "object",
2034
1947
  "properties": {
@@ -2055,7 +1968,7 @@
2055
1968
  "type": "string"
2056
1969
  },
2057
1970
  "stock_code": {
2058
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
1971
+ "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀",
2059
1972
  "examples": [
2060
1973
  "000001",
2061
1974
  "000001.SZ",
@@ -2097,7 +2010,7 @@
2097
2010
  {
2098
2011
  "name": "ft_v1_finance_stock_performance_express",
2099
2012
  "title": "业绩快报",
2100
- "description": "查询 A 股业绩快报，返回 EPS、营业收入、净利润、ROE 及同比变化等指标。支持按 `stock_code` 查询单票历史，或按 `year + report_type` 分页查询指定报告期。提示：`stock_code` 支持纯代码、短后缀或长后缀，MCP 自动转换为 `.SH/.SZ/.BJ`，传入时单票模式优先；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `announcement`（公告类型）；`page/page_size` 可省略，默认 1/50。",
2013
+ "description": "查询 A 股业绩快报，返回 EPS、营业收入、净利润、ROE 及同比变化等指标。支持按 `stock_code` 查询单票历史，或按 `year + report_type` 分页查询指定报告期。提示：`stock_code` 需传 6 位代码.大写短后缀（如 600519.SH），裸码、长后缀或交易所不匹配时查不到数据，传入时单票模式优先；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）、`annual`（年报）和 `announcement`（公告类型）；`page/page_size` 可省略，默认 1/50。",
2101
2014
  "inputSchema": {
2102
2015
  "type": "object",
2103
2016
  "properties": {
@@ -2124,11 +2037,9 @@
2124
2037
  "type": "string"
2125
2038
  },
2126
2039
  "stock_code": {
2127
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
2040
+ "description": "A 股股票代码，需 6 位代码.大写短后缀（如 600519.SH）；裸码、长后缀或交易所不匹配时查不到数据",
2128
2041
  "examples": [
2129
- "000001",
2130
- "000001.SZ",
2131
- "000001.XSHE"
2042
+ "000001.SZ"
2132
2043
  ],
2133
2044
  "maxLength": 4096,
2134
2045
  "type": "string"
@@ -2166,7 +2077,7 @@
2166
2077
  {
2167
2078
  "name": "ft_v1_finance_stock_performance_forecast",
2168
2079
  "title": "业绩预告",
2169
- "description": "查询 A 股上市公司业绩预告，返回预告类型、预测值区间和同比变化区间等指标。支持按 `stock_code` 查询单票历史，或按 `year + report_type` 分页查询指定报告期。提示：`stock_code` 支持纯代码、短后缀或长后缀，MCP 自动转换为 `.SH/.SZ/.BJ`，传入时单票模式优先；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）和 `annual`（年报）；`page/page_size` 可省略，默认 1/50。",
2080
+ "description": "查询 A 股上市公司业绩预告，返回预告类型、预测值区间和同比变化区间等指标。支持按 `stock_code` 查询单票历史，或按 `year + report_type` 分页查询指定报告期。提示：`stock_code` 需传 6 位代码.大写短后缀（如 600519.SH），裸码、长后缀或交易所不匹配时查不到数据，传入时单票模式优先；报告期模式要求 `year + report_type`，其中 `report_type` 支持 `q1`（一季报）、`q2`（半年报）、`q3`（三季报）和 `annual`（年报）；`page/page_size` 可省略，默认 1/50。",
2170
2081
  "inputSchema": {
2171
2082
  "type": "object",
2172
2083
  "properties": {
@@ -2192,11 +2103,9 @@
2192
2103
  "type": "string"
2193
2104
  },
2194
2105
  "stock_code": {
2195
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
2106
+ "description": "A 股股票代码，需 6 位代码.大写短后缀（如 600519.SH）；裸码、长后缀或交易所不匹配时查不到数据",
2196
2107
  "examples": [
2197
- "000001",
2198
- "000001.SZ",
2199
- "000001.XSHE"
2108
+ "000001.SZ"
2200
2109
  ],
2201
2110
  "maxLength": 4096,
2202
2111
  "type": "string"
@@ -3126,7 +3035,7 @@
3126
3035
  {
3127
3036
  "name": "ft_v1_futures_ft_limit",
3128
3037
  "title": "期货涨跌停价格",
3129
- "description": "查询指定交易所的期货合约涨跌停价格。`exchange` 必填；必须传单个 `trade_date`，或同时传 `start_date`/`end_date`，两种日期模式不能混用，日期范围由上游校验。支持按合约代码和品种代码过滤及分页。",
3038
+ "description": "查询指定交易所的期货合约涨跌停价格。`exchange` 必填；必须传单个 `trade_date`，或同时传 `start_date`/`end_date`，两种日期模式不能混用，`start_date`/`end_date` 间隔不能超过 31 天（超出返回参数错误）。支持按合约代码和品种代码过滤及分页。",
3130
3039
  "inputSchema": {
3131
3040
  "type": "object",
3132
3041
  "properties": {
@@ -3225,7 +3134,7 @@
3225
3134
  {
3226
3135
  "name": "ft_v1_futures_fut_settle",
3227
3136
  "title": "期货每日结算参数",
3228
- "description": "查询指定交易所的期货每日结算参数，包括结算价、手续费、交割费和保证金率。`exchange` 必填；必须传单个 `trade_date`，或同时传 `start_date`/`end_date`，两种日期模式不能混用，日期范围由上游校验。支持按合约过滤及分页。",
3137
+ "description": "查询指定交易所的期货每日结算参数，包括结算价、手续费、交割费和保证金率。`exchange` 必填；必须传单个 `trade_date`，或同时传 `start_date`/`end_date`，两种日期模式不能混用，`start_date`/`end_date` 间隔不能超过 31 天（超出返回参数错误）。支持按合约过滤及分页。",
3229
3138
  "inputSchema": {
3230
3139
  "type": "object",
3231
3140
  "properties": {
@@ -3529,7 +3438,7 @@
3529
3438
  },
3530
3439
  "page_size": {
3531
3440
  "default": 50,
3532
- "description": "每页数量，默认 50，1 到 200，超出范围上游返回参数错误",
3441
+ "description": "每页数量，默认 50，1 到 200，超出范围返回参数错误",
3533
3442
  "maximum": 200,
3534
3443
  "minimum": 1,
3535
3444
  "type": "integer"
@@ -3557,7 +3466,7 @@
3557
3466
  "type": "object",
3558
3467
  "properties": {
3559
3468
  "end_date": {
3560
- "description": "结束日期 YYYY-MM-DD（含）",
3469
+ "description": "结束日期 `YYYY-MM-DD` 或 `YYYYMMDD`（含）",
3561
3470
  "maxLength": 4096,
3562
3471
  "type": "string"
3563
3472
  },
@@ -3573,7 +3482,7 @@
3573
3482
  "type": "string"
3574
3483
  },
3575
3484
  "start_date": {
3576
- "description": "开始日期 YYYY-MM-DD（含）",
3485
+ "description": "开始日期 `YYYY-MM-DD` 或 `YYYYMMDD`（含）",
3577
3486
  "maxLength": 4096,
3578
3487
  "type": "string"
3579
3488
  }
@@ -3728,7 +3637,7 @@
3728
3637
  },
3729
3638
  "page_size": {
3730
3639
  "default": 100,
3731
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
3640
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
3732
3641
  "maximum": 1000,
3733
3642
  "minimum": 1,
3734
3643
  "type": "integer"
@@ -4148,7 +4057,7 @@
4148
4057
  "type": "integer"
4149
4058
  },
4150
4059
  "symbol": {
4151
- "description": "指数代码，如 000300.SH、932000.CSI（中证指数须带 .CSI 后缀）；格式由上游标的解析器校验",
4060
+ "description": "指数代码，如 000300.SH、932000.CSI（中证指数须带 .CSI 后缀）",
4152
4061
  "maxLength": 4096,
4153
4062
  "type": "string"
4154
4063
  },
@@ -4170,7 +4079,7 @@
4170
4079
  {
4171
4080
  "name": "ft_v1_index_description_all",
4172
4081
  "title": "指数基础信息",
4173
- "description": "获取全部指数的基础信息（全称、简称、市净率 PB、市盈率 TTM），返回数组。覆盖沪深京三市全部指数，按 `symbol` 升序排列。每项含指数代码（如 `000001.XSHG`）、全称（如「上证综合指数」）、简称（如「上证指数」）。提示：无入参，直接 GET 即可；`symbol` 为标的代码，含交易所后缀：上交所 `.XSHG`、深交所 `.XSHE`、北交所 `.BJSE`。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
4082
+ "description": "获取全部指数的基础信息（全称、简称、市净率 PB、市盈率 TTM），返回数组。覆盖沪深京三市全部指数，按 `symbol` 升序排列。每项含指数代码（如 `000001.XSHG`）、全称（如「上证综合指数」）、简称（如「上证指数」）。提示：无入参，直接 GET 即可；`symbol` 为标的代码，含交易所后缀：上交所 `.XSHG`、深交所 `.XSHE`、北交所 `.BJSE`。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page_size` 超过 500 按 500 处理。",
4174
4083
  "inputSchema": {
4175
4084
  "type": "object",
4176
4085
  "properties": {
@@ -4375,7 +4284,7 @@
4375
4284
  },
4376
4285
  "page_size": {
4377
4286
  "default": 100,
4378
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
4287
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
4379
4288
  "maximum": 1000,
4380
4289
  "minimum": 1,
4381
4290
  "type": "integer"
@@ -4425,7 +4334,7 @@
4425
4334
  "type": "integer"
4426
4335
  },
4427
4336
  "trade_date": {
4428
- "description": "交易日期；格式由上游接口校验",
4337
+ "description": "交易日期，格式 `YYYYMMDD`（其他格式返回 400）",
4429
4338
  "maxLength": 4096,
4430
4339
  "type": "string"
4431
4340
  }
@@ -4472,26 +4381,26 @@
4472
4381
  {
4473
4382
  "name": "ft_v1_namechange",
4474
4383
  "title": "股票曾用名",
4475
- "description": "查询某只 A 股股票的历史曾用名。按 `change_date` 推导出每个名称的连续使用区间，最新名称的 `end_date` 为 `null`，较早名称的 `end_date` = 下一条变更日期 − 1 天；最早曾用名之前原名称的 `start_date` 可能为空字符串。不分页，单只股票一次性返回全部历史名称记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH，000001.SZ`；日期参数格式为 `YYYYMMDD`（如 `20200101`），非时间戳。",
4384
+ "description": "查询某只 A 股股票的历史曾用名。按 `change_date` 推导出每个名称的连续使用区间，最新名称的 `end_date` 为 `null`，较早名称的 `end_date` = 下一条变更日期 − 1 天；最早曾用名之前原名称的 `start_date` 可能为空字符串。不分页，单只股票一次性返回全部历史名称记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH,000001.SZ`；日期参数格式为 `YYYYMMDD`（如 `20200101`），非时间戳。",
4476
4385
  "inputSchema": {
4477
4386
  "type": "object",
4478
4387
  "properties": {
4479
4388
  "end_date": {
4480
- "description": "过滤区间结束日期；日期格式由上游接口校验",
4389
+ "description": "过滤区间结束日期，格式 `YYYYMMDD`（传入其他格式过滤结果不可预期）",
4481
4390
  "maxLength": 4096,
4482
4391
  "type": "string"
4483
4392
  },
4484
4393
  "start_date": {
4485
- "description": "过滤区间起始日期；日期格式由上游接口校验",
4394
+ "description": "过滤区间起始日期，格式 `YYYYMMDD`；不能大于 end_date（同时提供时返回 400）",
4486
4395
  "maxLength": 4096,
4487
4396
  "type": "string"
4488
4397
  },
4489
4398
  "trade_code": {
4490
- "description": "A 股代码，支持无后缀、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀，代码须与交易所匹配；多个代码使用英文逗号分隔，MCP 会规范化为短后缀大写格式",
4399
+ "description": "A 股代码，需带 .SH/.SZ/.BJ 大写短后缀（如 600848.SH），裸码、长后缀或交易所不匹配时查不到数据；多个代码使用英文逗号分隔",
4491
4400
  "examples": [
4492
- "600848",
4493
- "600848.SH,000001.XSHE",
4494
- "920163.BJSE"
4401
+ "600848.SH",
4402
+ "600848.SH,000001.SZ",
4403
+ "920163.BJ"
4495
4404
  ],
4496
4405
  "maxLength": 4096,
4497
4406
  "type": "string"
@@ -4582,7 +4491,7 @@
4582
4491
  "type": "object",
4583
4492
  "properties": {
4584
4493
  "date": {
4585
- "description": "公告日期；日期格式由上游接口校验",
4494
+ "description": "公告日期，格式 `YYYYMMDD` 或 `YYYY-MM-DD`（其他格式返回 400）",
4586
4495
  "maxLength": 4096,
4587
4496
  "type": "string"
4588
4497
  },
@@ -4682,7 +4591,7 @@
4682
4591
  },
4683
4592
  "page_size": {
4684
4593
  "default": 100,
4685
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
4594
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
4686
4595
  "maximum": 1000,
4687
4596
  "minimum": 1,
4688
4597
  "type": "integer"
@@ -4724,7 +4633,7 @@
4724
4633
  },
4725
4634
  "page_size": {
4726
4635
  "default": 100,
4727
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
4636
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
4728
4637
  "maximum": 1000,
4729
4638
  "minimum": 1,
4730
4639
  "type": "integer"
@@ -4764,26 +4673,26 @@
4764
4673
  {
4765
4674
  "name": "ft_v1_stk_code_change",
4766
4675
  "title": "A股代码变更",
4767
- "description": "查询某只 A 股股票的代码变更历史，返回每个代码的起止使用区间。每条记录的 `code` 为该时段实际使用的代码，`trade_code` 始终为该股票的最新代码。已上市股票的最早区间起始优先使用上市日期；最早一次变更前的原代码若与变更后代码不同，则补一条记录，`start_date` 为空字符串、`end_date` 为最早一次变更日期 − 1 天。提示：`trade_code` 必填，为空或仅空白字符时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH` 或 `600848.SH，000001.SZ`；日期参数格式为 `YYYYMMDD`（如 `20200101`），非时间戳。",
4676
+ "description": "查询某只 A 股股票的代码变更历史，返回每个代码的起止使用区间。每条记录的 `code` 为该时段实际使用的代码，`trade_code` 始终为该股票的最新代码。已上市股票的最早区间起始优先使用上市日期；最早一次变更前的原代码若与变更后代码不同，则补一条记录，`start_date` 为空字符串、`end_date` 为最早一次变更日期 − 1 天。提示：`trade_code` 必填，为空或仅空白字符时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH` 或 `600848.SH,000001.SZ`；日期参数格式为 `YYYYMMDD`（如 `20200101`），非时间戳。",
4768
4677
  "inputSchema": {
4769
4678
  "type": "object",
4770
4679
  "properties": {
4771
4680
  "end_date": {
4772
- "description": "过滤区间结束日期；日期格式由上游接口校验",
4681
+ "description": "过滤区间结束日期，格式 `YYYYMMDD`（传入其他格式过滤结果不可预期）",
4773
4682
  "maxLength": 4096,
4774
4683
  "type": "string"
4775
4684
  },
4776
4685
  "start_date": {
4777
- "description": "过滤区间起始日期；日期格式由上游接口校验",
4686
+ "description": "过滤区间起始日期，格式 `YYYYMMDD`；不能大于 end_date（同时提供时返回 400）",
4778
4687
  "maxLength": 4096,
4779
4688
  "type": "string"
4780
4689
  },
4781
4690
  "trade_code": {
4782
- "description": "A 股代码，支持无后缀、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀，代码须与交易所匹配；多个代码使用英文逗号分隔，MCP 会规范化为短后缀大写格式",
4691
+ "description": "A 股代码，需带 .SH/.SZ/.BJ 大写短后缀（如 600848.SH），裸码、长后缀或交易所不匹配时查不到数据；多个代码使用英文逗号分隔",
4783
4692
  "examples": [
4784
- "600848",
4785
- "600848.SH,000001.XSHE",
4786
- "920163.BJSE"
4693
+ "600848.SH",
4694
+ "600848.SH,000001.SZ",
4695
+ "920163.BJ"
4787
4696
  ],
4788
4697
  "maxLength": 4096,
4789
4698
  "type": "string"
@@ -4867,21 +4776,21 @@
4867
4776
  {
4868
4777
  "name": "ft_v1_stk_manager_hold",
4869
4778
  "title": "上市公司管理层持股",
4870
- "description": "查询上市公司管理层人员持股变动明细，含截止日期、姓名、持股数、变动原因。可按 `end_date` 精确匹配过滤。不分页，单只股票一次性返回全部持股记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH，000001.SZ`；不传则返回该股票全部历史记录。",
4779
+ "description": "查询上市公司管理层人员持股变动明细，含截止日期、姓名、持股数、变动原因。可按 `end_date` 精确匹配过滤。不分页，单只股票一次性返回全部持股记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH,000001.SZ`；不传则返回该股票全部历史记录。",
4871
4780
  "inputSchema": {
4872
4781
  "type": "object",
4873
4782
  "properties": {
4874
4783
  "end_date": {
4875
- "description": "截止日期；格式由上游接口校验",
4784
+ "description": "截止日期，格式 `YYYYMMDD`（精确匹配，其他格式查不到数据）",
4876
4785
  "maxLength": 4096,
4877
4786
  "type": "string"
4878
4787
  },
4879
4788
  "trade_code": {
4880
- "description": "A 股代码，支持无后缀、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀，代码须与交易所匹配；多个代码使用英文逗号分隔，MCP 会规范化为短后缀大写格式",
4789
+ "description": "A 股代码，需带 .SH/.SZ/.BJ 大写短后缀（如 600848.SH），裸码、长后缀或交易所不匹配时查不到数据；多个代码使用英文逗号分隔",
4881
4790
  "examples": [
4882
- "600848",
4883
- "600848.SH,000001.XSHE",
4884
- "920163.BJSE"
4791
+ "600848.SH",
4792
+ "600848.SH,000001.SZ",
4793
+ "920163.BJ"
4885
4794
  ],
4886
4795
  "maxLength": 4096,
4887
4796
  "type": "string"
@@ -4896,21 +4805,21 @@
4896
4805
  {
4897
4806
  "name": "ft_v1_stk_manager_pay",
4898
4807
  "title": "上市公司管理层薪酬",
4899
- "description": "查询上市公司管理层人员年度薪酬，含截止日期、姓名、年度薪酬、货币币种。可按 `end_date` 精确匹配过滤。不分页，单只股票一次性返回全部薪酬记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH，000001.SZ`；不传则返回该股票全部历史记录。",
4808
+ "description": "查询上市公司管理层人员年度薪酬，含截止日期、姓名、年度薪酬、货币币种。可按 `end_date` 精确匹配过滤。不分页，单只股票一次性返回全部薪酬记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH,000001.SZ`；不传则返回该股票全部历史记录。",
4900
4809
  "inputSchema": {
4901
4810
  "type": "object",
4902
4811
  "properties": {
4903
4812
  "end_date": {
4904
- "description": "截止日期；格式由上游接口校验",
4813
+ "description": "截止日期，格式 `YYYYMMDD`（精确匹配，其他格式查不到数据）",
4905
4814
  "maxLength": 4096,
4906
4815
  "type": "string"
4907
4816
  },
4908
4817
  "trade_code": {
4909
- "description": "A 股代码，支持无后缀、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀，代码须与交易所匹配；多个代码使用英文逗号分隔，MCP 会规范化为短后缀大写格式",
4818
+ "description": "A 股代码，需带 .SH/.SZ/.BJ 大写短后缀（如 600848.SH），裸码、长后缀或交易所不匹配时查不到数据；多个代码使用英文逗号分隔",
4910
4819
  "examples": [
4911
- "600848",
4912
- "600848.SH,000001.XSHE",
4913
- "920163.BJSE"
4820
+ "600848.SH",
4821
+ "600848.SH,000001.SZ",
4822
+ "920163.BJ"
4914
4823
  ],
4915
4824
  "maxLength": 4096,
4916
4825
  "type": "string"
@@ -4925,31 +4834,31 @@
4925
4834
  {
4926
4835
  "name": "ft_v1_stk_managers",
4927
4836
  "title": "上市公司管理层",
4928
- "description": "查询上市公司管理层人员信息，含股票名称、姓名、岗位类别、职位、出生年月、候选日期、任职区间、在职情况、变动原因等。可按 `candi_date` 精确匹配、按 `begin_date`/`end_date` 区间过滤。不分页，单只股票一次性返回全部管理层记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH，000001.SZ`；日期参数格式为 `YYYYMMDD`（如 `20200101`），非时间戳。",
4837
+ "description": "查询上市公司管理层人员信息，含股票名称、姓名、岗位类别、职位、出生年月、候选日期、任职区间、在职情况、变动原因等。可按 `candi_date` 精确匹配、按 `begin_date`/`end_date` 区间过滤。不分页，单只股票一次性返回全部管理层记录；多 `trade_code`（逗号分隔）时合并返回。提示：`trade_code` 必填，为空时返回 `code: 400，message: \"trade_code is required\"`；`trade_code` 支持逗号分隔多个代码，如 `600848.SH,000001.SZ`；日期参数格式为 `YYYYMMDD`（如 `20200101`），非时间戳。",
4929
4838
  "inputSchema": {
4930
4839
  "type": "object",
4931
4840
  "properties": {
4932
4841
  "begin_date": {
4933
- "description": "任职起始日；格式由上游接口校验",
4842
+ "description": "任职起始日，格式 `YYYYMMDD`；不能大于 end_date（同时提供时返回 400）",
4934
4843
  "maxLength": 4096,
4935
4844
  "type": "string"
4936
4845
  },
4937
4846
  "candi_date": {
4938
- "description": "候选日期；格式由上游接口校验",
4847
+ "description": "候选日期，格式 `YYYYMMDD`（精确匹配，其他格式查不到数据）",
4939
4848
  "maxLength": 4096,
4940
4849
  "type": "string"
4941
4850
  },
4942
4851
  "end_date": {
4943
- "description": "任职截止日；格式由上游接口校验",
4852
+ "description": "任职截止日，格式 `YYYYMMDD`（传入其他格式过滤结果不可预期）",
4944
4853
  "maxLength": 4096,
4945
4854
  "type": "string"
4946
4855
  },
4947
4856
  "trade_code": {
4948
- "description": "A 股代码，支持无后缀、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀，代码须与交易所匹配；多个代码使用英文逗号分隔，MCP 会规范化为短后缀大写格式",
4857
+ "description": "A 股代码，需带 .SH/.SZ/.BJ 大写短后缀（如 600848.SH），裸码、长后缀或交易所不匹配时查不到数据；多个代码使用英文逗号分隔",
4949
4858
  "examples": [
4950
- "600848",
4951
- "600848.SH,000001.XSHE",
4952
- "920163.BJSE"
4859
+ "600848.SH",
4860
+ "600848.SH,000001.SZ",
4861
+ "920163.BJ"
4953
4862
  ],
4954
4863
  "maxLength": 4096,
4955
4864
  "type": "string"
@@ -4969,7 +4878,7 @@
4969
4878
  "type": "object",
4970
4879
  "properties": {
4971
4880
  "change_date": {
4972
- "description": "变更日期；格式由上游接口校验",
4881
+ "description": "变更日期，格式 `YYYYMMDD`（精确匹配，其他格式查不到数据）",
4973
4882
  "maxLength": 4096,
4974
4883
  "type": "string"
4975
4884
  },
@@ -5066,7 +4975,7 @@
5066
4975
  "type": "integer"
5067
4976
  },
5068
4977
  "limit": {
5069
- "description": "返回条数上限，1 到 1000；超出范围上游返回参数错误",
4978
+ "description": "返回条数上限，1 到 1000；超出范围返回参数错误",
5070
4979
  "maximum": 1000,
5071
4980
  "minimum": 1,
5072
4981
  "type": "integer"
@@ -5098,7 +5007,7 @@
5098
5007
  {
5099
5008
  "name": "ft_v1_stock_candlesticks_daily",
5100
5009
  "title": "股票日K快照",
5101
- "description": "一次查询指定交易日全部普通 A 股的日 K 快照，每条记录含标的代码（带标准市场后缀，如 600519.SH、000001.SZ、920001.BJ）、开盘价、最高价、最低价、收盘价、收盘时间戳、开盘时间戳、成交额、成交量（单位股）和换手率；开高低收和成交额为字符串，`turnover_rate` 为换手率比例值（如 0.00763 表示约 0.763%）。数据范围为普通 A 股日 K，不包含 ETF、可转债、指数等其他标的。提示：`trade_date` 必填，格式 YYYYMMDD 且必须是交易日，否则返回参数错误；结果按 `trade_code` 升序，单日全市场约 5500 条，需按 `pages` 翻页取全。支持分页；`page/page_size` 可省略，上游缺省 `1/200`，`page` 0、`page_size` 0 或超过 500 返回参数错误。",
5010
+ "description": "一次查询指定交易日全部普通 A 股的日 K 快照，每条记录含标的代码（带标准市场后缀，如 600519.SH、000001.SZ、920001.BJ）、开盘价、最高价、最低价、收盘价、收盘时间戳、开盘时间戳、成交额、成交量（单位股）和换手率；开高低收和成交额为字符串，`turnover_rate` 为换手率比例值（如 0.00763 表示约 0.763%）。数据范围为普通 A 股日 K，不包含 ETF、可转债、指数等其他标的。提示：`trade_date` 必填，格式 YYYYMMDD 且必须是交易日，否则返回参数错误；结果按 `trade_code` 升序，单日全市场约 5500 条，需按 `pages` 翻页取全。支持分页；`page/page_size` 可省略，缺省 `1/200`，`page` 0、`page_size` 0 或超过 500 返回参数错误。",
5102
5011
  "inputSchema": {
5103
5012
  "type": "object",
5104
5013
  "properties": {
@@ -5130,7 +5039,7 @@
5130
5039
  {
5131
5040
  "name": "ft_v1_stock_capital_flows",
5132
5041
  "title": "股票资金流向",
5133
- "description": "查询股票 15 分钟资金流向快照，返回超大单、大单、中单、小单净流入及主力净流入。可按日期、时点和股票代码过滤；仅传 `time` 时上游返回参数错误，`time` 必须与 `date` 同时使用。",
5042
+ "description": "查询股票 15 分钟资金流向快照，返回超大单、大单、中单、小单净流入及主力净流入。可按日期、时点和股票代码过滤；仅传 `time` 时返回参数错误，`time` 必须与 `date` 同时使用。",
5134
5043
  "inputSchema": {
5135
5044
  "type": "object",
5136
5045
  "properties": {
@@ -5388,7 +5297,7 @@
5388
5297
  "type": "string"
5389
5298
  },
5390
5299
  "fields": {
5391
- "description": "可选 records 一级字段列表，格式由上游解析",
5300
+ "description": "可选 records 一级字段列表，多个字段用英文逗号分隔；不支持的返回字段返回参数错误",
5392
5301
  "maxLength": 4096,
5393
5302
  "type": "string"
5394
5303
  },
@@ -5524,7 +5433,7 @@
5524
5433
  },
5525
5434
  "page_size": {
5526
5435
  "default": 50,
5527
- "description": "每页数量，默认 50，1 到 200，超出范围上游返回参数错误",
5436
+ "description": "每页数量，默认 50，1 到 200，超出范围返回参数错误",
5528
5437
  "maximum": 200,
5529
5438
  "minimum": 1,
5530
5439
  "type": "integer"
@@ -5542,12 +5451,12 @@
5542
5451
  {
5543
5452
  "name": "ft_v1_sw_index_history_minutes",
5544
5453
  "title": "市场数据 v1：sw-index/history-minutes",
5545
- "description": "查询指定申万指数在日期区间内的 1 分钟 K 线，返回开高低收、成交量和成交额。",
5454
+ "description": "查询指定申万指数在日期区间内的 1 分钟 K 线，返回开高低收、成交量和成交额。每日数据时段为 09:30~14:57，收盘集合竞价时段无数据；`high`/`low` 为截至该分钟的当日累计最高/最低，非该分钟自身极值。",
5546
5455
  "inputSchema": {
5547
5456
  "type": "object",
5548
5457
  "properties": {
5549
5458
  "end_date": {
5550
- "description": "结束日期；格式由上游接口校验",
5459
+ "description": "结束日期，格式 `YYYYMMDD`（其他格式返回 400）",
5551
5460
  "maxLength": 4096,
5552
5461
  "type": "string"
5553
5462
  },
@@ -5563,13 +5472,13 @@
5563
5472
  },
5564
5473
  "page_size": {
5565
5474
  "default": 50,
5566
- "description": "每页数量，默认 50，1 到 200，超出范围上游返回参数错误",
5475
+ "description": "每页数量，默认 50，1 到 200，超出范围返回参数错误",
5567
5476
  "maximum": 200,
5568
5477
  "minimum": 1,
5569
5478
  "type": "integer"
5570
5479
  },
5571
5480
  "start_date": {
5572
- "description": "开始日期；格式由上游接口校验",
5481
+ "description": "开始日期，格式 `YYYYMMDD`（其他格式返回 400）",
5573
5482
  "maxLength": 4096,
5574
5483
  "type": "string"
5575
5484
  }
@@ -5604,12 +5513,12 @@
5604
5513
  {
5605
5514
  "name": "ft_v1_sw_industry_daily_metrics",
5606
5515
  "title": "申万行业日度指标",
5607
- "description": "查询单个申万行业的日频估值、资金和量价指标时间序列。`level`、日期范围和行业代码均由上游服务解析校验，不存在的行业返回空结果。",
5516
+ "description": "查询单个申万行业的日频估值、资金和量价指标时间序列（如指数收盘、市盈率/市净率及其分位、股息率、换手率、总市值、成交额等），不含昨收、开、高、低、成交量。`start_date` 不能晚于 `end_date`；不存在的行业返回空结果。",
5608
5517
  "inputSchema": {
5609
5518
  "type": "object",
5610
5519
  "properties": {
5611
5520
  "end_date": {
5612
- "description": "截止日期；格式和范围由上游接口校验",
5521
+ "description": "截止日期，格式 `YYYYMMDD`（其他格式返回参数错误）",
5613
5522
  "maxLength": 4096,
5614
5523
  "type": "string"
5615
5524
  },
@@ -5638,7 +5547,7 @@
5638
5547
  "type": "integer"
5639
5548
  },
5640
5549
  "start_date": {
5641
- "description": "起始日期；格式和范围由上游接口校验",
5550
+ "description": "起始日期，格式 `YYYYMMDD`（其他格式返回参数错误）",
5642
5551
  "maxLength": 4096,
5643
5552
  "type": "string"
5644
5553
  }
@@ -5724,7 +5633,7 @@
5724
5633
  },
5725
5634
  "page_size": {
5726
5635
  "default": 100,
5727
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
5636
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
5728
5637
  "maximum": 1000,
5729
5638
  "minimum": 1,
5730
5639
  "type": "integer"
@@ -5779,7 +5688,7 @@
5779
5688
  },
5780
5689
  "page_size": {
5781
5690
  "default": 100,
5782
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
5691
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
5783
5692
  "maximum": 1000,
5784
5693
  "minimum": 1,
5785
5694
  "type": "integer"
@@ -5834,7 +5743,7 @@
5834
5743
  },
5835
5744
  "page_size": {
5836
5745
  "default": 100,
5837
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
5746
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
5838
5747
  "maximum": 1000,
5839
5748
  "minimum": 1,
5840
5749
  "type": "integer"
@@ -5883,7 +5792,7 @@
5883
5792
  {
5884
5793
  "name": "ft_v1_ths_board_constituents",
5885
5794
  "title": "同花顺板块成分股",
5886
- "description": "按板块代码或名称查询同花顺板块的成分股列表，每条记录含板块代码、板块名称、股票代码和股票名称。覆盖概念 / 行业 / 地域 / 证监会（csrc）四类板块，当前在线 503 个（概念 361 / 行业 90 / 地域 33 / csrc 19）；最大板块（如融资融券 3872 只）需翻页取全。不传 `date` 返回当前仍在板块内的成分股，传 `date` 返回截至该日的成分股（含此后已退出的）。成分股进出记录自 20260907 起采集、无历史回填，且各类板块起始日不同（行业 20260907 / 概念 20260908 / 地域、csrc 20260909）；查询日早于该板块首次采集日时按首次采集日当天的在籍名单返回，不返回空。提示：`board_code` 与 `board_name` 至少传一个，两者都传时取交集，都不传返回 400；概念板块的 `board_code` 是本接口自己的编号段（概念 300xxx/308xxx/309xxx，如「军工」是 300082；行业 881xxx、地域 882xxx、csrc 为大写单字母），其它编号体系的概念代码查不到，概念板块建议直接传 `board_name`；板块名称跨类型可能重名（如「教育」同时属于行业 881178 与 csrc P），命中多个时返回 400，message 中按「代码/名称」列出全部候选，可补 `board_type`（industry/concept/region/csrc）消歧或改用 `board_code`；结果按 `stock_code` 升序。支持分页；`page/page_size` 可省略，上游缺省 `1/100`，`page` 0 或 `page_size` 0、超过 1000 返回参数错误。",
5795
+ "description": "按板块代码或名称查询同花顺板块的成分股列表，每条记录含板块代码、板块名称、股票代码和股票名称。覆盖概念 / 行业 / 地域 / 证监会（csrc）四类板块，当前在线 503 个（概念 361 / 行业 90 / 地域 33 / csrc 19）；最大板块（如融资融券 3872 只）需翻页取全。不传 `date` 返回当前仍在板块内的成分股，传 `date` 返回截至该日的成分股（含此后已退出的）。成分股进出记录自 20260907 起采集、无历史回填，且各类板块起始日不同（行业 20260907 / 概念 20260908 / 地域、csrc 20260909）；查询日早于该板块首次采集日时按首次采集日当天的在籍名单返回，不返回空。提示：`board_code` 与 `board_name` 至少传一个，两者都传时取交集，都不传返回 400；概念板块的 `board_code` 是本接口自己的编号段（概念 300xxx/308xxx/309xxx，如「军工」是 300082；行业 881xxx、地域 882xxx、csrc 为大写单字母），其它编号体系的概念代码查不到，概念板块建议直接传 `board_name`；板块名称跨类型可能重名（如「教育」同时属于行业 881178 与 csrc P），命中多个时返回 400，message 中按「代码/名称」列出全部候选，可补 `board_type`（industry/concept/region/csrc）消歧或改用 `board_code`；结果按 `stock_code` 升序。支持分页；`page/page_size` 可省略，缺省 `1/100`，`page` 0 或 `page_size` 0、超过 1000 返回参数错误。",
5887
5796
  "inputSchema": {
5888
5797
  "type": "object",
5889
5798
  "properties": {
@@ -6018,7 +5927,7 @@
6018
5927
  },
6019
5928
  "page_size": {
6020
5929
  "default": 100,
6021
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
5930
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
6022
5931
  "maximum": 1000,
6023
5932
  "minimum": 1,
6024
5933
  "type": "integer"
@@ -6106,7 +6015,7 @@
6106
6015
  },
6107
6016
  "page_size": {
6108
6017
  "default": 100,
6109
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
6018
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
6110
6019
  "maximum": 1000,
6111
6020
  "minimum": 1,
6112
6021
  "type": "integer"
@@ -6151,7 +6060,7 @@
6151
6060
  },
6152
6061
  "page_size": {
6153
6062
  "default": 100,
6154
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
6063
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
6155
6064
  "maximum": 1000,
6156
6065
  "minimum": 1,
6157
6066
  "type": "integer"
@@ -6199,7 +6108,7 @@
6199
6108
  },
6200
6109
  "page_size": {
6201
6110
  "default": 100,
6202
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
6111
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
6203
6112
  "maximum": 1000,
6204
6113
  "minimum": 1,
6205
6114
  "type": "integer"
@@ -6244,7 +6153,7 @@
6244
6153
  "type": "object",
6245
6154
  "properties": {
6246
6155
  "end_date": {
6247
- "description": "结束日期整数；格式和有效范围由上游接口校验",
6156
+ "description": "结束日期整数，格式 `YYYYMMDD`（无效值返回 400）",
6248
6157
  "minimum": 1,
6249
6158
  "type": "integer"
6250
6159
  },
@@ -6257,7 +6166,7 @@
6257
6166
  "type": "string"
6258
6167
  },
6259
6168
  "start_date": {
6260
- "description": "起始日期整数；格式和有效范围由上游接口校验",
6169
+ "description": "起始日期整数，格式 `YYYYMMDD`（无效值返回 400）",
6261
6170
  "minimum": 1,
6262
6171
  "type": "integer"
6263
6172
  }
@@ -6278,7 +6187,7 @@
6278
6187
  "type": "object",
6279
6188
  "properties": {
6280
6189
  "end_date": {
6281
- "description": "解禁结束日期；支持 YYYYMMDD 或 YYYY-MM-DD，由上游解析",
6190
+ "description": "解禁结束日期；支持 YYYYMMDD 或 YYYY-MM-DD",
6282
6191
  "maxLength": 4096,
6283
6192
  "type": "string"
6284
6193
  },
@@ -6293,7 +6202,7 @@
6293
6202
  "type": "integer"
6294
6203
  },
6295
6204
  "start_date": {
6296
- "description": "解禁开始日期；支持 YYYYMMDD 或 YYYY-MM-DD，由上游解析",
6205
+ "description": "解禁开始日期；支持 YYYYMMDD 或 YYYY-MM-DD",
6297
6206
  "maxLength": 4096,
6298
6207
  "type": "string"
6299
6208
  },
@@ -6314,7 +6223,7 @@
6314
6223
  "type": "object",
6315
6224
  "properties": {
6316
6225
  "end_date": {
6317
- "description": "结束日期；格式由上游接口校验",
6226
+ "description": "结束日期，格式 `YYYYMMDD`（其他格式返回 400）",
6318
6227
  "maxLength": 4096,
6319
6228
  "type": "string"
6320
6229
  },
@@ -6326,13 +6235,13 @@
6326
6235
  },
6327
6236
  "page_size": {
6328
6237
  "default": 100,
6329
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
6238
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
6330
6239
  "maximum": 1000,
6331
6240
  "minimum": 1,
6332
6241
  "type": "integer"
6333
6242
  },
6334
6243
  "start_date": {
6335
- "description": "起始日期；格式由上游接口校验",
6244
+ "description": "起始日期，格式 `YYYYMMDD`（其他格式返回 400）",
6336
6245
  "maxLength": 4096,
6337
6246
  "type": "string"
6338
6247
  }
@@ -6404,7 +6313,7 @@
6404
6313
  "type": "integer"
6405
6314
  },
6406
6315
  "stock_code": {
6407
- "description": "股票代码；格式由上游接口校验",
6316
+ "description": "股票代码，6 位裸码（如 600519）；带交易所后缀查不到数据",
6408
6317
  "maxLength": 4096,
6409
6318
  "type": "string"
6410
6319
  },
@@ -6470,7 +6379,7 @@
6470
6379
  "type": "integer"
6471
6380
  },
6472
6381
  "page_size": {
6473
- "description": "每页条数，必填；1 到 500，超出范围上游返回参数错误",
6382
+ "description": "每页条数，必填；1 到 500，超出范围返回参数错误",
6474
6383
  "maximum": 500,
6475
6384
  "minimum": 1,
6476
6385
  "type": "integer"
@@ -6530,7 +6439,7 @@
6530
6439
  {
6531
6440
  "name": "ft_v2_announcements_stock_announcements",
6532
6441
  "title": "公告列表",
6533
- "description": "查询 A 股公告列表。支持按 `stock_code` 查询单票历史公告，或按 `start_date` 查询指定单日的全市场公告。提示：传入 `stock_code` 时支持纯代码、短后缀或长后缀，MCP 自动转换为 `.SH/.SZ/.BJ`；必须提供 `stock_code` 或 `start_date` 之一，否则报错；`type` 当前只支持 `stock`。需要文件本体时，取记录的 `url_hash` 调用 `ft_v2_announcements_stock_announcement_download` 获取公网下载信息。",
6442
+ "description": "查询 A 股公告列表。支持按 `stock_code` 查询单票历史公告，或按 `start_date` 查询指定单日的全市场公告。提示：传入 `stock_code` 时需 6 位数字.SH/SZ/BJ（大写短后缀，如 600000.SH），其它格式返回 400；必须提供 `stock_code` 或 `start_date` 之一，否则报错；`type` 当前只支持 `stock`。需要文件本体时，取记录的 `url_hash` 调用 `ft_v2_announcements_stock_announcement_download` 获取公网下载信息。",
6534
6443
  "inputSchema": {
6535
6444
  "type": "object",
6536
6445
  "properties": {
@@ -6540,7 +6449,7 @@
6540
6449
  "type": "integer"
6541
6450
  },
6542
6451
  "page_size": {
6543
- "description": "每页条数，必填；1 到 500，超出范围上游返回参数错误",
6452
+ "description": "每页条数，必填；1 到 500，超出范围返回参数错误",
6544
6453
  "maximum": 500,
6545
6454
  "minimum": 1,
6546
6455
  "type": "integer"
@@ -6551,11 +6460,9 @@
6551
6460
  "type": "string"
6552
6461
  },
6553
6462
  "stock_code": {
6554
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
6463
+ "description": "A 股股票代码，需 6 位数字.SH/SZ/BJ（大写短后缀，如 600000.SH），其它格式返回 400",
6555
6464
  "examples": [
6556
- "000001",
6557
- "000001.SZ",
6558
- "000001.XSHE"
6465
+ "000001.SZ"
6559
6466
  ],
6560
6467
  "maxLength": 4096,
6561
6468
  "type": "string"
@@ -6697,7 +6604,7 @@
6697
6604
  },
6698
6605
  "page_size": {
6699
6606
  "default": 100,
6700
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
6607
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
6701
6608
  "maximum": 1000,
6702
6609
  "minimum": 1,
6703
6610
  "type": "integer"
@@ -6740,7 +6647,7 @@
6740
6647
  },
6741
6648
  "page_size": {
6742
6649
  "default": 50,
6743
- "description": "每页条数；缺省 50，1 到 200，超出范围上游返回参数错误",
6650
+ "description": "每页条数；缺省 50，1 到 200，超出范围返回参数错误",
6744
6651
  "maximum": 200,
6745
6652
  "minimum": 1,
6746
6653
  "type": "integer"
@@ -6768,7 +6675,7 @@
6768
6675
  {
6769
6676
  "name": "ft_v2_convertible_bond_candlesticks_batch",
6770
6677
  "title": "批量可转债历史K线",
6771
- "description": "批量获取可转债历史日、周、月或年 K 线，不包含当日盘中实时行情。`symbols`、`interval_unit`、`since_ts_millis`、`until_ts_millis` 必填，最多 20 只可转债，时间范围最多 12 个自然月；结果按请求标的分组，每组 K 线按时间升序，`limit` 保留最新若干根。",
6678
+ "description": "批量获取可转债历史日、周、月或年 K 线，不包含当日盘中实时行情。`symbols`、`interval_unit`、`since_ts_millis`、`until_ts_millis` 必填，单次最多 20 只，时间范围最多 12 个自然月；代码必须带市场后缀（.SH/.SZ 或 .XSHG/.XSHE，如 113042.SH、123107.SZ），裸代码返回参数错误；结果为逐根 K 线记录，每条带 `symbol` 字段，同一标的的记录按时间升序，`limit` 保留最新若干根，无行情标的不产生记录。",
6772
6679
  "inputSchema": {
6773
6680
  "type": "object",
6774
6681
  "properties": {
@@ -6815,13 +6722,12 @@
6815
6722
  "type": "integer"
6816
6723
  },
6817
6724
  "symbols": {
6818
- "description": "可转债代码列表，如 [\"113042.SH\",\"123107.SZ\"]；单次最多 20 只",
6725
+ "description": "可转债代码列表，如 [\"113042.SH\",\"123107.SZ\"]；支持 .XSHG/.XSHE 长后缀",
6819
6726
  "items": {
6820
6727
  "maxLength": 256,
6821
6728
  "type": "string"
6822
6729
  },
6823
- "maxItems": 20,
6824
- "minItems": 1,
6730
+ "maxItems": 500,
6825
6731
  "type": "array"
6826
6732
  },
6827
6733
  "until_ts_millis": {
@@ -6878,8 +6784,7 @@
6878
6784
  "maxLength": 256,
6879
6785
  "type": "string"
6880
6786
  },
6881
- "maxItems": 20,
6882
- "minItems": 1,
6787
+ "maxItems": 500,
6883
6788
  "type": "array"
6884
6789
  },
6885
6790
  "until_ts_millis": {
@@ -6932,7 +6837,7 @@
6932
6837
  {
6933
6838
  "name": "ft_v2_etf_candlesticks_batch",
6934
6839
  "title": "批量ETF K线",
6935
- "description": "批量获取多只 ETF 的历史周期 K 线（日/周/月/年），返回每个标的的开高低收、成交量额。提示：`symbols`、`interval_unit`、`until_ts_millis` 必填；`symbols` 单次最多 20 只；代码必须带市场后缀（.SH/.SZ 或 .XSHG/.XSHE，如 510300.SH、159915.SZ），格式由上游标的解析器校验；分钟 K 线不在本接口（传 `minute` 会被上游拒绝），实时分时见 v4 工具；`since_ts_millis` 省略时按 `until_ts_millis` 与 `limit` 返回最近 N 根；显式时间范围上限按周期：日 12、周 120、月 360、年 600 个自然月；`limit` 为 1 到 1000，未传 `since_ts_millis` 且未传 `limit` 时上游返回参数错误。",
6840
+ "description": "批量获取多只 ETF 的历史周期 K 线（日/周/月/年），结果为逐根 K 线记录，每条带 `symbol` 字段、开高低收与成交量额，同一标的的记录按时间升序，无行情标的不产生记录。提示：`symbols`、`interval_unit`、`until_ts_millis` 必填，单次最多 20 只；代码必须带市场后缀（.SH/.SZ 或 .XSHG/.XSHE，如 510300.SH、159915.SZ）；分钟 K 线不在本接口（传 `minute` 返回参数错误），实时分时见 v4 工具；`since_ts_millis` 省略时按 `until_ts_millis` 与 `limit` 返回最近 N 根；显式时间范围上限按周期：日 12、周 120、月 360、年 600 个自然月；`limit` 为 1 到 1000，未传 `since_ts_millis` 且未传 `limit` 时返回参数错误。",
6936
6841
  "inputSchema": {
6937
6842
  "type": "object",
6938
6843
  "properties": {
@@ -6962,7 +6867,7 @@
6962
6867
  "type": "string"
6963
6868
  },
6964
6869
  "limit": {
6965
- "description": "每个标的的返回条数上限，1 到 1000；超出范围上游返回参数错误",
6870
+ "description": "每个标的的返回条数上限，1 到 1000；超出范围返回参数错误",
6966
6871
  "maximum": 1000,
6967
6872
  "minimum": 1,
6968
6873
  "type": "integer"
@@ -6973,13 +6878,12 @@
6973
6878
  "type": "integer"
6974
6879
  },
6975
6880
  "symbols": {
6976
- "description": "ETF 代码列表，如 [\"510300.SH\",\"159915.SZ\"]；支持 .XSHG/.XSHE 长后缀，格式由上游标的解析器校验；单次最多 20 只",
6881
+ "description": "ETF 代码列表，如 [\"510300.SH\",\"159915.SZ\"]；支持 .XSHG/.XSHE 长后缀",
6977
6882
  "items": {
6978
6883
  "maxLength": 256,
6979
6884
  "type": "string"
6980
6885
  },
6981
- "maxItems": 20,
6982
- "minItems": 1,
6886
+ "maxItems": 500,
6983
6887
  "type": "array"
6984
6888
  },
6985
6889
  "until_ts_millis": {
@@ -7126,7 +7030,7 @@
7126
7030
  {
7127
7031
  "name": "ft_v2_etf_minutes_batch",
7128
7032
  "title": "市场数据 v2：etf_minutes/batch",
7129
- "description": "批量查询 ETF 历史分钟 K 线；每只标的独立返回，单次最多 20 只，时间范围最多 30 个自然日。",
7033
+ "description": "批量查询 ETF 历史分钟 K 线；结果为逐根分钟 K 线记录，每条带 `symbol` 字段，同一标的的记录按时间升序；单次最多 20 只，时间范围最多 30 个自然日。",
7130
7034
  "inputSchema": {
7131
7035
  "type": "object",
7132
7036
  "properties": {
@@ -7165,8 +7069,7 @@
7165
7069
  "maxLength": 256,
7166
7070
  "type": "string"
7167
7071
  },
7168
- "maxItems": 20,
7169
- "minItems": 1,
7072
+ "maxItems": 500,
7170
7073
  "type": "array"
7171
7074
  },
7172
7075
  "until_ts_millis": {
@@ -7508,7 +7411,7 @@
7508
7411
  {
7509
7412
  "name": "ft_v2_futures_kline_batch",
7510
7413
  "title": "批量期货合约历史K线",
7511
- "description": "批量查询多个期货合约的历史周期 K 线（日/周/月/季，周/月/季由历史日 K 聚合），含开高低收、成交量额、成交均价、持仓量，结果按时间升序，每个合约独立分组返回。提示：`symbols` 必填且单次最多 20 个，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；`interval` 默认 daily；`start`/`end` 为毫秒时间戳闭区间，`end` 不能单独传入，同时传入时查询范围不能超过 12 个自然月；不传区间时返回每个合约最新数据，`limit` 每合约默认 500，0 按 1 处理。",
7414
+ "description": "批量查询多个期货合约的历史周期 K 线（日/周/月/季，周/月/季由历史日 K 聚合），含开高低收、成交量额、成交均价、持仓量，结果为逐根 K 线记录，每个合约的记录按时间升序，无行情合约不产生记录。提示：`symbols` 必填且单次最多 20 个，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；`interval` 默认 daily；`start`/`end` 为毫秒时间戳闭区间，`end` 不能单独传入，同时传入时查询范围不能超过 12 个自然月；不传区间时返回每个合约最新数据，`limit` 每合约默认 500，0 按 1 处理。",
7512
7415
  "inputSchema": {
7513
7416
  "type": "object",
7514
7417
  "properties": {
@@ -7547,8 +7450,7 @@
7547
7450
  "maxLength": 256,
7548
7451
  "type": "string"
7549
7452
  },
7550
- "maxItems": 20,
7551
- "minItems": 1,
7453
+ "maxItems": 500,
7552
7454
  "type": "array"
7553
7455
  }
7554
7456
  },
@@ -7561,7 +7463,7 @@
7561
7463
  {
7562
7464
  "name": "ft_v2_futures_minutes",
7563
7465
  "title": "期货历史分钟K线",
7564
- "description": "查询期货合约的历史分钟 K 线，支持 1/5/15/30/60 分钟周期，不返回实时分钟数据。提示：`symbol` 与 `symbols` 二选一，批量单次最多 20 个合约，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；`start`/`end` 必填，为毫秒时间戳闭区间，跨度不能超过 3 天（72 小时）；当日数据需在北京时间 16:30 后可查；`interval` 默认 1min；`limit` 缺省 500，范围 1~1000；结果按时间升序。",
7466
+ "description": "查询期货合约的历史分钟 K 线，支持 1/5/15/30/60 分钟周期，不返回实时分钟数据。提示：`symbol` 与 `symbols` 二选一，批量单次最多 20 个合约，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；`start`/`end` 必填，为毫秒时间戳闭区间，跨度不能超过 3 天（72 小时）；当日数据需在北京时间 16:30 后可查；`interval` 默认 1min；`limit` 缺省 500，范围 1~1000；每个合约的记录按时间升序。",
7565
7467
  "inputSchema": {
7566
7468
  "type": "object",
7567
7469
  "properties": {
@@ -7611,8 +7513,7 @@
7611
7513
  "maxLength": 256,
7612
7514
  "type": "string"
7613
7515
  },
7614
- "maxItems": 20,
7615
- "minItems": 1,
7516
+ "maxItems": 500,
7616
7517
  "type": "array"
7617
7518
  }
7618
7519
  },
@@ -7677,6 +7578,7 @@
7677
7578
  "type": "integer"
7678
7579
  },
7679
7580
  "since_date": {
7581
+ "description": "起始日期（含），格式 `YYYYMMDD`",
7680
7582
  "maxLength": 4096,
7681
7583
  "type": "string"
7682
7584
  },
@@ -7685,6 +7587,7 @@
7685
7587
  "type": "string"
7686
7588
  },
7687
7589
  "until_date": {
7590
+ "description": "截止日期（含），格式 `YYYYMMDD`",
7688
7591
  "maxLength": 4096,
7689
7592
  "type": "string"
7690
7593
  }
@@ -7758,7 +7661,7 @@
7758
7661
  {
7759
7662
  "name": "ft_v2_index_candlesticks_batch",
7760
7663
  "title": "批量指数K线",
7761
- "description": "批量获取多条指数的历史周期 K 线（日/周/月/年），返回每条指数的开高低收、成交量额。提示：`symbols`、`interval_unit`、`until_ts_millis` 必填；`symbols` 单次最多 20 只；代码必须带市场后缀（沪深 .SH/.SZ 或 .XSHG/.XSHE，中证指数 .CSI，如 000300.SH、932000.CSI），格式由上游标的解析器校验；指数无除权除息事件，`adjust_kind` 传任意值均等同于 none；分钟 K 线不在本接口（传 `minute` 会被上游拒绝）；`since_ts_millis` 省略时按 `until_ts_millis` 与 `limit` 返回最近 N 根；显式时间范围上限按周期：日 12、周 120、月 360、年 600 个自然月；`limit` 为 1 到 1000，未传 `since_ts_millis` 且未传 `limit` 时上游返回参数错误。",
7664
+ "description": "批量获取多条指数的历史周期 K 线（日/周/月/年），结果为逐根 K 线记录，每条带 `symbol` 字段、开高低收与成交量额，同一标的的记录按时间升序，无行情标的不产生记录。提示：`symbols`、`interval_unit`、`until_ts_millis` 必填，单次最多 20 只；代码必须带市场后缀（沪深 .SH/.SZ 或 .XSHG/.XSHE，中证指数 .CSI，如 000300.SH、932000.CSI）；指数无除权除息事件，`adjust_kind` 传任意值均等同于 none；分钟 K 线不在本接口（传 `minute` 返回参数错误）；`since_ts_millis` 省略时按 `until_ts_millis` 与 `limit` 返回最近 N 根；显式时间范围上限按周期：日 12、周 120、月 360、年 600 个自然月；`limit` 为 1 到 1000，未传 `since_ts_millis` 且未传 `limit` 时返回参数错误。",
7762
7665
  "inputSchema": {
7763
7666
  "type": "object",
7764
7667
  "properties": {
@@ -7788,7 +7691,7 @@
7788
7691
  "type": "string"
7789
7692
  },
7790
7693
  "limit": {
7791
- "description": "每个标的的返回条数上限，1 到 1000；超出范围上游返回参数错误",
7694
+ "description": "每个标的的返回条数上限，1 到 1000；超出范围返回参数错误",
7792
7695
  "maximum": 1000,
7793
7696
  "minimum": 1,
7794
7697
  "type": "integer"
@@ -7799,13 +7702,12 @@
7799
7702
  "type": "integer"
7800
7703
  },
7801
7704
  "symbols": {
7802
- "description": "指数代码列表，如 [\"000300.SH\",\"399001.SZ\"]；支持 .XSHG/.XSHE 长后缀与 .CSI 中证指数代码（如 932000.CSI）；单次最多 20 只",
7705
+ "description": "指数代码列表，如 [\"000300.SH\",\"399001.SZ\"]；支持 .XSHG/.XSHE 长后缀与 .CSI 中证指数代码（如 932000.CSI）",
7803
7706
  "items": {
7804
7707
  "maxLength": 256,
7805
7708
  "type": "string"
7806
7709
  },
7807
- "maxItems": 20,
7808
- "minItems": 1,
7710
+ "maxItems": 500,
7809
7711
  "type": "array"
7810
7712
  },
7811
7713
  "until_ts_millis": {
@@ -7859,7 +7761,7 @@
7859
7761
  "type": "integer"
7860
7762
  },
7861
7763
  "symbol": {
7862
- "description": "指数代码，必须带 .SH/.SZ 短后缀",
7764
+ "description": "指数代码，必须带 .SH/.SZ 短后缀或中证指数 .CSI 后缀，如 000300.SH、932000.CSI",
7863
7765
  "maxLength": 4096,
7864
7766
  "type": "string"
7865
7767
  },
@@ -7879,7 +7781,7 @@
7879
7781
  {
7880
7782
  "name": "ft_v2_index_minutes_batch",
7881
7783
  "title": "市场数据 v2：index_minutes/batch",
7882
- "description": "批量查询 A 股指数历史分钟 K 线；每只标的独立返回，单次最多 20 只，时间范围最多 30 个自然日。",
7784
+ "description": "批量查询 A 股指数历史分钟 K 线；结果为逐根分钟 K 线记录，每条带 `symbol` 字段，同一标的的记录按时间升序；单次最多 20 只，时间范围最多 30 个自然日。",
7883
7785
  "inputSchema": {
7884
7786
  "type": "object",
7885
7787
  "properties": {
@@ -7918,8 +7820,7 @@
7918
7820
  "maxLength": 256,
7919
7821
  "type": "string"
7920
7822
  },
7921
- "maxItems": 20,
7922
- "minItems": 1,
7823
+ "maxItems": 500,
7923
7824
  "type": "array"
7924
7825
  },
7925
7826
  "until_ts_millis": {
@@ -8007,7 +7908,7 @@
8007
7908
  {
8008
7909
  "name": "ft_v2_limit_event_timeline_3s",
8009
7910
  "title": "涨跌停事件时间线",
8010
- "description": "查询个股涨跌停事件 3 秒级时间线。返回每只股票当日的涨跌停时间线：涨停价/跌停价、进入/炸板（涨停）/进入/翘板（跌停）时间点数组、首次封板/最后封板时间、炸板/开板次数、跌停封单资金等。未传 `trade_date`（或传当日）时返回当日实时快照，传历史交易日时返回该交易日的事件时间线。提示：`symbol` 可选，传则查单只；不传返回全市场（已过滤非股票标的）；`trade_date` 为可选参数，格式 `YYYYMMDD`。支持分页；`page/page_size` 可省略，上游缺省 `1/50`，`page_size` 超过 200 按 200 处理。",
7911
+ "description": "查询个股涨跌停事件 3 秒级时间线。返回每只股票当日的涨跌停时间线：涨停价/跌停价、进入/炸板（涨停）/进入/翘板（跌停）时间点数组、首次封板/最后封板时间、炸板/开板次数、跌停封单资金等。未传 `trade_date`（或传当日）时返回当日实时快照，传历史交易日时返回该交易日的事件时间线。提示：`symbol` 可选，传则查单只；不传返回全市场（已过滤非股票标的）；`trade_date` 为可选参数，格式 `YYYYMMDD`。支持分页；`page/page_size` 可省略，缺省 `1/50`，`page_size` 超过 200 按 200 处理。",
8011
7912
  "inputSchema": {
8012
7913
  "type": "object",
8013
7914
  "properties": {
@@ -8241,7 +8142,7 @@
8241
8142
  "type": "integer"
8242
8143
  },
8243
8144
  "page_size": {
8244
- "description": "每页条数，必填；1 到 500，超出范围上游返回参数错误",
8145
+ "description": "每页条数，必填；1 到 500，超出范围返回参数错误",
8245
8146
  "maximum": 500,
8246
8147
  "minimum": 1,
8247
8148
  "type": "integer"
@@ -8252,11 +8153,9 @@
8252
8153
  "type": "string"
8253
8154
  },
8254
8155
  "stock_code": {
8255
- "description": "A 股股票代码，支持 6 位纯代码、.SH/.SZ/.BJ 短后缀或 .XSHG/.XSHE/.BJSE 长后缀；MCP 自动规范化",
8156
+ "description": "A 股股票代码，需 6 位代码.大写短后缀且与交易所匹配（如 600519.SH），其它格式返回空数据",
8256
8157
  "examples": [
8257
- "000001",
8258
- "000001.SZ",
8259
- "000001.XSHE"
8158
+ "000001.SZ"
8260
8159
  ],
8261
8160
  "maxLength": 4096,
8262
8161
  "type": "string"
@@ -8333,7 +8232,7 @@
8333
8232
  "type": "integer"
8334
8233
  },
8335
8234
  "stock_code": {
8336
- "description": "股票代码，选填；支持六位数字（如 600000）、短后缀（600000.SH）和长后缀（600000.XSHG）；不传时查询全市场",
8235
+ "description": "股票代码，选填，需带 .SH/.SZ/.BJ 大写短后缀（如 600000.SH），裸码、长后缀或交易所不匹配时查不到数据；不传时查询全市场",
8337
8236
  "maxLength": 4096,
8338
8237
  "type": "string"
8339
8238
  }
@@ -8472,7 +8371,7 @@
8472
8371
  },
8473
8372
  "page_size": {
8474
8373
  "default": 100,
8475
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
8374
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
8476
8375
  "maximum": 1000,
8477
8376
  "minimum": 1,
8478
8377
  "type": "integer"
@@ -8512,7 +8411,7 @@
8512
8411
  },
8513
8412
  "page_size": {
8514
8413
  "default": 50,
8515
- "description": "每页条数；缺省 50，1 到 500，超出范围上游返回参数错误",
8414
+ "description": "每页条数；缺省 50，1 到 500，超出范围返回参数错误",
8516
8415
  "maximum": 500,
8517
8416
  "minimum": 1,
8518
8417
  "type": "integer"
@@ -8557,7 +8456,7 @@
8557
8456
  },
8558
8457
  "page_size": {
8559
8458
  "default": 100,
8560
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
8459
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
8561
8460
  "maximum": 1000,
8562
8461
  "minimum": 1,
8563
8462
  "type": "integer"
@@ -8602,7 +8501,7 @@
8602
8501
  },
8603
8502
  "page_size": {
8604
8503
  "default": 100,
8605
- "description": "每页条数；缺省 100，1 到 1000，超出范围上游返回参数错误",
8504
+ "description": "每页条数；缺省 100，1 到 1000，超出范围返回参数错误",
8606
8505
  "maximum": 1000,
8607
8506
  "minimum": 1,
8608
8507
  "type": "integer"
@@ -8630,7 +8529,7 @@
8630
8529
  {
8631
8530
  "name": "ft_v2_stock_candlesticks_batch",
8632
8531
  "title": "批量股票K线",
8633
- "description": "批量获取多个标的历史 K 线（股票/ETF/指数/债券），返回每个标的的 K 线数组。提示：`symbols`、`interval_unit`、`until_ts_millis` 必填；`symbols` 单次最多 20 只；`since_ts_millis` 与 `limit` 至少填一个；`since_ts_millis` 省略时按 `until_ts_millis` 与 `limit` 返回最近 N 根；显式时间范围上限按周期：日 12、周 120、月 360、年 600 个自然月。",
8532
+ "description": "批量获取多只 A 股股票的历史 K 线（日/周/月/年），结果为逐根 K 线记录，每条带 `symbol` 字段，同一标的的记录按时间升序，无行情标的不产生记录。提示：`symbols`、`interval_unit`、`until_ts_millis` 必填，单次最多 20 只；代码必须带市场后缀（.SH/.SZ/.BJ 或 .XSHG/.XSHE/.BJSE，如 600519.SH、000001.SZ、920002.BJ），裸代码与 ETF、指数等非股票标的返回参数错误；`since_ts_millis` 与 `limit` 至少填一个；`since_ts_millis` 省略时按 `until_ts_millis` 与 `limit` 返回最近 N 根；显式时间范围上限按周期：日 12、周 120、月 360、年 600 个自然月。",
8634
8533
  "inputSchema": {
8635
8534
  "type": "object",
8636
8535
  "properties": {
@@ -8665,7 +8564,7 @@
8665
8564
  "type": "integer"
8666
8565
  },
8667
8566
  "limit": {
8668
- "description": "每个标的的返回条数上限，1 到 1000；超出范围上游返回参数错误",
8567
+ "description": "每个标的的返回条数上限，1 到 1000；超出范围返回参数错误",
8669
8568
  "maximum": 1000,
8670
8569
  "minimum": 1,
8671
8570
  "type": "integer"
@@ -8676,13 +8575,12 @@
8676
8575
  "type": "integer"
8677
8576
  },
8678
8577
  "symbols": {
8679
- "description": "标的代码列表，允许股票、ETF、可转债和指数混合，例如 `[\"600519.SH\"，\"510300.SH\"，\"113027.SH\"，\"000300.SH\"]`；单次最多 20 只",
8578
+ "description": "A 股股票代码列表，如 `[\"600519.SH\",\"000001.SZ\",\"920002.BJ\"]`；支持 .XSHG/.XSHE/.BJSE 长后缀",
8680
8579
  "items": {
8681
8580
  "maxLength": 256,
8682
8581
  "type": "string"
8683
8582
  },
8684
- "maxItems": 20,
8685
- "minItems": 1,
8583
+ "maxItems": 500,
8686
8584
  "type": "array"
8687
8585
  },
8688
8586
  "until_ts_millis": {
@@ -8908,7 +8806,7 @@
8908
8806
  {
8909
8807
  "name": "ft_v2_stock_minutes_batch",
8910
8808
  "title": "市场数据 v2：stock_minutes/batch",
8911
- "description": "批量查询 A 股股票历史分钟 K 线；每只标的独立返回，单次最多 20 只，时间范围最多 30 个自然日。",
8809
+ "description": "批量查询 A 股股票历史分钟 K 线；结果为逐根分钟 K 线记录，每条带 `symbol` 字段，同一标的的记录按时间升序；单次最多 20 只，时间范围最多 30 个自然日。",
8912
8810
  "inputSchema": {
8913
8811
  "type": "object",
8914
8812
  "properties": {
@@ -8947,8 +8845,7 @@
8947
8845
  "maxLength": 256,
8948
8846
  "type": "string"
8949
8847
  },
8950
- "maxItems": 20,
8951
- "minItems": 1,
8848
+ "maxItems": 500,
8952
8849
  "type": "array"
8953
8850
  },
8954
8851
  "until_ts_millis": {
@@ -8984,7 +8881,7 @@
8984
8881
  },
8985
8882
  "page_size": {
8986
8883
  "default": 50,
8987
- "description": "每页条数；缺省 50，1 到 200，超出范围上游返回参数错误",
8884
+ "description": "每页条数；缺省 50，1 到 200，超出范围返回参数错误",
8988
8885
  "maximum": 200,
8989
8886
  "minimum": 1,
8990
8887
  "type": "integer"
@@ -9167,7 +9064,7 @@
9167
9064
  },
9168
9065
  "page_size": {
9169
9066
  "default": 50,
9170
- "description": "每页条数，默认 50，1 到 200，超出范围上游返回参数错误",
9067
+ "description": "每页条数，默认 50，1 到 200，超出范围返回参数错误",
9171
9068
  "maximum": 200,
9172
9069
  "minimum": 1,
9173
9070
  "type": "integer"
@@ -9304,7 +9201,7 @@
9304
9201
  },
9305
9202
  "page_size": {
9306
9203
  "default": 20,
9307
- "description": "每页条数；缺省 20，1 到 20，超出范围上游返回参数错误",
9204
+ "description": "每页条数；缺省 20，1 到 20，超出范围返回参数错误",
9308
9205
  "maximum": 20,
9309
9206
  "minimum": 1,
9310
9207
  "type": "integer"
@@ -9422,18 +9319,17 @@
9422
9319
  {
9423
9320
  "name": "ft_v4_convertible_bond_realtime_day_kline",
9424
9321
  "title": "可转债实时日K线",
9425
- "description": "获取 1～20 只可转债当前交易日的实时日 K 线，盘中数据会随行情变化。只接受 `symbols` 数组，不支持指定日期、周期、复权、limit 或分页参数；无可用行情时仍返回对应标的分组，`items` 为空且 `total` 为 0。",
9322
+ "description": "获取 1～20 只可转债当前交易日的实时日 K 线，盘中为进行中的日 K，每个有数据的标的返回 1 条。自动选择交易日：北京时间交易日 09:00 起为当日，09:00 前及非交易日为上一交易日。仅接受可转债标的，传入股票等非可转债标的返回参数错误；价格与成交额字段以字符串返回；无可用行情时不返回该标的的任何记录。",
9426
9323
  "inputSchema": {
9427
9324
  "type": "object",
9428
9325
  "properties": {
9429
9326
  "symbols": {
9430
- "description": "可转债代码数组，如 [\"113042.SH\",\"123107.SZ\"]",
9327
+ "description": "可转债代码列表，如 [\"113042.SH\",\"123107.SZ\"]；支持 .SH/.XSHG、.SZ/.XSHE 后缀或六位裸代码；单次 1 至 20 个",
9431
9328
  "items": {
9432
9329
  "maxLength": 256,
9433
9330
  "type": "string"
9434
9331
  },
9435
- "maxItems": 20,
9436
- "minItems": 1,
9332
+ "maxItems": 500,
9437
9333
  "type": "array"
9438
9334
  }
9439
9335
  },
@@ -9446,18 +9342,17 @@
9446
9342
  {
9447
9343
  "name": "ft_v4_convertible_bond_realtime_minute_kline",
9448
9344
  "title": "可转债实时分钟K线",
9449
- "description": "获取 1～20 只可转债当前交易日的实时 1 分钟 K 线。只接受 `symbols` 数组，不支持指定历史日期、周期、复权、limit 或分页参数；无可用行情时仍返回对应标的分组，`items` 为空且 `total` 为 0。",
9345
+ "description": "获取 1～20 只可转债当前交易日的实时 1 分钟 K 线。自动选择交易日：北京时间交易日 09:00 起为当日，09:00 前及非交易日为上一交易日。仅接受可转债标的，传入股票等非可转债标的返回参数错误；不支持指定历史日期、周期、复权或返回条数；无可用行情时不返回该标的的任何记录；价格与成交额字段以字符串返回。",
9450
9346
  "inputSchema": {
9451
9347
  "type": "object",
9452
9348
  "properties": {
9453
9349
  "symbols": {
9454
- "description": "可转债代码数组，如 [\"113042.SH\",\"123107.SZ\"]",
9350
+ "description": "可转债代码列表，如 [\"113042.SH\",\"123107.SZ\"]；支持 .SH/.XSHG、.SZ/.XSHE 后缀或六位裸代码；单次 1 至 20 个",
9455
9351
  "items": {
9456
9352
  "maxLength": 256,
9457
9353
  "type": "string"
9458
9354
  },
9459
- "maxItems": 20,
9460
- "minItems": 1,
9355
+ "maxItems": 500,
9461
9356
  "type": "array"
9462
9357
  }
9463
9358
  },
@@ -9529,18 +9424,17 @@
9529
9424
  {
9530
9425
  "name": "ft_v4_etf_realtime_day_kline",
9531
9426
  "title": "ETF实时日K线",
9532
- "description": "批量获取 ETF 当前交易日实时日 K 线。",
9427
+ "description": "批量获取 ETF 当前交易日的实时日 K 线，返回截至最新行情时刻的行情数据，不限制标的数量。仅接受 ETF 标的，传入股票、指数或其他非 ETF 标的返回参数错误；支持 `.SH`/`.XSHG`、`.SZ`/`.XSHE`、`.BJ`/`.BJSE` 后缀或六位裸代码；固定返回当前交易日日 K，不支持指定历史日期、时间范围、周期、复权方式或返回条数；标的无当日行情时不返回该标的的任何记录。",
9533
9428
  "inputSchema": {
9534
9429
  "type": "object",
9535
9430
  "properties": {
9536
9431
  "symbols": {
9537
- "description": "ETF 代码数组",
9432
+ "description": "ETF 代码列表，如 [\"510300.SH\",\"159915.SZ\"]；支持 .SH/.XSHG、.SZ/.XSHE、.BJ/.BJSE 后缀或六位裸代码；不限制数量",
9538
9433
  "items": {
9539
9434
  "maxLength": 256,
9540
9435
  "type": "string"
9541
9436
  },
9542
9437
  "maxItems": 500,
9543
- "minItems": 1,
9544
9438
  "type": "array"
9545
9439
  }
9546
9440
  },
@@ -9553,18 +9447,17 @@
9553
9447
  {
9554
9448
  "name": "ft_v4_etf_realtime_minute_kline",
9555
9449
  "title": "ETF实时分钟K线",
9556
- "description": "批量获取 ETF 当前交易日实时 1 分钟 K 线。",
9450
+ "description": "批量获取 ETF 当前交易日的实时 1 分钟 K 线，单次最多 20 个标的。仅接受 ETF 标的，传入股票、指数或其他非 ETF 标的返回参数错误；支持 `.SH`/`.XSHG`、`.SZ`/`.XSHE`、`.BJ`/`.BJSE` 后缀或六位裸代码；固定返回 1 分钟 K 线，不支持指定日期、时间范围、周期、复权方式或返回条数；标的无当日行情时不返回该标的的任何记录。",
9557
9451
  "inputSchema": {
9558
9452
  "type": "object",
9559
9453
  "properties": {
9560
9454
  "symbols": {
9561
- "description": "ETF 代码数组",
9455
+ "description": "ETF 代码列表，如 [\"510300.SH\",\"159915.SZ\"]；支持 .SH/.XSHG、.SZ/.XSHE、.BJ/.BJSE 后缀或六位裸代码；单次 1 至 20 个",
9562
9456
  "items": {
9563
9457
  "maxLength": 256,
9564
9458
  "type": "string"
9565
9459
  },
9566
- "maxItems": 20,
9567
- "minItems": 1,
9460
+ "maxItems": 500,
9568
9461
  "type": "array"
9569
9462
  }
9570
9463
  },
@@ -9577,7 +9470,7 @@
9577
9470
  {
9578
9471
  "name": "ft_v4_futures_minutes_realtime",
9579
9472
  "title": "期货实时分钟K线",
9580
- "description": "批量查询期货合约当前交易日的实时 1 分钟 K 线，每合约返回当日全部记录。提示：`symbols` 必填且单次最多 20 个，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；仅接受 `symbols`，不支持周期、时间区间、条数或分页参数；北京时间 21:00 后请求归属下一交易日（夜盘）；当日无行情的合约返回空分组。",
9473
+ "description": "批量查询期货合约当前交易日的实时 1 分钟 K 线，每合约返回当日全部记录。提示：`symbols` 必填且单次最多 20 个，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；仅接受 `symbols`，不支持周期、时间区间、条数或分页参数；北京时间 21:00 后请求归属下一交易日（夜盘）；当日无行情的合约不返回任何记录。",
9581
9474
  "inputSchema": {
9582
9475
  "type": "object",
9583
9476
  "properties": {
@@ -9587,8 +9480,7 @@
9587
9480
  "maxLength": 256,
9588
9481
  "type": "string"
9589
9482
  },
9590
- "maxItems": 20,
9591
- "minItems": 1,
9483
+ "maxItems": 500,
9592
9484
  "type": "array"
9593
9485
  }
9594
9486
  },
@@ -9601,7 +9493,7 @@
9601
9493
  {
9602
9494
  "name": "ft_v4_futures_realtime_day_kline",
9603
9495
  "title": "期货实时日K线",
9604
- "description": "批量查询期货合约当前交易日的实时日 K 线（由实时 1 分钟 K 线聚合），含开高低收、成交量额、成交均价、持仓量，每合约通常返回 0 或 1 条。提示：`symbols` 必填且单次最多 20 个，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；仅接受 `symbols`，不支持其他参数；北京时间 21:00 后请求归属下一交易日（夜盘）；当日无行情的合约返回空分组。",
9496
+ "description": "批量查询期货合约当前交易日的实时日 K 线（由实时 1 分钟 K 线聚合），含开高低收、成交量额、成交均价、持仓量，每合约通常返回 0 或 1 条。提示：`symbols` 必填且单次最多 20 个，仅支持完整后缀 .SHFE（上海期货交易所）/.INE（上海国际能源交易中心）/.DCE（大连商品交易所）/.CZCE（郑州商品交易所）/.CFFEX（中国金融期货交易所）/.GFEX（广州期货交易所）；仅接受 `symbols`，不支持其他参数；北京时间 21:00 后请求归属下一交易日（夜盘）；当日无行情的合约不返回任何记录。",
9605
9497
  "inputSchema": {
9606
9498
  "type": "object",
9607
9499
  "properties": {
@@ -9611,8 +9503,7 @@
9611
9503
  "maxLength": 256,
9612
9504
  "type": "string"
9613
9505
  },
9614
- "maxItems": 20,
9615
- "minItems": 1,
9506
+ "maxItems": 500,
9616
9507
  "type": "array"
9617
9508
  }
9618
9509
  },
@@ -9625,18 +9516,17 @@
9625
9516
  {
9626
9517
  "name": "ft_v4_index_realtime_day_kline",
9627
9518
  "title": "指数实时日K线",
9628
- "description": "批量获取指数当前交易日实时日 K 线。",
9519
+ "description": "批量获取指数当前交易日的实时日 K 线，返回截至最新行情时刻的行情数据，不限制标的数量。仅接受指数标的，传入股票、ETF 或其他非指数标的返回参数错误；支持 `.SH`/`.XSHG`、`.SZ`/`.XSHE`、`.BJ`/`.BJSE`、`.CSI` 后缀或六位裸代码；固定返回当前交易日日 K，不支持指定历史日期、时间范围、周期、复权方式或返回条数；标的无当日行情时不返回该标的的任何记录。",
9629
9520
  "inputSchema": {
9630
9521
  "type": "object",
9631
9522
  "properties": {
9632
9523
  "symbols": {
9633
- "description": "指数代码数组",
9524
+ "description": "指数代码列表，如 [\"000300.CSI\",\"000905.CSI\"]；支持 .SH/.XSHG、.SZ/.XSHE、.BJ/.BJSE、.CSI 后缀或六位裸代码；不限制数量",
9634
9525
  "items": {
9635
9526
  "maxLength": 256,
9636
9527
  "type": "string"
9637
9528
  },
9638
9529
  "maxItems": 500,
9639
- "minItems": 1,
9640
9530
  "type": "array"
9641
9531
  }
9642
9532
  },
@@ -9649,18 +9539,17 @@
9649
9539
  {
9650
9540
  "name": "ft_v4_index_realtime_minute_kline",
9651
9541
  "title": "指数实时分钟K线",
9652
- "description": "批量获取指数当前交易日实时 1 分钟 K 线。",
9542
+ "description": "批量获取指数当前交易日的实时 1 分钟 K 线，单次最多 20 个标的。仅接受指数标的，传入股票、ETF 或其他非指数标的返回参数错误；支持 `.SH`/`.XSHG`、`.SZ`/`.XSHE`、`.BJ`/`.BJSE`、`.CSI` 后缀或六位裸代码；固定返回 1 分钟 K 线，不支持指定日期、时间范围、周期、复权方式或返回条数；标的无当日行情时不返回该标的的任何记录。",
9653
9543
  "inputSchema": {
9654
9544
  "type": "object",
9655
9545
  "properties": {
9656
9546
  "symbols": {
9657
- "description": "指数代码数组",
9547
+ "description": "指数代码列表，如 [\"000300.CSI\",\"000905.CSI\"]；支持 .SH/.XSHG、.SZ/.XSHE、.BJ/.BJSE、.CSI 后缀或六位裸代码；单次 1 至 20 个",
9658
9548
  "items": {
9659
9549
  "maxLength": 256,
9660
9550
  "type": "string"
9661
9551
  },
9662
- "maxItems": 20,
9663
- "minItems": 1,
9552
+ "maxItems": 500,
9664
9553
  "type": "array"
9665
9554
  }
9666
9555
  },
@@ -9713,18 +9602,17 @@
9713
9602
  {
9714
9603
  "name": "ft_v4_stock_realtime_day_kline",
9715
9604
  "title": "股票实时日K线",
9716
- "description": "批量获取股票当前交易日实时日 K 线。",
9605
+ "description": "批量获取股票当前交易日的实时日 K 线，返回截至最新行情时刻的开高低收、成交量额与换手率，不限制标的数量。支持 `.SH`/`.XSHG`、`.SZ`/`.XSHE`、`.BJ`/`.BJSE` 后缀或六位裸代码；固定返回当前交易日日 K，不支持指定历史日期、时间范围、周期、复权方式或返回条数；标的无当日行情时不返回该标的的任何记录。",
9717
9606
  "inputSchema": {
9718
9607
  "type": "object",
9719
9608
  "properties": {
9720
9609
  "symbols": {
9721
- "description": "股票代码数组",
9610
+ "description": "股票代码列表，如 [\"600519.SH\",\"000001.SZ\"]；支持 .SH/.XSHG、.SZ/.XSHE、.BJ/.BJSE 后缀或六位裸代码；不限制数量",
9722
9611
  "items": {
9723
9612
  "maxLength": 256,
9724
9613
  "type": "string"
9725
9614
  },
9726
9615
  "maxItems": 500,
9727
- "minItems": 1,
9728
9616
  "type": "array"
9729
9617
  }
9730
9618
  },
@@ -9737,18 +9625,17 @@
9737
9625
  {
9738
9626
  "name": "ft_v4_stock_realtime_minute_kline",
9739
9627
  "title": "股票实时分钟K线",
9740
- "description": "批量获取股票当前交易日实时 1 分钟 K 线。",
9628
+ "description": "批量获取股票当前交易日的实时 1 分钟 K 线，单次最多 20 个标的。支持 `.SH`/`.XSHG`、`.SZ`/`.XSHE`、`.BJ`/`.BJSE` 后缀或六位裸代码；固定返回 1 分钟 K 线，不支持指定日期、时间范围、周期、复权方式或返回条数；标的无当日行情时不返回该标的的任何记录。",
9741
9629
  "inputSchema": {
9742
9630
  "type": "object",
9743
9631
  "properties": {
9744
9632
  "symbols": {
9745
- "description": "股票代码数组",
9633
+ "description": "股票代码列表，如 [\"600519.SH\",\"000001.SZ\"]；支持 .SH/.XSHG、.SZ/.XSHE、.BJ/.BJSE 后缀或六位裸代码；单次 1 至 20 个",
9746
9634
  "items": {
9747
9635
  "maxLength": 256,
9748
9636
  "type": "string"
9749
9637
  },
9750
- "maxItems": 20,
9751
- "minItems": 1,
9638
+ "maxItems": 500,
9752
9639
  "type": "array"
9753
9640
  }
9754
9641
  },