Ftshare Market Data

FT AI Market Data Skills

本 skill 是 ftshare-market-data 的统一路由入口。

根据用户问题，从下方「能力总览」匹配对应子 skill，然后通过 run.py 执行并解析响应。

> market.ft.tech 接口默认使用内置基础地址，接口路径统一从 /api/v1 开始；可通过 FTSHARE_BASE_URL 覆盖。

---

调用方式（唯一规则）

run.py 与本文件（SKILL.md）位于同一目录。执行时：

1. 取本文件的绝对路径，将末尾 /SKILL.md 替换为 /run.py，得到 `` 。
2. 调用：python [参数...]

# 示例（ 为实际绝对路径）
python  stock-list-all-stocks
python  stock-ipos --page 1 --page_size 20
python  stock-ipos --all
python  block-trades
python  margin-trading-details --page 1 --page_size 20
python  margin-trading-details --all
python  semantic-search-news --query 人工智能
python  semantic-search-news --query 人工智能 --limit 10 --year 2026 --start_time 2026-03-01T00:00:00+08:00 --end_time 2026-03-15T23:59:59+08:00
python  cb-lists
python  cb-base-data --symbol_code 110070.SH
python  etf-pcfs --date 20260309
python  etf-pcf-download --filename pcf_159003_20260309.xml --output pcf.xml
python  fund-basicinfo-single-fund --institution-code 000001
python  fund-cal-return-single-fund-specific-period --institution-code 159619 --cal-type 1Y
python  fund-nav-single-fund-paginated --institution-code 000001 --page 1 --page-size 50
python  fund-overview-all-funds-paginated --page 1 --page-size 20
python  fund-support-symbols-all-funds-paginated --page 1 --page-size 20
python  get-nth-trade-date --n 5
python  financial-calendar --start-date 2026-05-01 --end-date 2026-05-07
python  company-hk --trade_code 00700.HK
python  hk-valuatnanalyd --trade_code 00700.HK --page 1 --page_size 20
python  hk-view --hk_code 00700.HK
python  hk-candlesticks --trade-code 00700.HK --interval-unit day --until-date 2026-03-24 --since-date 2026-03-01 --limit 20
python  northbound --date 20250101
python  southbound --date 20250101
python  index-description-paginated --page 1 --page-size 20
python  index-description-download --url-hash  --output ./index-desc.pdf
python  index-weight-summary --index-code 000300 --page 1 --page-size 20
python  index-weight-list --index-code 000300 --page 1 --page-size 20
python  index-weight-download --url-hash  --output ./index-weights.xlsx
python  eastmoney-concept-boards
python  eastmoney-board-daily-ohlc --board_code BK1024 --start_date 2021-01-01 --end_date 2021-12-31 --page 1 --page_size 20
python  eastmoney-board-daily-ohlc --board_code BK1024 --all
python  eastmoney-board-latest-ohlc --board_code BK1024
python  eastmoney-board-latest-ohlc --all
python  eastmoney-board-constituents --board_code BK1024
python  10jqk-board-list
python  10jqk-board-list --module concept
python  10jqk-board-list --search 人工智能
python  10jqk-board-kline --board-code 885311 --page 1 --page-size 20
python  10jqk-board-all-kline --start-date 2026-05-20 --end-date 2026-05-25
python  stock-rank-xueqiu --rank-group follow --period 7d --page 1 --page-size 20
python  stock-rank-eastmoney --rank-group hot --market A
python  stock-comment-index
python  stock-comment-score --symbol 000001
python  stock-comment-org-participate --symbol 000001
python  stock-comment-desire --symbol 000001
python  stock-comment-focus --symbol 000001
python  stock-daec-stocks --board all --page 1 --page_size 5 --order_by "change_rate desc"
python  stock-realtime-list --board chi-next --page 1 --page_size 5
python  stock-intraday-prices --symbol 600000.XSHG --range Today
python  stock-intraday-prices --symbol 600000.XSHG --compat v2 --since TODAY
python  stock-ohlcs --symbol 600000.XSHG --compat v2 --span DAY1 --limit 5
python  limit-up-pool
python  limit-up-pool-yesterday
python  limit-up-break-pool
python  limit-down-pool
python  shareholder-meeting
python  shareholder-meeting --page 1 --page_size 50
python  stock-unlock-by-stock --stock_code 000001
python  stock-unlock-by-date --start_date 2026-06-01 --end_date 2026-06-30
python  major-contract-by-date --start_date 20260526 --end_date 20260526
python  major-contract-by-symbol --symbol 601668
python  major-contract-summary
python  eastmoney-stock-valuation --symbol 000001 --page 1 --page_size 10
python  eastmoney-stock-valuation --symbol 000001 --start_date 2026-06-01 --end_date 2026-06-09
python  eastmoney-stock-valuation --start_date 2026-06-01 --end_date 2026-06-09 --all
python  eastmoney-market-valuation --market_code 000300 --page 1 --page_size 10
python  eastmoney-market-valuation --market_code 000001 --start_date 2026-06-01 --end_date 2026-06-09
python  eastmoney-market-valuation --start_date 2026-06-01 --end_date 2026-06-09 --all
python  eastmoney-us-stock-list
python  eastmoney-us-stock-list --page 1 --page_size 50
python  eastmoney-us-stock-list --all
python  eastmoney-us-stock-daily-ohlc --stock_code AAPL --page 1 --page_size 50
python  eastmoney-us-stock-daily-ohlc --stock_code AAPL --start_date 2026-01-01 --end_date 2026-06-10
python  eastmoney-us-stock-daily-ohlc --stock_code AAPL --start_date 2026-01-01 --end_date 2026-06-10 --all
python  eastmoney-us-stock-latest-ohlc --stock_code AAPL --page 1 --page_size 20
python  eastmoney-us-stock-latest-ohlc --page 1 --page_size 50
python  eastmoney-us-stock-latest-ohlc --all
python  stock-capital-flows --page 1 --page-size 50
python  stock-capital-flows --date 20260616 --time 1530 --page 1 --page-size 50
python  stock-capital-flows --date 20260616 --all
python  stock-capital-flows --date 20260616 --symbol 601138.SH
python  stock-capital-flows --symbol 601138.SH
python  us-basic --stock_code NVDA
python  us-basic --page 1 --page_size 50
python  us-income --stock_code NVDA --period 2024 --report_type Q4
python  us-cashflow --stock_code AAPL --period 2024 --report_type Q4
python  us-balance --stock_code NVDA --period 2024 --report_type Q4
python  hk-income --trade_code 00700.HK --year 2024 --report_type annual
python  hk-income --trade_code 2388 --company_type bank
python  hk-cashflow --stock_code 00700.HK --year 2024 --report_type annual
python  hk-balance --trade_code 00700.HK --year 2024 --report_type annual
python  eastmoney-hk-index-daily-kline --index_code HSI --page 1 --page_size 5
python  eastmoney-hk-index-daily-kline --index_code HSCEI --start_date 2026-06-01 --end_date 2026-06-15
python  hsi-daily-weight --index_slug HSI --page 1 --page_size 200
python  hsi-daily-weight --trade_date 20260529 --index_slug HSCEI
python  hsi-daily-weight --stock_code 0700

