Equal Data - China A Share Stock Data Service Skill

SKILL.md

---
name: equal-data-skill
description: equal-data-skill 金融数据服务- 提供覆盖A股5000+家上市公司的行情、财报、基本面、重大事件追踪(高管增减持, 重大合同, 股东变动,大宗交易, 限售解禁,定向增发,分红送转, 业绩预告)等多维度数据、股东分析、基金持仓与变动统计、知名机构动向追踪(包含 国家队,外资,私募基金,公募基金,信托,保险,证券等)、知名牛散持仓数据、资讯、公告、等多形态结构化专业金融数据
author: equaldata
pypi_package: equal-data
install_required: true
install_command: pip install 'equal-data==0.0.12'
required_env_vars:
  - EQUAL_DATA_API_KEY
---

# equal-data-skill

## 概述

### Equal Data skills的核心能力：

### 股票全景信息

为OpenClaw、Workbuddy、QClaw等主流龙虾提供及时全面的行情数据、财务数据、主营业务、高管背景、股东信息、事件驱动以及每日的市场热度相关的全维度数据

### 聪明资金流向（特色数据）

为OpenClaw、Workbuddy、QClaw等主流龙虾提供实时监控 公募、私募、国家队、外资、保险、信托、牛散、游资等主流聪明资金的持仓动向, 成本分析解读等特色数据

### 智能量化选股

为OpenClaw、Workbuddy、QClaw等主流龙虾提供通过行情数据、财务指标、估值指标、盈利能力、事件驱动等多维度的基本面选股能力

### 资讯公告检索

为OpenClaw、Workbuddy、QClaw等主流龙虾提供及时、全面、权威的金融资讯检索能力， 并提供上千家深度专栏文章、机构研报、AI公告数据的搜索

## 快速上手

- 安装python运行环境(推荐python3.6+)，并安装equal-data依赖包。

```bash
python -m venv test_env
source test_env/bin/activate
pip install equal-data==0.0.12
```

**重要提示**：为确保功能正常运行，需要确保 equal_data 版本大于等于 0.0.12

版本检查：

```python
from equal_data import __version__
print(f"当前 equal_data 版本: {__version__}")
```

版本升级：

如果版本过低，请升级到最新版本：

```bash
pip install equal-data==0.0.12
```

- 根据接口文档，使用python代码获取数据。（如**高管增减持金额排行榜**接口）

```python
from equal_data import EqualDataApi 
import os

# 读取环境变量中的API_KEY, 或者读取本地记录的API_KEY
API_KEY = os.getenv('EQUAL_DATA_API_KEY')

api = EqualDataApi(API_KEY)

# 高管持股变动-增减持金额排行榜列表
data = api.query_equal_data(
    interfaceId="B6",
    period=None,  # int  # 默认: 1
    changeType=None,  # int  # 默认:
    pageIndex=None,  # int  # 默认: 0
    pageSize=None,  # int  # 默认: 10
    selfSelected=None,  # bool  # 默认: false
    sortDesc=None,  # str  # 默认: 1-DESC
)
```

## 参数格式说明

| 名称           | 类型      | 必填 | 默认值   | 说明                                                         |
| :------------- | :-------- | :--- | :------- | :----------------------------------------------------------- |
| `interfaceId`  | `str`  | 是   | `B6`     | 接口ID                                                       |
| `period`       | `int` | 否   | `1`      | 1-近1月、2-近3月、3-近半年、4-近1年                          |
| `changeType`   | `int` | 否   | -        | 变动类型（增持：1，减持：-1）                                |
| `pageIndex`    | `int` | 是   | `0`      | 当前页从0开始                                                |
| `pageSize`     | `int` | 是   | `10`     | 每页显示记录数                                               |
| `selfSelected` | `bool` | 否   | `false`  | true: 只看自选 false：全部（默认）                           |
| `sortDesc`     | `str`  | 否   | `1-DESC` | 排序描述 1-ASC/1-DESC 等，1表示增持金额 2增持数量 3占总股本比 4占流通股本比 <br>5净增持股数 6增持均价 |

- 返回格式：json

## 认证方式

本 Skill 需要equaldata  API_KEY (`EQUAL_DATA_API_KEY`)，支持以下两种方式配置：

