核心用法
FTShare-kline-data 是非凸科技提供的 A 股行情数据技能集,通过 run.py 统一入口调用两个子 skill:
- `stock-ohlcs`:获取单只股票 K 线数据(日/周/月/年周期),返回开高低收(OHLC)、成交量、成交额及 MA5/MA10/MA20 均线。必填参数
--stock(如688295.XSHG)、--span(DAY1/WEEK1/MONTH1/YEAR1),可选--limit限制返回条数、--until_ts_ms指定截止时间点。
- `stock-prices`:获取单只股票分钟级分时数据,适用于当日或多日分时图展示,返回每分钟价格、成交量、成交额、均价及时间戳,同时包含昨收价与当前交易日信息。必填参数
--stock,时间起点通过--since(TODAY/FIVE_DAYS_AGO/TRADE_DAYS_AGO(n))或--since_ts_ms指定。
调用方式统一为 python <RUN_PY> <子skill名> [参数...],其中 <RUN_PY> 由 SKILL.md 绝对路径替换为 run.py 得到。所有请求基于 https://market.ft.tech/app 域名,携带 X-Client-Name: ft-web 请求头。
显著优点
1. 数据粒度完整:覆盖从年线到分钟线的全周期数据,兼顾长期趋势分析与超短线交易需求。
2. 计算增值:自动附带 MA5/MA10/MA20 均线,减少用户二次计算成本。
3. 标准化接口:统一 run.py 入口设计,降低多技能管理复杂度。
4. 灵活时间表达:支持自然语义(TODAY、FIVE_DAYS_AGO)与精确时间戳两种模式,适配不同场景。
潜在缺点与局限性
1. 数据源单一:仅覆盖 A 股市场,不涉及港股、美股或其他衍生品。
2. 无实时推送:基于请求-响应模式,非 WebSocket 流式推送,高频场景需轮询。
3. 时间戳精度:部分参数要求毫秒级时间戳,与常规秒级 Unix 时间戳习惯存在转换成本。
4. 依赖非凸服务:接口可用性与数据质量完全依赖非凸科技服务端稳定性。
适合人群
- 量化研究员与策略开发者,需要历史 K 线回测数据
- 个人投资者进行技术分析,关注均线与成交量指标
- 金融科技开发者构建行情展示、盯盘类应用
常规风险
- 数据延迟风险:分钟级数据可能存在秒级延迟,不适用于对延迟极度敏感的算法交易。
- 服务可用性风险:单一服务商依赖,建议生产环境配置降级方案。
- 合规使用风险:获取的行情数据应遵守相关金融数据使用协议,禁止未经授权的再分发。