> run.py 内部通过 __file__ 自定位，无论安装在何处都能正确找到各子 skill 的脚本。

所有 market.ft.tech handler 默认使用内置基础地址。本地或内网服务可通过环境变量切换 API 地址：

FTSHARE_BASE_URL=http://127.0.0.1:8000/ python  stock-intraday-prices --symbol 600000.XSHG --compat v2 --since TODAY

---

能力总览

0. 交易日工具

• get-nth-trade-date：获取当前日期的前 N 个交易日。必填：--n（≥1）。用户查「近 N 天」K 线时先调本接口得到 nth_trade_date（YYYYMMDD），可直接作为 stock-ohlcs / etf-ohlcs / index-ohlcs 的 --since（cb-candlesticks 仍需转为毫秒时间戳）。

0.5. 财经日历

• financial-calendar：按日期范围查询财经日历（华尔街见闻 + 百度财经），涵盖宏观数据公布、IPO 日程、财报时间、交易提醒等。必填：--start-date、--end-date（格式 YYYY-MM-DD）。注意：多日范围可能因响应过大导致服务端截断，建议每次仅查询单日，多日需逐日调用后合并。

1. 股票数据（A 股）

• stock-list-all-stocks：获取全部 A 股股票的代码和名称列表（沪深京），自动返回最新交易日数据。无需任何参数。

