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

核心功能

FTShare-market-data 是由非凸科技（FT）提供的专业金融数据技能集，通过统一的 run.py 路由入口，提供覆盖中国A股、港股、ETF、基金、指数及宏观经济的全方位数据服务。核心能力包括：

股票数据（A股）

• 全市场覆盖：沪深京三市股票列表、实时行情、IPO信息、大宗交易、融资融券明细
• 单票深度：实时行情与估值指标（PE/PB/PS）、开高低收、多周期涨跌幅
• K线与分时：日线/周线/月线/年线OHLC数据，附带MA5/MA10/MA20均线；分钟级分时走势

公告与研报

• 全市场/单只股票的历史公告与研报列表，支持PDF下载
• 业绩快报、业绩预告、现金流量表、利润表、资产负债表等财务数据

股东数据

• 十大股东/流通股东明细、股东人数变化趋势
• 股权质押总揽与个股详情、股东增减持记录

ETF与基金

• ETF详情、PCF申购赎回清单、成份股列表、盘前数据
• 基金基础信息、累计收益率曲线、净值历史

指数数据

• 指数描述PDF下载、权重明细查询与Excel下载
• 指数K线、分时、详情查询

港股数据

• 公司介绍、估值分析（PE/PB/PS）、基础视图、K线数据

宏观经济

• 中国：GDP、CPI、PPI、PMI、LPR、M0/M1/M2、社零、固投、进出口等15项指标
• 美国：ISM制造业/非制造业、非农就业、CPI/PPI、失业率、GDP、联储利率等16项指标

显著优点

1. 机构级数据源：非凸科技为专业量化投资机构，数据质量与实时性有保障
2. 统一入口设计：所有子技能通过单一 run.py 调度，降低集成复杂度
3. 标准化输出：JSON格式统一，便于程序化解析与二次开发
4. 多周期支持：K线覆盖日/周/月/年多周期，分时支持当日及多日回溯
5. 文件下载能力：支持PCF XML、指数描述PDF、权重Excel等文件型数据获取
6. 语义搜索：新闻数据支持语义检索，超越简单关键词匹配

潜在局限

1. 访问限制：部分接口需携带 X-Client-Name: ft-claw 请求头，存在认证要求
2. 数据时效性：新闻数据仅支持当年最近半个月，历史回溯受限
3. 代码依赖：用户常使用中文名称查询，需先完成名称→代码映射（如"沪深300"→"000300.XSHG"）
4. 时间戳转换：近N天K线查询需先调 get-nth-trade-date 再转毫秒时间戳，流程较繁琐
5. 分页限制：部分接口默认/最大页大小为100，全量数据需多次翻页
6. 港股代码格式：港股代码需带 .HK 后缀，与A股格式不统一

适合人群

• 量化投资者/机构：需要程序化获取实时行情、财务数据、指数权重
• 基本面分析师：查阅公告、研报、业绩快报、股东变动等深度信息
• ETF交易员：PCF清单、成份股、申购赎回单位等ETF专属数据
• 宏观研究员：中美宏观经济指标追踪与对比分析
• 金融科技开发者：构建基于真实市场数据的应用或投研工具

常规风险提示

• 金融数据具有时效性，历史数据不代表未来表现
• 自动交易决策需结合风控策略，不建议单一依赖数据接口
• 指数权重、ETF PCF等数据存在更新延迟，需确认数据日期
• 股权质押、股东增减持等数据以公告为准，可能存在滞后披露

核心用法

FTShare-market-data 是非凸科技官方推出的综合金融数据查询技能集，采用统一的 Python 脚本路由入口设计。用户通过自然语言描述需求，系统自动匹配 50+ 个子技能，覆盖 A 股、港股、ETF、基金、指数、宏观经济等多维度金融数据。核心调用模式为 python <RUN_PY> <子skill名> [参数...]，所有接口基于 HTTPS 加密通信，返回结构化 JSON 数据。

主要数据类别包括：

• 市场行情：A 股全量列表、实时行情、K 线数据（日/周/月/年）、分时价格
• 财务与业绩：资产负债表、利润表、现金流量表、业绩快报/预告
• 股东与交易：十大股东/流通股东、股东人数、股权质押、融资融券、大宗交易
• 公告与研报：全市场公告/研报列表、单条 PDF 下载
• 基金与 ETF：基金基本信息、净值历史、收益率曲线、ETF 成份股、PCF 申购赎回清单
• 指数数据：指数详情、K 线、权重明细、描述文件下载
• 宏观经济：中国 GDP/CPI/PPI/PMI/LPR/M2 等 15 项指标，美国 ISM/非农/CPI/美联储利率等 16 类数据

显著优点

1. 数据权威性高：直接对接非凸科技官方金融数据平台（market.ft.tech / ftai.chat），数据源经过专业机构清洗校验，覆盖沪深京三市及港股全市场。

2. 功能覆盖全面：单一技能集整合 50+ 个子接口，从基础行情到深度财务、从微观个股到宏观指标，满足投研分析全链路需求。

3. 安全架构严谨：仅依赖 Python 标准库，无第三方包引入供应链风险；HTTPS 强制加密 + URL 白名单验证，有效防御 SSRF 攻击；无敏感信息硬编码，通过企业级安全检测。

4. 使用门槛极低：自然语言意图识别 + 自动化参数映射，用户无需记忆复杂 API 文档；支持名称到代码的智能转换（如"贵州茅台"→"600519.SH"）。

5. 企业级稳定性：接口设计遵循金融行业标准，支持分页查询、自动翻页、错误原样输出等容错机制，适合生产环境自动化调用。

潜在缺点与局限性

1. 地域覆盖有限：当前仅支持 A 股（沪深京）和港股，不包含美股、期货、外汇、加密货币等其他市场。

2. 实时性约束：部分数据存在 T+1 延迟（如财务报告、股东数据），非完全实时行情；新闻语义搜索仅支持最近半个月数据。

3. 调用链路复杂：多步骤查询场景（如"下载指数权重 Excel"）需先查列表取 url_hash，再调下载接口，对纯新手有一定学习成本。

4. 无可视化输出：返回原始 JSON 数据，需用户或上层应用自行处理图表渲染（如 K 线图的蜡烛图绘制）。

5. 权限与速率限制：文档未明确披露 API 调用频率限制，高频量化交易场景需额外确认服务等级协议。

适合的目标群体

• 个人投资者：需要快速查询个股行情、财务指标、股东变动等信息进行基本面分析
• 量化研究员：需要程序化获取结构化金融数据进行策略回测与因子挖掘
• 财经自媒体/分析师：需要权威数据源支撑内容创作，快速生成数据图表素材
• 金融科技开发者：需要在应用内集成合规、安全的金融数据查询能力
• 高校金融专业师生：需要真实市场数据进行教学案例分析与学术研究

使用风险与注意事项

1. 数据时效性风险：金融数据具有强时效性，历史数据不代表未来表现，技能明确提示"数据仅供参考，不构成投资建议"。

2. 网络依赖风险：所有数据均需联网获取，离线环境无法使用；建议关注非凸科技服务状态，避免交易时段接口异常。

3. 参数格式风险：股票代码需严格遵循带后缀格式（如 600519.SH），纯数字代码可能因跨市场重复导致查询错误。

4. 文件写入风险：部分接口（如 PDF/Excel 下载）涉及本地文件系统操作，虽已限制为当前工作目录，但仍建议在隔离环境执行。

5. 合规使用风险：获取的数据仅限个人研究使用，禁止用于非法证券活动、操纵市场或未经授权的商业再分发。