核心用法
equal-data-skill 是基于 PyPI 包 equal-data 封装的金融数据服务工具,通过标准化 API 提供 A 股全维度数据查询能力。用户需先注册获取 EQUAL_DATA_API_KEY,支持环境变量或 OpenClaw 配置文件两种方式配置认证信息。
该 Skill 采用 Python SDK 调用模式,核心方法为 api.query_equal_data(interfaceId, **params),通过 48 个细分接口覆盖六大类数据场景:
- 究竟特色数据(22个接口):龙虎榜胜率排行、游资/营业部榜单、市场高度、高管增减持、限售解禁、大宗交易、业绩预告、机构调研等
- 股票基础数据(14个接口):上市公司信息、十大股东、股东人数、行业/概念板块成分股、ST股票、交易日历等
- 财务数据(2个接口):主要财务指标、主营业务数据
- 资讯信息(3个接口):快讯、财经新闻、上市公司公告
- 股票行情数据(2个接口):实时行情、历史日K数据
- 打板专题数据(5个接口):游资关联席位、操作明细、特色指标分析
参数设计遵循统一规范,支持股票代码/名称多选、日期范围、分页排序、自选筛选等灵活组合。
显著优点
1. 数据维度丰富:48个专业接口覆盖市场少有的特色数据,如游资胜率排行、营业部操作明细、限售解禁历史涨跌概率等,填补了主流金融 API 的空白
2. 实时性与轻量性:相比传统金融终端,提供更简洁的轻量调用方式,适合程序化获取
3. 参数标准化:统一的分页、排序、筛选参数设计,降低多接口学习成本
4. 合规定位明确:仅用于行情数据获取,不涉及交易操作,风险边界清晰
潜在缺点与局限性
1. 商业化服务依赖:需注册官网获取 API Key,存在服务稳定性、费率政策、数据授权范围等商业不确定性
2. Python 环境限定:必须依赖 Python 3.6+ 运行环境,非 Python 技术栈用户接入成本较高
3. 文档完整性待验证:部分高阶接口(如"限售解禁数据分析接口")的功能描述较为简略,实际数据质量需实测确认
4. 无回测框架集成:仅提供原始数据查询,未内置量化回测或策略分析工具链
5. 触发词泛化风险:关键词覆盖极广(如"涨跌概率""暴雷"等),存在误触发可能
适合人群
- 量化研究者:需要特色市场数据(游资动向、龙虎榜胜率)进行因子挖掘
- 个人投资者:关注高管增减持、限售解禁、机构调研等事件驱动型机会
- 金融科技开发者:构建投研工具、监控预警系统时调用标准化数据接口
- 财经内容生产者:快速获取结构化数据支持研报、资讯内容生成
常规风险
- API Key 泄露风险:环境变量或配置文件存储密钥,需遵循最小权限原则
- 数据延迟风险:实时行情与交易所实际数据可能存在秒级延迟,高频交易场景不适用
- 服务中断风险:依赖第三方商业服务,存在接口变更、限流、停服等运营风险
- 合规使用边界:虽声明不涉及交易,但用户需自行确保数据用途符合监管要求,禁止用于非法荐股、操纵市场等行为