• stock-quotes-list：查询 A 股行情列表（分页），支持按板块筛选、多字段排序。必填参数：--order_by、--page_no、--page_size；可选 --filter、--masks。请求头需携带 X-Client-Name: ft-claw（脚本已内置）。

• stock-daec-stocks：查询 A 股行情列表 daec 全字段族，覆盖全市场、上证 A 股、深证 A 股、北证 A 股。必填：--board（all/xshg/xshe/bjse）；可选 --page、--page_size、--filter、--order_by、--all。

• stock-realtime-list：查询 A 股 stock-list 实时精简族，覆盖创业板、科创板、新股。必填：--board（chi-next/star/new）；可选 --page、--page_size、--all。注意：该接口族没有 all 板块，全市场用 stock-daec-stocks --board all。

• stock-intraday-prices：查询指定 A 股标的 1 分钟分时数据，直接映射 daec 参数。必填：--symbol；可选 --range（Today/FiveDays）、--days、--ts_ms、--compat v2、--since、--since_ts_ms。如需旧版 --stock --since 契约，可继续用 stock-prices。

• stock-ipos：获取 A 股 IPO 列表，含发行价格、发行数量、申购日期、上市日期等，支持分页查询。必填参数：--page、--page_size；支持 --all 自动翻页拉取全量数据。

• block-trades：查询 A 股大宗交易列表，含买卖方营业部、成交价、成交量、溢价率等。无需任何参数，直接返回数组。

• margin-trading-details：获取 A 股融资融券明细列表，含融资余额、融资买入额、融资偿还额、融券余量等，按融资净买入额降序排列，支持分页查询。必填参数：--page、--page_size；支持 --all 自动翻页拉取全量数据。

• stock-security-info：查询单只股票的实时行情与估值指标，含开高低收、多周期涨跌幅、市盈率、市净率、每股净资产等。必填参数：--symbol（带市场后缀，如 600519.SH）。接口域名为 https://ftai.chat（脚本内 URL 校验已允许该域名）。

2. 新闻 / 可转债 / ETF PCF

• semantic-search-news：语义搜索新闻，数据仅支持当年、最近半个月。必填：--query；可选 --limit、--year。展示时需含来源（source_site）与文章链接，并提示数据仅半个月内。
• cb-lists：可转债全量列表，无参数，数据为前一交易日。
• cb-base-data：单只可转债基础信息（转股价、转股价值、到期日等）。必填：--symbol_code（如 110070.SH）。若用户仅给名称，先通过 cb-lists 映射代码再查。
• etf-pcfs：指定日期 ETF PCF 列表。必填：--date（YYYYMMDD）；可选 --page、--page_size。
• etf-pcf-download：按文件名下载 PCF XML。必填：--filename；可选：--output（仅允许当前工作目录下路径）。filename 须先由 etf-pcfs 列表接口取得，勿在自动化测试中硬编码。
• etf-component：查询单只 ETF 成份股列表（代码与名称）。必填：--symbol（如 510300.XSHG）；接口报错或未找到时将接口返回的错误信息原样输出到 stderr。
• etf-pre-single：查询单只 ETF 盘前数据（申购赎回单位、净值、现金差额等）。必填：--symbol；可选：--date（YYYYMMDD，不传为当日 CST）；接口报错或未找到时将接口返回的错误信息原样输出到 stderr。非盘前时段可能失败，冒烟测试建议传已知交易日 --date。

