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`，得到 `<RUN_PY>` 。 2. 调用：`python <RUN_PY> <子skill名> [参数...]` ```bash # 示例（<RUN_PY> 为实际绝对路径） python <RUN_PY> stock-list-all-stocks python <RUN_PY> stock-ipos --page 1 --page_size 20 python <RUN_PY> stock-ipos --all python <RUN_PY> block-trades python <RUN_PY> margin-trading-details --page 1 --page_size 20 python <RUN_PY> margin-trading-details --all python <RUN_PY> semantic-search-news --query 人工智能 python <RUN_PY> 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 <RUN_PY> cb-lists python <RUN_PY> cb-base-data --symbol_code 110070.SH python <RUN_PY> convertible-bond-candlesticks --symbol 113027.SH --interval-unit Day --until-ts-millis 1756791000000 --limit 5 python <RUN_PY> convertible-bond-candlesticks-batch --symbols 113027.SH,123001.SZ --interval-unit Day --until-ts-millis 1756791000000 --limit 2 python <RUN_PY> etf-pcfs --date 20260309 python <RUN_PY> etf-pcf-download --filename pcf_159003_20260309.xml --output pcf.xml python <RUN_PY> fund-basicinfo-single-fund --institution-code 000001 python <RUN_PY> fund-cal-return-single-fund-specific-period --institution-code 159619 --cal-type 1Y python <RUN_PY> fund-nav-single-fund-paginated --institution-code 000001 --page 1 --page-size 50 python <RUN_PY> fund-overview-all-funds-paginated --page 1 --page-size 20 python <RUN_PY> fund-support-symbols-all-funds-paginated --page 1 --page-size 20 python <RUN_PY> get-nth-trade-date --n 5 python <RUN_PY> financial-calendar --start-date 2026-05-01 --end-date 2026-05-07 python <RUN_PY> company-hk --trade_code 00700.HK python <RUN_PY> hk-valuatnanalyd --trade_code 00700.HK --page 1 --page_size 20 python <RUN_PY> hk-view --hk_code 00700.HK python <RUN_PY> hk-candlesticks --trade-code 00700.HK --interval-unit day --until-date 2026-03-24 --since-date 2026-03-01 --limit 20 python <RUN_PY> northbound --date 20250101 python <RUN_PY> southbound --date 20250101 python <RUN_PY> index-description-paginated --page 1 --page-size 20 python <RUN_PY> index-description-download --url-hash <url_hash> --output ./index-desc.pdf python <RUN_PY> index-weight-summary --index-code 000300 --page 1 --page-size 20 python <RUN_PY> index-weight-list --index-code 000300 --page 1 --page-size 20 python <RUN_PY> index-weight-download --url-hash <url_hash> --output ./index-weights.xlsx python <RUN_PY> eastmoney-concept-boards python <RUN_PY> eastmoney-board-daily-ohlc --board_code BK1024 --start_date 2021-01-01 --end_date 2021-12-31 --page 1 --page_size 20 python <RUN_PY> eastmoney-board-daily-ohlc --board_code BK1024 --all python <RUN_PY> eastmoney-board-latest-ohlc --board_code BK1024 python <RUN_PY> eastmoney-board-latest-ohlc --all python <RUN_PY> eastmoney-board-constituents --board_code BK1024 python <RUN_PY> 10jqk-board-list python <RUN_PY> 10jqk-board-list --module concept python <RUN_PY> 10jqk-board-list --search 人工智能 python <RUN_PY> 10jqk-board-kline --board-code 885311 --page 1 --page-size 20 python <RUN_PY> 10jqk-board-all-kline --start-date 2026-05-20 --end-date 2026-05-25 python <RUN_PY> stock-rank-xueqiu --rank-group follow --period 7d --page 1 --page-size 20 python <RUN_PY> stock-rank-eastmoney --rank-group hot --market A python <RUN_PY> stock-comment-index python <RUN_PY> stock-comment-score --symbol 000001 python <RUN_PY> stock-comment-org-participate --symbol 000001 python <RUN_PY> stock-comment-desire --symbol 000001 python <RUN_PY> stock-comment-focus --symbol 000001 python <RUN_PY> stock-daec-stocks --board all --page 1 --page_size 5 --order_by "change_rate desc" python <RUN_PY> stock-realtime-list --board chi-next --page 1 --page_size 5 python <RUN_PY> stock-intraday-prices --symbol 600000.XSHG --range Today python <RUN_PY> stock-intraday-prices --symbol 600000.XSHG --compat v2 --since TODAY python <RUN_PY> stock-ohlcs --symbol 600000.XSHG --compat v2 --span DAY1 --limit 5 python <RUN_PY> limit-up-pool python <RUN_PY> limit-up-pool-yesterday python <RUN_PY> limit-up-break-pool python <RUN_PY> limit-down-pool python <RUN_PY> shareholder-meeting python <RUN_PY> shareholder-meeting --page 1 --page_size 50 python <RUN_PY> stock-unlock-by-stock --stock_code 000001 python <RUN_PY> stock-unlock-by-date --start_date 2026-06-01 --end_date 2026-06-30 python <RUN_PY> major-contract-by-date --start_date 20260526 --end_date 20260526 python <RUN_PY> major-contract-by-symbol --symbol 601668 python <RUN_PY> major-contract-summary python <RUN_PY> eastmoney-stock-valuation --symbol 000001 --page 1 --page_size 10 python <RUN_PY> eastmoney-stock-valuation --symbol 000001 --start_date 2026-06-01 --end_date 2026-06-09 python <RUN_PY> eastmoney-stock-valuation --start_date 2026-06-01 --end_date 2026-06-09 --all python <RUN_PY> eastmoney-market-valuation --market_code 000300 --page 1 --page_size 10 python <RUN_PY> eastmoney-market-valuation --market_code 000001 --start_date 2026-06-01 --end_date 2026-06-09 python <RUN_PY> eastmoney-market-valuation --start_date 2026-06-01 --end_date 2026-06-09 --all python <RUN_PY> eastmoney-us-stock-list python <RUN_PY> eastmoney-us-stock-list --page 1 --page_size 50 python <RUN_PY> eastmoney-us-stock-list --all python <RUN_PY> eastmoney-us-stock-daily-ohlc --stock_code AAPL --page 1 --page_size 50 python <RUN_PY> eastmoney-us-stock-daily-ohlc --stock_code AAPL --start_date 2026-01-01 --end_date 2026-06-10 python <RUN_PY> eastmoney-us-stock-daily-ohlc --stock_code AAPL --start_date 2026-01-01 --end_date 2026-06-10 --all python <RUN_PY> eastmoney-us-stock-latest-ohlc --stock_code AAPL --page 1 --page_size 20 python <RUN_PY> eastmoney-us-stock-latest-ohlc --page 1 --page_size 50 python <RUN_PY> eastmoney-us-stock-latest-ohlc --all python <RUN_PY> stock-capital-flows --page 1 --page-size 50 python <RUN_PY> stock-capital-flows --date 20260616 --time 1530 --page 1 --page-size 50 python <RUN_PY> stock-capital-flows --date 20260616 --all python <RUN_PY> stock-capital-flows --date 20260616 --symbol 601138.SH python <RUN_PY> stock-capital-flows --symbol 601138.SH python <RUN_PY> us-basic --stock_code NVDA python <RUN_PY> us-basic --page 1 --page_size 50 python <RUN_PY> us-income --stock_code NVDA --period 2024 --report_type Q4 python <RUN_PY> us-cashflow --stock_code AAPL --period 2024 --report_type Q4 python <RUN_PY> us-balance --stock_code NVDA --period 2024 --report_type Q4 python <RUN_PY> hk-income --trade_code 00700.HK --year 2024 --report_type annual python <RUN_PY> hk-income --trade_code 2388 --company_type bank python <RUN_PY> hk-cashflow --stock_code 00700.HK --year 2024 --report_type annual python <RUN_PY> hk-balance --trade_code 00700.HK --year 2024 --report_type annual python <RUN_PY> eastmoney-hk-index-daily-kline --index_code HSI --page 1 --page_size 5 python <RUN_PY> eastmoney-hk-index-daily-kline --index_code HSCEI --start_date 2026-06-01 --end_date 2026-06-15 python <RUN_PY> hsi-daily-weight --index_slug HSI --page 1 --page_size 200 python <RUN_PY> hsi-daily-weight --trade_date 20260529 --index_slug HSCEI python <RUN_PY> hsi-daily-weight --stock_code 0700 ``` > `run.py` 内部通过 `__file__` 自定位，无论安装在何处都能正确找到各子 skill 的脚本。 所有 `market.ft.tech` handler 默认使用内置基础地址。本地或内网服务可通过环境变量切换 API 地址： ```bash FTSHARE_BASE_URL=http://127.0.0.1:8000/ python <RUN_PY> 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` 映射代码再查。 - **`convertible-bond-candlesticks`**：查询单只可转债分/日/周/月/年 K 线（POST + JSON body，毫秒时间戳）。必填：`--symbol`、`--interval-unit`、`--until-ts-millis`；可选 `--interval-value`、`--adjust-kind`、`--since-ts-millis`、`--limit`。仅接受可转债标的。 - **`convertible-bond-candlesticks-batch`**：批量查询多只可转债 K 线，响应为 `[[symbol, K线数组], ...]`。必填：`--symbols`（逗号分隔）、`--interval-unit`、`--until-ts-millis`；其余参数同单只。任一非可转债标的整体返回系统错误。 - **`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` 映射代码再查。