核心功能
FTShare-market-data 是非凸科技(FT)官方推出的金融数据技能集,通过统一路由入口 run.py 调用 60+ 个子技能,覆盖中国A股、港股、ETF、基金、指数、宏观经济及公告研报等全维度金融数据。所有接口基于 https://market.ft.tech 官方域名,采用 HTTP GET 协议,请求头自动携带 X-Client-Name: ft-claw 认证标识。
主要数据类别
| 类别 | 覆盖内容 | 代表子技能 |
|:---|:---|:---|
| **A股基础数据** | 全市场股票列表、实时行情、IPO、大宗交易、融资融券 | `stock-list-all-stocks`, `stock-quotes-list`, `stock-ipos`, `block-trades`, `margin-trading-details` |
| **A股K线与分时** | 日线/周线/月线/年线 OHLC、MA均线、分钟级分时 | `stock-ohlcs`, `stock-prices` |
| **单股深度** | 实时估值指标(PE/PB/PS)、换手率、市值 | `stock-security-info` |
| **港股数据** | 公司介绍、估值分析、K线(日/月/季/年) | `company-hk`, `hk-valuatnanalyd`, `hk-candlesticks` |
| **ETF数据** | PCF申购赎回清单、成份股、盘前数据、K线、分时 | `etf-pcfs`, `etf-component`, `etf-detail`, `etf-ohlcs` |
| **基金数据** | 基本信息、净值历史、累计收益率、全市场概览 | `fund-basicinfo-single-fund`, `fund-nav-single-fund-paginated` |
| **指数数据** | 指数描述PDF下载、权重明细/下载、K线、分时 | `index-description-paginated`, `index-weight-list`, `index-ohlcs` |
| **公告研报** | 全市场/单股公告与研报列表、PDF下载 | `stock-announcements-all-stocks-specific-date`, `stock-reports-specific-url-hash` |
| **股东数据** | 十大股东/流通股东、股东人数、股权质押、增减持 | `stock-holder-ten`, `pledge-detail`, `stock-share-chg` |
| **财务业绩** | 业绩快报/预告、现金流量表、利润表、资产负债表 | `stock-performance-express-all-stocks-specific-period`, `stock-cashflow-single-stock-all-periods` |
| **宏观经济** | 中国15项指标(GDP/CPI/PPI/LPR/M2等)+ 美国16项指标 | `economic-china-gdp-quarterly`, `economic-us-economic-by-type` |
| **工具接口** | 交易日计算(前N个交易日) | `get-nth-trade-date` |
调用方式
统一通过 python <RUN_PY> <子skill名> [参数...] 执行,支持分页查询(--page, --page_size)、全量拉取(--all)、时间范围筛选等标准参数。输出为标准 JSON,可直接解析为表格或图表数据。
显著优点
- 官方权威数据源:直接对接交易所及金融信息商,数据延迟低、准确性高
- 覆盖度极广:从微观个股K线到宏观国家级经济指标,形成完整投研数据闭环
- 标准化接口设计:统一的路由入口、参数命名规范、分页机制,降低接入成本
- 专业场景深度支持:ETF PCF清单下载、指数权重Excel导出、股权质押明细等 institutional-grade 功能
- 多资产类别:A股、港股、ETF、基金、可转债、指数一站式覆盖
局限性与注意事项
- 数据时效限制:新闻语义搜索仅支持当年最近半个月数据;部分接口返回前一交易日数据(如可转债列表)
- 代码格式要求严格:港股、指数等需带交易所后缀(
.HK/.XSHG),纯名称需先映射 - 依赖外部域名:核心服务依赖
market.ft.tech和ftai.chat,需网络可达 - 分页限制:部分接口单页最大100条,全量数据需循环拉取
- 盘前时段敏感:ETF盘前数据接口在非盘前时段可能失败
适合人群
- 量化研究员/策略开发者:需要程序化获取清洗后的标准化行情与财务数据
- 专业投资者/基金经理:进行组合监控、指数成份调整跟踪、宏观择时分析
- 财经媒体/数据分析师:快速生成市场数据报告、可视化图表
- 金融科技开发者:集成金融数据能力至自研系统或智能助手
常规风险提示
- 金融数据仅供参考,不构成投资建议
- 历史数据不代表未来表现,投资需谨慎
- 股权质押、增减持等数据存在公告滞后性,实时性有限
- 宏观经济数据发布存在官方统计周期延迟