数据
- 作者仓库星标 179
- 作者仓库 FinClaw
- 领域
- 数据
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @aifinlab · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# efinance 中国金融市场数据工具
## 定位
efinance-data 是一个**数据获取工具层 skill**,为投研分析类 skill 提供底层数据支撑。它封装了 efinance 库的核心接口,覆盖 A 股、基金、可转债、期货四大品类。
数据来源为东方财富等公开财经网站,完全免费,无需注册或 API Key。
## 何时使用
- 用户要查某只股票的实时行情、历史K线
- 用户要看个股资金流向(主力净流入、大单、超大单)
- 用户要查龙虎榜、十大股东、业绩报表
- 用户要获取基金净值、重仓股、行业分布
- 用户需要可转债行情或期货行情
- 其他投研 skill 需要数据输入时,作为数据源调用
## 依赖
```bash
pip install efinance pandas
```
运行脚本前确认依赖已安装。如果 `import efinance` 报错,先执行上述安装命令。
## 脚本一览
所有脚本位于本 skill 的 `scripts/` 目录,输出均为 JSON 格式。
| 脚本 | 用途 | 核心命令 |
|------|------|---------|
| `stock_data.py` | 股票数据 | realtime / history / info / holders / bill / billboard / performance |
| `fund_data.py` | 基金数据 | history / position / industry / manager / period / info / codes |
| `bond_data.py` | 可转债数据 | realtime / history / info / all_info / bill |
| `futures_data.py` | 期货数据 | realtime / history / info |
## 股票数据 (stock_data.py)
### 实时行情
```bash
# 全市场 A 股实时行情(5800+ 只)
python stock_data.py realtime
# 指定股票
python stock_data.py realtime --code 000001,600519,000858
```
返回字段:代码、名称、最新价、涨跌幅、换手率、动态市盈率、总市值、流通市值等。
### 历史K线
```bash
# 日线(默认)
python stock_data.py history --code 600519
# 周线 / 月线
python stock_data.py history --code 600519 --period weekly
python stock_data.py history --code 600519 --period monthly
# 分钟级
python stock_data.py history --code 600519 --period 5min
# 指定时间范围
python stock_data.py history --code 600519 --start 20250101 --end 20251231
```
支持周期:daily / weekly / monthly / 5min / 15min / 30min / 60min
### 个股基本信息
```bash
python stock_data.py info --code 000001
```
返回:净利润、总市值、流通市值、所处行业、市盈率(动)、市净率、ROE、毛利率、净利率。
### 十大股东
```bash
python stock_data.py holders --code 000001
```
返回:股东名称、持股数、持股比例、增减、变动率。
### 资金流向
```bash
# 最近30天资金流
python stock_data.py bill --code 000001
# 最近60天
python stock_data.py bill --code 000001 --days 60
# 当日分时资金流
python stock_data.py today_bill --code 000001
```
返回字段包括:主力净流入、小单净流入、中单净流入、大单净流入、超大单净流入,以及各项占比。这是 efinance 相对其他数据源的核心优势——资金流分层非常细致。
### 龙虎榜
```bash
python stock_data.py billboard
```
返回:上榜股票、上榜日期、龙虎榜净买额、买入额、卖出额、上榜原因、机构买卖解读。
### 业绩报表
```bash
python stock_data.py performance
```
返回全市场最新业绩:营收、净利润、同比增长、每股收益、ROE、毛利率等。
### 其他
```bash
# 股东人数
python stock_data.py holder_number --code 000001
# 所属板块
python stock_data.py board --code 000001
# 逐笔成交
python stock_data.py deals --code 000001
# 最新IPO信息
python stock_data.py ipo
```
## 基金数据 (fund_data.py)
```bash
# 基金净值历史
python fund_data.py history --code 005827
# 批量获取多只基金
python fund_data.py history_multi --code 005827,110011,161725
# 基金重仓股
python fund_data.py position --code 005827
# 基金行业分布
python fund_data.py industry --code 005827
# 基金经理
python fund_data.py manager --code 005827
# 阶段涨幅(近1月/3月/1年等)
python fund_data.py period --code 005827
# 基金基本信息
python fund_data.py info --code 005827
# 基金代码列表
python fund_data.py codes
```
## 可转债数据 (bond_data.py)
```bash
# 可转债实时行情
python bond_data.py realtime
# 历史K线
python bond_data.py history --code 123456
# 全部可转债基本信息
python bond_data.py all_info
# 单只基本信息
python bond_data.py info --code 123456
# 资金流向
python bond_data.py bill --code 123456
```
注意:可转债实时行情接口偶尔因上游数据源问题返回错误,建议加 try/except 处理。
## 期货数据 (futures_data.py)
```bash
# 期货实时行情
python futures_data.py realtime
# 历史K线
python futures_data.py history --code 棕榈油2509
# 期货品种信息
python futures_data.py info
```
## 与 akshare-finance 的关系
两个 skill 互补使用:
| 数据需求 | 优先用 | 原因 |
|---------|-------|------|
| 资金流向(主力/大单分层) | efinance-data | 分层更细致 |
| 实时行情(含PE/市值) | efinance-data | 一次返回字段更全 |
| 龙虎榜(含解读) | efinance-data | 包含机构买卖成功率解读 |
| 财务三表(资产负债/利润/现金流) | akshare-finance | efinance 无此接口 |
| 北向资金 / 融资融券 | akshare-finance | efinance 无此接口 |
| 宏观经济(GDP/CPI/PMI) | akshare-finance | efinance 无此接口 |
| 估值指标详细历史 | akshare-finance | PE/PB 历史序列 |
当一个数据源出错时,可尝试用另一个获取相同数据作为备用。
## 注意事项
1. **数据来源**:公开财经网站(东方财富等),仅限学术研究和个人使用
2. **请求频率**:避免高频循环调用,建议间隔 0.5-1 秒
3. **交易时间外**:实时行情在非交易时段返回上一交易日数据
4. **数据延迟**:免费数据可能有 15 分钟延迟,不适用于实盘交易
5. **接口稳定性**:基于网页爬虫,上游网站改版可能导致接口暂时不可用
更多 API 细节见 `references/api_reference.md`。
章节与文件索引
按说明文件中的顺序排列。
何时使用
依赖
脚本一览
实时行情
历史K线
文件/命令 -> import efinance · scripts/ · stock_data.py · fund_data.py · bond_data.py · futures_data.py · references/api_reference.md
内容校验值 -> 277b8fff6d09
当前原文的自动摘译,尚未人工审校。
何时使用
用户要查某只股票的实时行情、历史K线 用户要看个股资金流向(主力净流入、大单、超大单) 用户要查龙虎榜、十大股东、业绩报表 用户要获取基金净值、重仓股、行业分布 用户需要可转债行情或期货行情
依赖
运行脚本前确认依赖已安装。如果
import efinance报错,先执行上述安装命令。脚本一览
所有脚本位于本 skill 的
scripts/目录,输出均为 JSON 格式。 脚本 · 用途 · 核心命令stock_data.py· 股票数据 · realtime / history / info / holders / bill / billboard / performancefund_data.py· 基金数据 · history / position / industry / manager / period / info / codesbond_data.py· 可转债数据 · realtime / history / info / all_info / bill实时行情
返回字段:代码、名称、最新价、涨跌幅、换手率、动态市盈率、总市值、流通市值等。