3. 基金

• fund-basicinfo-single-fund：查询指定基金基础信息（名称、管理人、经理、类型、投资目标等）。必填：--institution-code（6 位基金代码）。若用户仅给基金名称，先通过 fund-support-symbols-all-funds-paginated 或 fund-overview-all-funds-paginated 映射代码再查。
• fund-cal-return-single-fund-specific-period：查询指定基金在指定区间的累计收益率时间序列。必填：--institution-code、--cal-type（1M/3M/6M/1Y/3Y/5Y/YTD）。建议先完成名称到代码映射后再调用。
• fund-nav-single-fund-paginated：查询指定基金净值历史（分页）。必填：--institution-code；可选：--page、--page-size。建议先完成名称到代码映射后再调用。
• fund-overview-all-funds-paginated：查询所有基金概览信息（分页）。可选：--page、--page-size。
• fund-support-symbols-all-funds-paginated：查询所有支持基金的标的列表（分页）。可选：--page、--page-size。

4. 港股

• company-hk：按港股交易代码查询公司介绍（名称、成立日期、注册资本、主营业务等）。必填：--trade_code（如 00700.HK）。
• hk-valuatnanalyd：分页查询港股估值分析（PE/PB/PS、股息率、换手率等）。可选：--trade_code、--page、--page_size。
• hk-view：按港股代码查询单票基础视图（板块、上市状态、股本、市值、估值指标）。必填：--hk_code。
• hk-candlesticks：按港股代码查询日/月/季/年 K 线。必填：--trade-code、--interval-unit、--until-date；可选：--since-date、--adjust-kind、--interval-value、--limit。
• northbound：查询指定交易日北向资金（沪股通、深股通）交易汇总数据。必填：--date（YYYYMMDD）。返回合计成交额及分市场（SH/SZ）成交额与笔数。
• southbound：查询指定交易日南向资金（港股通沪、港股通深）交易汇总数据。必填：--date（YYYYMMDD）。返回合计及分市场的买入额、卖出额、净买入额与成交笔数。

5. 东财板块数据

• eastmoney-concept-boards：查询东财概念板块列表，返回全量板块代码、名称及成分标的代码。无需任何参数，直接返回数组。板块代码（BK 前缀）可用于后续 K 线查询。
• eastmoney-board-constituents：查询东财指定板块的全部成分股代码和名称。必填：--board_code（如 BK1024）。板块代码对行业和概念板块通用。
• eastmoney-board-daily-ohlc：查询东财单板块历史 OHLC（开高低收、成交量、成交额、涨跌幅等），支持日期范围过滤与分页。必填：--board_code（如 BK1024）；可选：--start_date、--end_date（YYYY-MM-DD 或 YYYYMMDD）、--page、--page_size；支持 --all 自动翻页。板块代码对行业和概念板块通用。
• eastmoney-board-latest-ohlc：查询东财单板块最新 OHLC 行情数据，支持分页。可选：--board_code（不传则返回全部板块最新数据）、--page、--page_size；支持 --all 自动翻页。

6. 同花顺板块数据

• 10jqk-board-list：同花顺全量板块列表（概念/证监会/行业/地域），无需参数。可选 --module 过滤类型（concept/csrc/industry/region）、--search 搜索名称/代码。板块代码用于后续 K 线查询。
• 10jqk-board-kline：指定同花顺板块历史日 K 线（开高低收、成交量）。必填：--board-code（由 10jqk-board-list 获取）；可选：--page、--page-size。
• 10jqk-board-all-kline：全板块 K 线按日期范围查询（分页）。可选：--start-date、--end-date（YYYY-MM-DD 或 YYYYMMDD）、--page、--page-size。

7. 涨跌停股池