equaldata官网(https://equal-data.com/)注册，获取API_KEY，

**方式 A：配置环境变量**

```bash
# macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc
export EQUAL_DATA_API_KEY="your_key_here"
# Windows PowerShell
$env:EQUAL_DATA_API_KEY="your_key_here"
# Windows CMD
set EQUAL_DATA_API_KEY=your_key_here
```
然后根据系统执行对应的命令：
**macOS：**

```bash
source ~/.zshrc
```

**Linux：**

```bash
source ~/.bashrc
```

**方式 B：OpenClaw配置文件:**
在 `~/.openclaw/openclaw.json` 中配置：

```json
{
  "skills": {
    "entries": {
      "equal-data-skill": {
        "enabled": true,
        "env": {
          "EQUAL_DATA_API_KEY": "your_actual_API_KEY_here"
        }
      }
    }
  }
}
```

## 触发指令

【A股】【股票】【行情】【K线】【股价】【涨跌幅】【成交量】【市值】
【基金】【净值】【收益率】【持仓】【基金经理】
【财报】【财务指标】【营收】【净利润】【毛利率】【资产负债】
【高管增减持】【董监高】【股东】【持股变动】【增持】【减持】
【机构动向】【机构持仓】【北向资金】【外资】【社保基金】
【龙虎榜】【游资】【营业部】【上榜】【打板】【连板】【市场高度】
【限售解禁】【解禁股】【减持计划】
【大宗交易】【折价】【溢价】
【重大合同】【涨跌概率】
【分红送转】
【机构调研】
【业绩预告】【预增】【预减】【暴雷】
【十大股东】【流通股东】【股东人数】【管理层】【高管】
【快讯】【新闻】【公告】【研报】【资讯】
【热门榜单】

## 数据接口列表

<!-- generated_at: 2026-04-30T10:44:56.144-1777517096145 -->


| 接口ID | 接口名称 | 分类 | 文档路径 |
|:---:|:---|:---|:---|
| K1 | 全部策略列表 | 特色策略 | [全部策略列表.md](<reference/特色策略/全部策略列表.md>) |
| K2 | 具体的策略详情 | 特色策略 | [具体的策略详情.md](<reference/特色策略/具体的策略详情.md>) |
| K3 | 策略持仓信息 | 特色策略 | [策略持仓信息.md](<reference/特色策略/策略持仓信息.md>) |
| K4 | 具体策略的走势详细数据 | 特色策略 | [具体策略的走势详细数据.md](<reference/特色策略/具体策略的走势详细数据.md>) |
| S1 | 估值模型选股 | 指标选股 | [估值模型选股.md](<reference/指标选股/估值模型选股.md>) |
| S3 | 事件驱动选股 | 指标选股 | [事件驱动选股.md](<reference/指标选股/事件驱动选股.md>) |
| S4 | 股东户数变动选股 | 指标选股 | [股东户数变动选股.md](<reference/指标选股/股东户数变动选股.md>) |
| S6 | 机构持仓选股 | 指标选股 | [机构持仓选股.md](<reference/指标选股/机构持仓选股.md>) |
| S11 | 财务指标综合选股 | 指标选股 | [财务指标综合选股.md](<reference/指标选股/财务指标综合选股.md>) |
| S12 | 实时基本面综合选股 | 指标选股 | [实时基本面综合选股.md](<reference/指标选股/实时基本面综合选股.md>) |
| S13 | 股价表现选股 | 指标选股 | [股价表现选股.md](<reference/指标选股/股价表现选股.md>) |
| B6 | 高管增减持金额排行榜 | 事件驱动 | [高管增减持金额排行榜.md](<reference/事件驱动/高管增减持金额排行榜.md>) |
| B7 | 查询所有高管增减持变动数据 | 事件驱动 | [查询所有高管增减持变动数据.md](<reference/事件驱动/查询所有高管增减持变动数据.md>) |
| B8 | 高管增减持计划数据 | 事件驱动 | [高管增减持计划数据.md](<reference/事件驱动/高管增减持计划数据.md>) |
| B9 | 高管单次增减持变动数据 | 事件驱动 | [高管单次增减持变动数据.md](<reference/事件驱动/高管单次增减持变动数据.md>) |
| B10 | 高管增减持计划详情 | 事件驱动 | [高管增减持计划详情.md](<reference/事件驱动/高管增减持计划详情.md>) |
| B11 | 高管持股数据分析 | 事件驱动 | [高管持股数据分析.md](<reference/事件驱动/高管持股数据分析.md>) |
| B12 | 热门榜单基础信息 | 事件驱动 | [热门榜单基础信息.md](<reference/事件驱动/热门榜单基础信息.md>) |
| B13 | 热门榜单详情数据 | 事件驱动 | [热门榜单详情数据.md](<reference/事件驱动/热门榜单详情数据.md>) |
| B14 | 限售解禁数据 | 事件驱动 | [限售解禁数据.md](<reference/事件驱动/限售解禁数据.md>) |
| B15 | 限售解禁详细数据 | 事件驱动 | [限售解禁详细数据.md](<reference/事件驱动/限售解禁详细数据.md>) |
| B16 | 限售解禁数据分析接口 | 事件驱动 | [限售解禁数据分析接口.md](<reference/事件驱动/限售解禁数据分析接口.md>) |
| B17 | 大宗交易营业部数据 | 事件驱动 | [大宗交易营业部数据.md](<reference/事件驱动/大宗交易营业部数据.md>) |
| B18 | 大宗交易股票数据 | 事件驱动 | [大宗交易股票数据.md](<reference/事件驱动/大宗交易股票数据.md>) |
| B19 | 业绩预告/预披露 | 事件驱动 | [业绩预告_预披露.md](<reference/事件驱动/业绩预告_预披露.md>) |
| B20 | 重大合同数据 | 事件驱动 | [重大合同数据.md](<reference/事件驱动/重大合同数据.md>) |
| B21 | 分红送转预案/实施 | 事件驱动 | [分红送转预案_实施.md](<reference/事件驱动/分红送转预案_实施.md>) |
| B22 | 机构调研数据 | 事件驱动 | [机构调研数据.md](<reference/事件驱动/机构调研数据.md>) |
| B23 | 热门榜单持仓榜数据 | 事件驱动 | [热门榜单持仓榜数据.md](<reference/事件驱动/热门榜单持仓榜数据.md>) |
| B24 | 跌破国家队持仓成本排行数据 | 事件驱动 | [跌破国家队持仓成本排行数据.md](<reference/事件驱动/跌破国家队持仓成本排行数据.md>) |
| H1 | 公募基金列表 | 公募基金 | [公募基金列表.md](<reference/公募基金/公募基金列表.md>) |
| H2 | 公募公司列表 | 公募基金 | [公募公司列表.md](<reference/公募基金/公募公司列表.md>) |
| H3 | 公募基金经理列表 | 公募基金 | [公募基金经理列表.md](<reference/公募基金/公募基金经理列表.md>) |
| H4 | 基金规模数据 | 公募基金 | [基金规模数据.md](<reference/公募基金/基金规模数据.md>) |
| H5 | 公募基金净值:获取公募基金净值数据 | 公募基金 | [公募基金净值_获取公募基金净值数据.md](<reference/公募基金/公募基金净值_获取公募基金净值数据.md>) |
| H6 | 公募基金持仓数据 | 公募基金 | [公募基金持仓数据.md](<reference/公募基金/公募基金持仓数据.md>) |
| L1 | 百强牛散榜单 | 牛散追击 | [百强牛散榜单.md](<reference/牛散追击/百强牛散榜单.md>) |
| L2 | 牛散历史交易轨迹 | 牛散追击 | [牛散历史交易轨迹.md](<reference/牛散追击/牛散历史交易轨迹.md>) |
| L3 | 牛散详情 | 牛散追击 | [牛散详情.md](<reference/牛散追击/牛散详情.md>) |
| L4 | 热门牛散最新操作数据 | 牛散追击 | [热门牛散最新操作数据.md](<reference/牛散追击/热门牛散最新操作数据.md>) |
| L5 | 牛散个股操作周期轨迹 | 牛散追击 | [牛散个股操作周期轨迹.md](<reference/牛散追击/牛散个股操作周期轨迹.md>) |
| D1 | 上市公司管理层信息 | 基础数据 | [上市公司管理层信息.md](<reference/基础数据/上市公司管理层信息.md>) |
| D2 | 十大股东/十大流通股东 | 基础数据 | [十大股东_十大流通股东.md](<reference/基础数据/十大股东_十大流通股东.md>) |
| D3 | 股东人数列表 | 基础数据 | [股东人数列表.md](<reference/基础数据/股东人数列表.md>) |
| D4 | 个股股东股本及机构持仓 | 基础数据 | [个股股东股本及机构持仓.md](<reference/基础数据/个股股东股本及机构持仓.md>) |
| D5 | 个股资料最新重要指标 | 基础数据 | [个股资料最新重要指标.md](<reference/基础数据/个股资料最新重要指标.md>) |
| F1 | 基本股票列表/公司信息 | 基础数据 | [基本股票列表_公司信息.md](<reference/基础数据/基本股票列表_公司信息.md>) |
| F2 | 交易日历列表 | 基础数据 | [交易日历列表.md](<reference/基础数据/交易日历列表.md>) |
| F3 | 股票更名列表 | 基础数据 | [股票更名列表.md](<reference/基础数据/股票更名列表.md>) |
| F4 | ST股票列表 | 基础数据 | [ST股票列表.md](<reference/基础数据/ST股票列表.md>) |
| F8 | 每日股本数据情况 | 基础数据 | [每日股本数据情况.md](<reference/基础数据/每日股本数据情况.md>) |
| A1 | 主要财务数据 | 财务数据 | [主要财务数据.md](<reference/财务数据/主要财务数据.md>) |
| A2 | 查询股票主营业务 | 财务数据 | [查询股票主营业务.md](<reference/财务数据/查询股票主营业务.md>) |
| F5 | 行业板块-成分股列表 | 行业与题材 | [行业板块-成分股列表.md](<reference/行业与题材/行业板块-成分股列表.md>) |
| F6 | 概念板块-成分股列表 | 行业与题材 | [概念板块-成分股列表.md](<reference/行业与题材/概念板块-成分股列表.md>) |
| F7 | 行业板块列表  | 行业与题材 | [行业板块列表.md](<reference/行业与题材/行业板块列表.md>) |
| F9 | 概念板块列表 | 行业与题材 | [概念板块列表.md](<reference/行业与题材/概念板块列表.md>) |
| I6 | 申万行业列表 | 行业与题材 | [申万行业列表.md](<reference/行业与题材/申万行业列表.md>) |
| I7 | 申万行业成分股列表 | 行业与题材 | [申万行业成分股列表.md](<reference/行业与题材/申万行业成分股列表.md>) |
| I8 | 申万行业日线行情 | 行业与题材 | [申万行业日线行情.md](<reference/行业与题材/申万行业日线行情.md>) |
| J1 | 机构动向全量数据 | 机构动向 | [机构动向全量数据.md](<reference/机构动向/机构动向全量数据.md>) |
| J2 | 机构持仓列表 | 机构动向 | [机构持仓列表.md](<reference/机构动向/机构持仓列表.md>) |
| J3 | 机构最新持股列表 | 机构动向 | [机构最新持股列表.md](<reference/机构动向/机构最新持股列表.md>) |
| I0 | 获取所有指数信息 | 指数专题 | [获取所有指数信息.md](<reference/指数专题/获取所有指数信息.md>) |
| I1 | 指数基本信息列表-根据交易倒序排序 | 指数专题 | [指数基本信息列表-根据交易倒序排序.md](<reference/指数专题/指数基本信息列表-根据交易倒序排序.md>) |
| I2 | 指数日线行情列表 | 指数专题 | [指数日线行情列表.md](<reference/指数专题/指数日线行情列表.md>) |
| I3 | 指数周线行情列表 | 指数专题 | [指数周线行情列表.md](<reference/指数专题/指数周线行情列表.md>) |
| I4 | 指数月线行情 | 指数专题 | [指数月线行情.md](<reference/指数专题/指数月线行情.md>) |
| I5 | 指数成分和权重列表 | 指数专题 | [指数成分和权重列表.md](<reference/指数专题/指数成分和权重列表.md>) |
| E1 | 快讯信息 | 资讯信息 | [快讯信息.md](<reference/资讯信息/快讯信息.md>) |
| E2 | 文章信息 | 资讯信息 | [文章信息.md](<reference/资讯信息/文章信息.md>) |
| E3 | 上市公司公告 | 资讯信息 | [上市公司公告.md](<reference/资讯信息/上市公司公告.md>) |
| G1 | 实时行情列表 | 行情数据 | [实时行情列表.md](<reference/行情数据/实时行情列表.md>) |
| G2 | 历史日K行情数据 | 行情数据 | [历史日K行情数据.md](<reference/行情数据/历史日K行情数据.md>) |
| C1 | 龙虎榜机构（营业部）-关联席位游资列表 | 龙虎榜 | [龙虎榜机构（营业部）-关联席位游资列表.md](<reference/龙虎榜/龙虎榜机构（营业部）-关联席位游资列表.md>) |
| C2 | 龙虎榜机构（营业部）-操作明细 | 龙虎榜 | [龙虎榜机构（营业部）-操作明细.md](<reference/龙虎榜/龙虎榜机构（营业部）-操作明细.md>) |
| C3 | 龙虎榜-游资特色指标分析 | 龙虎榜 | [龙虎榜-游资特色指标分析.md](<reference/龙虎榜/龙虎榜-游资特色指标分析.md>) |
| C4 | 游资基本信息 | 龙虎榜 | [游资基本信息.md](<reference/龙虎榜/游资基本信息.md>) |
| C5 | 游资每日操作明细 | 龙虎榜 | [游资每日操作明细.md](<reference/龙虎榜/游资每日操作明细.md>) |
| B1 | 龙虎榜-近1月胜率排行 | 龙虎榜 | [龙虎榜-近1月胜率排行.md](<reference/龙虎榜/龙虎榜-近1月胜率排行.md>) |
| B2 | 龙虎榜-个股榜 | 龙虎榜 | [龙虎榜-个股榜.md](<reference/龙虎榜/龙虎榜-个股榜.md>) |
| B3 | 龙虎榜-游资榜 | 龙虎榜 | [龙虎榜-游资榜.md](<reference/龙虎榜/龙虎榜-游资榜.md>) |
| B4 | 龙虎榜-营业部榜 | 龙虎榜 | [龙虎榜-营业部榜.md](<reference/龙虎榜/龙虎榜-营业部榜.md>) |
| B5 | 龙虎榜-市场高度 | 龙虎榜 | [龙虎榜-市场高度.md](<reference/龙虎榜/龙虎榜-市场高度.md>) |
| M1 | 最新协同数据 | 股东协同 | [最新协同数据.md](<reference/股东协同/最新协同数据.md>) |
| M2 | 公奔私协同 | 股东协同 | [公奔私协同.md](<reference/股东协同/公奔私协同.md>) |
| M3 | 一致预期（多股东协同） | 股东协同 | [一致预期（多股东协同）.md](<reference/股东协同/一致预期（多股东协同）.md>) |
| M4 | 搜索协同主体 | 股东协同 | [搜索协同主体.md](<reference/股东协同/搜索协同主体.md>) |

全部数据接口和接口功能描述，请参考 `reference/数据接口.md`。

### 场景调用接口 

详细的应用场景调用：

| 名称                       | 接口描述                                               | 文档路径                                                     |
| -------------------------- | ------------------------------------------------------ | ------------------------------------------------------------ |
| 个股详情分析     | 获取指定股票的详细分析信息，包括实时行情、历史K线、财务指标、股东信息、新闻公告等综合分析结果。   | [个股详情分析.md](<reference/场景Agent/个股详情分析.md>)     |
| 高管增减持详细分析 | 获取上市公司高管的增减持情况，包括近期增持金额、历史变动次数、未来计划数和持股分析等信息。       | [高管增减持详细分析.md](<reference/场景Agent/高管增减持详细分析.md>) |


## 分类统计

| 分类 | 接口数量 |
|:---|:---|
| 特色策略 | 4 |
| 指标选股 | 7 |
| 事件驱动 | 19 |
| 公募基金 | 6 |
| 牛散追击 | 5 |
| 基础数据 | 10 |
| 财务数据 | 2 |
| 行业与题材 | 7 |
| 机构动向 | 3 |
| 指数专题 | 6 |
| 资讯信息 | 3 |
| 行情数据 | 2 |
| 龙虎榜 | 10 |
| 股东协同 | 4 |
| **合计** | **88** |

## 数据来源与依赖
- **官方文档**: https://equaldata.kanjiujing.cn/equal/dist/introduction
- **PYPI包地址**: `https://pypi.org/project/equal-data/`
- **官网**: [https://equaldata.kanjiujing.cn](https://equaldata.kanjiujing.cn)
- **数据用途**: 仅用于获取行情数据，不涉及交易操作
- **开源依赖**:
  - requests (Apache 2.0)
  - pandas (BSD 3-Clause)
  - equal-data 

## 依赖验证
本 Skill 依赖的 `equal-data` 包可通过以下方式验证：
- PyPI 页面: https://pypi.org/project/equal-data/
- 源码仓库: https://github.com/kanjiujing/equal-share-skill/

## 权限说明
- **需要环境变量**: `EQUAL_DATA_API_KEY`
- **本地文件写入**: `~/.openclaw/openclaw.json`（用于缓存 API_KEY）