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

核心功能与用法

FTShare-kline-data 是由非凸科技（FT）提供的专业 A 股行情数据技能集，通过 market.ft.tech 域名直接对接交易所行情源。本技能集包含两大核心能力：

1. 单只股票 OHLC K 线查询（`stock-ohlcs`）

支持查询日/周/月/年四种周期的 K 线数据，返回每个周期的开盘价（Open）、最高价（High）、最低价（Low）、收盘价（Close），以及成交量、成交额。此外，接口已预计算 MA5/MA10/MA20 三条常用均线，无需二次计算即可直接使用。

关键参数：

• --stock：股票代码（格式如 688295.XSHG、000001.SZ）
• --span：周期选择（DAY1/WEEK1/MONTH1/YEAR1）
• --limit：返回条数上限
• --until_ts_ms：截止时间戳（毫秒）

2. 单只股票分时价格查询（`stock-prices`）

提供一分钟级别的分时数据，适用于绘制分时图、分析日内走势。返回数据包含每分钟的价格、成交量、成交额、均价及时间戳，同时提供昨收价和当前交易日标识。

时间起点支持：

• TODAY：当日
• FIVE_DAYS_AGO：五日前
• TRADE_DAYS_AGO(n)：N 个交易日前

调用方式

通过 run.py 统一入口调用，支持绝对路径自定位：

python <RUN_PY> stock-ohlcs --stock 688295.XSHG --span DAY1 --limit 50
python <RUN_PY> stock-prices --stock 000001.XSHG --since TODAY

显著优点

1. 数据权威性高：直接对接非凸科技行情服务（market.ft.tech），数据源贴近交易所，延迟低、准确度高
2. 预计算指标：MA5/MA10/MA20 均线已在服务端完成计算，减少客户端开发成本
3. 多周期覆盖：从日线到年线，满足短线交易、中长期分析等多场景需求
4. 分钟级精度：分时数据达一分钟粒度，适合高频盯盘与量化回测
5. 灵活时间控制：支持相对时间（TODAY、FIVE_DAYS_AGO）和绝对时间戳，便于历史回溯

潜在缺点与局限性

1. 市场范围受限：仅覆盖 A 股市场，不支持港股、美股等其他市场
2. 代码格式要求：股票代码需使用特定后缀（.XSHG/.XSHE/.SZ 等），用户输入常需转换
3. 实时性依赖：行情数据依赖非凸科技服务端，极端行情下可能存在延迟
4. 无复权处理：未明确说明是否提供前复权/后复权数据，长期分析需注意除权除息影响
5. 单次查询限制：--limit 参数暗示存在单次返回上限，大量历史数据需分批获取

适合人群

• 量化交易者：需要标准化 OHLC 数据和预计算均线
• 技术分析爱好者：依赖 K 线形态、均线系统的个人投资者
• 金融开发者：构建行情展示、策略回测系统的工程师
• 日内交易员：需要分钟级分时数据进行短线决策

常规风险提示

• 数据时效性：行情数据非实时推送，分钟级延迟可能影响高频交易决策
• 合规使用：金融数据受监管约束，需确保使用场景符合相关法规
• 服务稳定性：依赖第三方服务商（非凸科技）的可用性，建议设计降级方案
• 代码格式错误：股票代码后缀错误会导致查询失败，需做好输入校验

核心用法

FTShare-kline-data 是非凸科技官方提供的 A 股金融数据查询技能集，通过标准化 Python 接口对接 market.ft.tech 官方数据源。该技能采用统一路由入口设计，主入口 run.py 根据用户指令自动分发至两个子技能：

• `stock-ohlcs`：查询单只股票 K 线数据，支持日线（DAY1）、周线（WEEK1）、月线（MONTH1）、年线（YEAR1）四种周期，返回开盘价、最高价、最低价、收盘价（OHLC）、成交量、成交额及 MA5/MA10/MA20 三条均线数据。
• `stock-prices`：查询一分钟级分时价格数据，支持当日（TODAY）、五日（FIVE_DAYS_AGO）或自定义交易日起点，返回每分钟价格、成交量、成交额、均价及时间戳，适用于分时图绘制与日内走势分析。

调用时通过替换文件路径获取 run.py 绝对路径，执行 python <RUN_PY> <子技能名> [参数...] 即可获取结构化 JSON 数据，支持 --limit、--until_ts_ms、--since_ts_ms 等灵活参数控制数据范围。

显著优点

1. 数据源权威可靠：直接对接非凸科技官方金融数据平台，T2 级可信来源，数据质量与实时性有保障。
2. 多周期覆盖完善：从分钟级分时到年线长周期，满足短线交易、波段操作、长线投资等多场景需求。
3. 技术指标内置：自动计算 MA5/MA10/MA20 均线，省去用户二次计算成本，即取即用。
4. 零依赖轻量部署：仅使用 Python 标准库，无第三方包依赖，部署简单、启动迅速、供应链风险为零。
5. 安全传输保障：全链路 HTTPS 加密，符合金融数据传输安全规范。

潜在缺点与局限性

1. 市场覆盖单一：仅支持 A 股市场（沪深交易所），不涉及港股、美股或其他国际市场。
2. 数据深度有限：未提供 Level-2 逐笔成交、委托队列等深度行情，仅包含基础 K 线与分时聚合数据。
3. 非实时推送：采用请求-响应模式，非 WebSocket 实时流式推送，高频场景下存在请求延迟。
4. 无历史财务数据：不包含市盈率、财报数据、资金流向等基本面指标，纯技术面数据工具。
5. 无回测框架：仅提供原始数据获取，不包含策略回测、交易信号生成等量化投研功能。

适合的目标群体

• 量化投资者与研究员：需要程序化获取标准化 K 线数据进行策略开发、因子挖掘。
• 个人股票交易者：希望快速查询特定股票的历史走势、均线状态，辅助买卖决策。
• 金融科技开发者：构建股票分析类应用、可视化图表、投研工具时需要可靠数据源。
• 教育培训机构：用于金融数据分析课程教学、技术指标演示等场景。

使用风险

1. API 稳定性依赖：数据获取完全依赖非凸科技 market.ft.tech 服务可用性，若上游服务变更或维护，可能影响数据获取。
2. 无 SLA 保障：作为技能工具，未明确承诺数据延迟上限或服务可用性等级，生产环境关键业务需谨慎评估。
3. 合规使用边界：金融数据受监管约束，用户需确保使用场景符合个人信息保护法、数据安全法及证券期货相关法律法规，不得用于非法荐股、操纵市场等行为。
4. 计算资源消耗：大量历史数据查询可能产生较大网络 IO 与内存占用，建议在参数中合理设置 --limit 限制返回条数。