• limit-up-pool：当日涨停股池（标的代码、涨停价、封板时间、炸板次数）。无需参数。
• limit-up-pool-yesterday：昨日涨停股池，数据结构与当日相同。无需参数。
• limit-up-break-pool：当日炸板股池（涨停后又打开的股票）。无需参数。
• limit-down-pool：当日跌停股池（标的代码、跌停价、翘板次数、封单资金）。无需参数。

8. 股票热度排行榜

• stock-rank-xueqiu：查询雪球平台股票排行榜（关注/讨论/交易）。可选：--rank-group（follow/tweet/deal）、--period（7d/total）、--trade-date（YYYY-MM-DD）、--page、--page-size（最大 100）。
• stock-rank-eastmoney：查询东方财富股票排行榜（人气榜/飙升榜），支持 A 股/港股/美股。可选：--rank-group（hot/up）、--market（A/HK/US）、--trade-date（YYYY-MM-DD）。

9. 公司行动（股东大会 / 限售解禁 / 重大合同）

股东大会

• shareholder-meeting：查询 A 股上市公司股东大会信息（会议日期、股权登记日、投票日期、提案内容等），支持分页。可选：--page、--page_size。

限售解禁

• stock-unlock-by-stock：按证券代码查询限售解禁批次及股东明细（解禁日期、解禁市值、占总股本比例、股东明细等），支持分页。必填：--stock_code（6 位代码）；可选 --page、--page_size。
• stock-unlock-by-date：按解禁日期范围查询限售解禁批次及股东明细，支持分页。必填：--start_date、--end_date（格式 YYYY-MM-DD）；可选 --page、--page_size。

重大合同

• major-contract-by-date：按公告日期范围查询 A 股重大合同（签约方、合同金额、合同类型、占营收比例等）。必填：--start_date、--end_date（格式 YYYYMMDD）。
• major-contract-by-symbol：按股票代码查询重大合同历史，按公告日期降序，支持分页。必填：--symbol（6 位代码）；可选 --page、--page_size。
• major-contract-summary：近一年个股重大合同汇总排名（合同数量、合同总额、占营收比），按合同总额降序，支持分页。可选：--page、--page_size。

10. 千股千评

• stock-comment-index：查询东方财富千股千评综合诊断主表，含收盘价、涨跌幅、换手率、市盈率、主力成本、机构参与度、综合评分、排名、关注指数。无参数，返回全量（约 5000+ 条）。
• stock-comment-score：查询指定股票的历史综合评分走势。必填：--symbol（6 位代码）。
• stock-comment-org-participate：查询指定股票的历史机构参与度走势。必填：--symbol（6 位代码）。
• stock-comment-desire：查询指定股票的市场参与意愿及 5 日均值变化。必填：--symbol（6 位代码）。
• stock-comment-focus：查询指定股票的市场热度用户关注指数、排名及变动。必填：--symbol（6 位代码）。

11. 估值分析数据

• eastmoney-stock-valuation：查询东财个股日估值数据（PE TTM/LYR、PB、市现率、市销率、PEG、总市值、流通市值、收盘价等）。可选：--symbol、--trade_date、--start_date、--end_date、--page、--page_size；支持 --all 自动翻页。推荐使用区间查询（--start_date + --end_date），当前单日查询可能返回空。
• eastmoney-market-valuation：查询东财市场日估值数据（上证指数/沪深300/深证成指/创业板指/科创50/北证50 的 PE、总市值、流通市值、收盘点位等）。可选：--market_code、--trade_date、--start_date、--end_date、--page、--page_size；支持 --all 自动翻页。推荐使用区间查询。

12. 东财美股数据

