Skills of A-share market data released by ft.tech.

核心功能

FTShare-market-data 是一套由非凸科技（FT）提供的专业金融数据技能集，通过统一路由入口 run.py 调度 60+ 个子技能，覆盖中国A股市场与港股市场的多维度数据需求。

数据覆盖范围

| 类别 | 具体能力 |

|------|---------|

| **股票行情** | A股全市场列表、实时行情、历史K线（日/周/月/年）、分时数据、估值指标（PE/PB/PS） |

| **指数数据** | 指数列表、指数详情、K线、分时、成份权重查询与下载（Excel）、指数描述PDF下载 |

| **ETF数据** | ETF列表、详情、K线、分时、PCF申购赎回清单、成份股查询 |

| **基金数据** | 基金基础信息、净值历史、累计收益率、全市场基金概览 |

| **可转债** | 全量转债列表、单只转债基础信息（转股价、转股价值、到期日） |

| **港股数据** | 公司介绍、估值分析、基础视图、K线数据（日/月/季/年） |

| **公告研报** | A股公告与研报的列表查询、PDF下载 |

| **股东数据** | 十大股东/流通股东、股东人数、股权质押（总览+个股）、股东增减持 |

| **财务业绩** | 业绩快报、业绩预告、现金流量表、利润表、资产负债表（单股历期+全市场单期） |

| **宏观数据** | 中国15项指标（GDP、CPI、PPI、PMI、LPR、M0/M1/M2等）、美国16项指标（非农、CPI、ISM、利率等） |

| **其他工具** | 交易日计算、语义搜索新闻、大宗交易、融资融券、东财概念板块 |

调用方式

所有接口通过 python <RUN_PY> <子skill名> [参数...] 统一调用，返回标准JSON格式。支持分页查询、自动翻页（--all）、多字段排序、时间范围过滤等高级功能。

显著优点

• 数据源权威：直接对接非凸科技金融数据平台，机构级数据质量
• 覆盖全面：从行情数据到深度财务、从宏观到个股、从A股到港股
• 开发友好：统一入口设计，子技能职责单一，参数语义清晰
• 性能优化：支持分页、限流、缓存友好的调用模式

潜在局限

• 访问限制：部分接口需特定请求头（如 X-Client-Name: ft-claw）
• 数据时效：新闻语义搜索仅支持当年最近半个月数据
• 代码格式：不同接口对股票/指数代码格式要求不同（如 .SH/.SZ/.XSHG/.XSHE），需先完成名称到代码的映射
• 依赖环境：需要Python运行环境及网络访问 market.ft.tech 和 ftai.chat

适合人群

• 量化研究员与策略开发者
• 金融数据分析师
• 投资顾问与财富管理从业者
• 需要程序化获取A股/港股数据的开发者

常规风险

• 数据使用合规：金融数据受监管约束，需确保使用场景符合数据授权协议
• API稳定性：依赖外部服务端可用性，生产环境建议实现容错与重试机制
• 时间戳处理：K线等接口涉及毫秒级时间戳与东八区转换，需注意时区处理
• 代码映射风险：用户输入的中文名称可能存在歧义（如"沪深300"对应多个ETF），需确认唯一性后再查询

核心用法

FTShare-market-data 是一套由非凸科技提供的综合金融数据技能集，采用统一路由入口设计，通过 run.py 调度 76 个子技能模块，覆盖中国A股与香港股市的完整数据生态。

数据覆盖范围：

• 市场数据：A股股票列表、实时行情、K线（日/周/月/年）、分时价格、IPO信息、大宗交易、融资融券
• 衍生品与基金：可转债详情、ETF PCF申赎清单/成份股/盘前数据、基金基础信息/净值/收益曲线
• 指数体系：指数列表、详情、K线、权重明细（支持Excel下载）、指数描述PDF下载
• 公告与研报：全市场/个股公告列表及PDF下载、研报列表及PDF下载
• 股东数据：十大股东/流通股东、股东人数、股权质押总揽与个股详情、股东增减持记录
• 财务数据：业绩快报/预告、现金流量表、利润表、资产负债表（支持单股全周期或全市场单期查询）
• 宏观经济：中国15项核心指标（GDP、CPI、PPI、PMI、LPR、M2等）、美国16项关键指标（非农就业、CPI、美联储利率等）
• 港股数据：公司介绍、估值分析、基础视图、K线数据

调用模式：统一通过 python <RUN_PY> <子skill名> [参数...] 执行，支持分页查询、自动翻页拉取（--all）、文件下载等模式。所有接口基于HTTPS，请求头固定携带 X-Client-Name: ft-claw。

显著优点

1. 数据维度全面：单一入口覆盖从底层行情到宏观经济的完整数据链条，无需对接多个数据源
2. 专业金融场景深度适配：支持ETF PCF申赎清单下载、指数权重Excel导出、公告/研报PDF直链下载等机构投资者刚需功能
3. 查询灵活性高：支持语义搜索新闻、按板块筛选股票、多字段排序、日期范围过滤、自动翻页等高级查询能力
4. 代码标准化：统一使用带交易所后缀的标准代码格式（如600519.SH、00700.HK），并通过 index-description-all 等接口提供名称-代码映射能力
5. 无第三方依赖：仅使用Python标准库，部署轻量，供应链安全风险极低

潜在缺点与局限性

1. 新闻数据时效受限：语义搜索新闻仅支持当年最近半个月数据，不适合历史新闻回溯
2. 港股数据深度有限：相比A股的完整财务数据链，港股仅覆盖行情与基础公司信息，缺乏完整财报数据接口
3. 实时性依赖数据源：行情数据为盘后或准实时，非交易所Level-2毫秒级行情，高频交易场景不适用
4. 文件下载需前置查询：PDF/Excel下载需先通过列表接口获取 url_hash，无法直接通过代码或名称下载
5. 无回测与策略框架：纯数据查询技能，不包含量化策略回测、组合分析等上层功能

适合的目标群体

• 量化研究员与个人投资者：需要程序化获取A股/港股结构化数据进行策略研究
• 财经内容创作者：快速获取公告、研报、新闻素材及宏观经济数据
• 企业财务与战略部门：跟踪行业指数、宏观经济指标进行经营分析
• 金融科技开发者：作为数据源层集成至自有的投研系统或App
• 高校金融专业师生：获取标准化市场数据进行学术研究

使用风险

1. 网络稳定性风险：76个子技能均依赖 market.ft.tech 和 ftai.chat 域名，网络波动或API限流可能导致请求失败，建议实现本地缓存和重试机制
2. 数据合规边界：金融数据使用需遵守《证券法》及交易所数据使用规范，商用场景需确认非凸科技的数据授权范围
3. 动态代码执行：run.py 使用 runpy.run_path 动态加载子技能，虽有白名单限制，但子技能文件被篡改将直接生效，需保障部署环境文件完整性
4. 参数格式敏感：股票代码需严格遵循带后缀格式（.SH/.SZ/.XSHG/.XSHE），名称到代码的映射需额外调用接口，自动化流程中需预处理
5. 无服务等级承诺：作为数据查询工具，不包含数据准确性 SLA，关键投资决策建议与官方交易所数据交叉验证