核心用法
equal-data-skill 是基于 PyPI 包 equal-data 封装的金融数据服务 Skill,提供标准化 API 方式统一数据资产对外服务。用户需安装 equal-data>=0.0.6 并配置 EQUAL_DATA_API_KEY 环境变量,通过 EqualDataApi 类调用 48 个专业金融数据接口,涵盖:
- 股票行情:实时行情、历史日 K 线、行业/概念板块成分股
- 财务数据:主要财务指标、主营业务、基本财务指标
- 特色数据:高管增减持、龙虎榜、游资分析、限售解禁、大宗交易、业绩预告、机构调研等
- 资讯信息:快讯、新闻、公告
- 基础数据:上市公司信息、管理层、十大股东、股东人数、交易日历等
接口采用分页设计,支持多条件筛选与排序,返回 JSON 格式数据,便于与 pandas 等分析工具集成。
显著优点
1. 数据维度全面:覆盖 6 大类 48 个接口,从基础行情到深度特色数据(游资胜率、龙虎榜营业部关联、增减持计划等),满足投研分析需求
2. 标准化接口设计:统一 query_equal_data 方法,通过 interfaceId 切换不同数据类型,降低学习成本
3. 专业金融场景聚焦:针对 A 股市场特性设计,包含打板专题数据(游资特色指标、营业部操作明细)、高管增减持计划详情等差异化数据
4. 灵活的认证方式:支持环境变量与 OpenClaw 配置文件双模式配置 API Key
5. 官方 PyPI 分发:依赖包通过 PyPI 官方渠道分发,版本管理规范
潜在缺点与局限性
1. API Key 门槛:需注册 equal-data 官网获取密钥,存在准入成本
2. 数据覆盖范围:仅限 A 股市场,不支持港股、美股等其他市场
3. 实时性未明确:文档未说明数据延迟情况,高频交易场景需谨慎验证
4. 商业化服务:免费额度与付费策略未透明披露,长期使用成本不明
5. 生态依赖:绑定特定供应商 equal-data,数据连续性受第三方服务稳定性影响
适合人群
- 量化研究员与个人投资者:需要程序化获取 A 股多维数据进行策略回测
- 财经自媒体与分析师:快速提取龙虎榜、高管增减持等热点数据
- 金融科技开发者:构建投研工具、监控预警系统
- 对游资行为、机构动向有深度分析需求的短线交易者
常规风险
- API Key 泄露风险:环境变量或配置文件中的密钥需妥善保管
- 数据准确性依赖:作为第三方数据聚合服务,关键投资决策建议交叉验证
- 服务可用性风险:依赖 equal-data 官方服务,存在接口变更或中断可能
- 合规使用边界:明确声明"仅用于获取行情数据,不涉及交易操作",用户需自行确保符合监管要求