• eastmoney-us-stock-list：获取东财美股全量列表（~5700+ 只），含代码、名称、市值、最新价、涨跌幅、市盈率等，支持服务端分页（500 条/页）。可选：--page、--page_size；--all 返回全量。注意：不覆盖苹果等美股大盘蓝筹，以东财中小盘和中概股为主。
• eastmoney-us-stock-daily-ohlc：查询东财美股历史日 K 线（开高低收、成交量、成交额、振幅）。有日期范围时按 3 天窗口分批请求避免服务端 500，无日期范围时全量拉取。必填：--stock_code（东财美股代码如 AAL）；可选：--start_date、--end_date（YYYY-MM-DD 或 YYYYMMDD）、--page、--page_size；支持 --all。注意：全部数值字段按字符串返回。
• eastmoney-us-stock-latest-ohlc：查询东财美股最新一根日 K 线行情，支持分页与单票过滤。可选：--stock_code（不传返回全部美股）、--page、--page_size；支持 --all 自动翻页。注意：价格字段为字符串，成交量/振幅为数值。

13. 资金流向（15 分钟切片）

• stock-capital-flows：查询 A 股股票资金流向（主力净流入，15 分钟级别）。凡问"分钟级 / 15 分钟级 / 分时资金流"一律用本 skill。不传 --date 返回当前实时快照；传入 --date（YYYYMMDD）返回该日指定 15 分钟切片快照，默认 --time 1530（日终），--time 分钟须为 00/15/30/45。可选 --page、--page-size；支持 --all 自动翻页；支持 --symbol 601138.SH 单股定位（逐页扫描，返回全市场排名 + 单条记录，可叠加 --date/--time 查某只票某切片）。仅 A 股（不含 ETF/指数），按主力净流入降序；金额字段以字符串返回，单位元。

14. 美股基础信息与财报（native）

> 与 eastmoney-us-stock-list（东财行情：最新价/市值/PE）区别：本节为 native 基础信息 + 财报三表。

• us-basic：查询美股基础信息（代码、中英文名、上市/退市日期），~5315 只。可选 --stock_code（纯代码如 NVDA，传则精确查单股）、--page、--page_size；支持 --all。查"美股有哪些/代码/名称/上市日期"用本接口。
• us-income：查询美股利润表（长表 EAV）。必填 --stock_code；可选 --period（财年）、--report_type（Q1/Q2/Q3/Q4/H1）、--start_date/--end_date（YYYYMMDD）、--page/--page_size；支持 --all。
• us-cashflow：查询美股现金流量表（长表 EAV），参数同 us-income。
• us-balance：查询美股资产负债表（长表 EAV，时点数据），参数同 us-income。
• 财报三表共用要点：长表 EAV（每行一科目）、按报告期分页（page_size 限报告期数，items 行数可能 ≫ page_size，total_items 是报告期数）、Q4/Q3 返回累计+单季两套、美股财年非自然年（period 匹配 stmt_year）、数值为字符串、只输出非 0 科目。

15. 港股财报与港股指数（native + 东财）

> 与 §4 港股（公司介绍/估值/视图/K线）互补：本节为港股财报三表与东财港股指数日K线。

• hk-income：查询港股利润表（宽表）。按公司类型分子接口：--company_type gene(一般企业,默认)/bank(银行)/insur(保险)。可选 --trade_code（00700.HK 或 700）、--year+--report_type（annual/semi，须成对，仅最近 3 年）、--start_date/--end_date（YYYYMMDD）、--page/--page_size；支持 --all。至少一个过滤条件，否则 400。
• hk-cashflow：查询港股现金流量表（宽表，111 字段）。参数同上，但股票代码用 --stock_code（非 trade_code）。
• hk-balance：查询港股资产负债表（宽表，时点数据）。按公司类型分子接口（--company_type gene/bank/insur），参数同 hk-income。
• eastmoney-hk-index-daily-kline：查询东财港股指数（恒生 HSI / 国企 HSCEI / 恒生科技 HSTECH 等）日 K 线（开高低收、量额、振幅、涨跌幅/涨跌额、换手率）。可选 --index_code、--trade_date（YYYY-MM-DD）、--start_date+--end_date（YYYY-MM-DD）、--page/--page_size；支持 --all。**响应信封不同：数据在 data.records

…

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FTShare-Lab
• Source: FTShare-Lab/FTShare-skills
• License: MIT
• Homepage: https://github.com/ftshare-lab/FTShare-skills

Install and usage instructions live in the source repository linked above.