equal-data-skill

概述

equal-data-skill 是基于 PyPI 包 equal-data 封装的金融数据服务 Skill，主要是用于查询A股股票的各个维度统计信息。该模块通过标准化API方式统一了数据资产的对外服务方式，以帮助有需要的技术用户更实时、简洁、轻量的使用相关数据。

快速上手

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

python -m venv test_env
source test_env/bin/activate
pip install equal-data -i https://pypi.tuna.tsinghua.edu.cn/simple

• 根据接口文档，使用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
)

参数格式说明

• 返回格式：json

认证方式

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

equaldata官网注册，获取API Key，

方式 A：配置环境变量。

# macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc
export EQUAL_DATA_API_KEY="your_key_here"

然后根据系统执行对应的命令：

macOS：

source ~/.zshrc

Linux：

source ~/.bashrc

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

{
  "skills": {
    "entries": {
      "equal-data-skill": {
        "enabled": true,
        "env": {
          "EQUAL_DATA_API_KEY": "your actual api key here"
        }
      }
    }
  }
}

触发指令

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

数据接口列表

分类统计

数据来源与依赖

• 官方文档: https://equal-data.com/equal/dist/datainterface
• PYPI包地址: https://pypi.org/project/equal-data/
• 官网: https://equal-data.com/
• 数据用途: 仅用于获取行情数据，不涉及交易操作
• 开源依赖:
  • 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）