# Eastmoney

东方财富（Eastmoney）免费免鉴权数据接口，覆盖资金流向、龙虎榜、融资融券、大宗交易、股东户数、限售解禁、行业概念板块、券商研报、财经新闻、A股/港股三大报表+主要指标、...

- Repository: https://github.com/HKUDS/Vibe-Trading (37375 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add HKUDS/Vibe-Trading --skill eastmoney -g -a claude-code -y`
Codex: `npx skills add HKUDS/Vibe-Trading --skill eastmoney -g -a codex -y`
Cursor: `npx skills add HKUDS/Vibe-Trading --skill eastmoney -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/Vibe-Trading --skill eastmoney -g -a gemini-cli -y`

## Description

东方财富（Eastmoney）免费免鉴权数据接口，覆盖资金流向、龙虎榜、融资融券、大宗交易、股东户数、限售解禁、行业概念板块、券商研报、财经新闻、A股/港股三大报表+主要指标、全市场选股与代码搜索；美股财报由 get_financial_statements 转 SEC EDGAR。东财请求经共享 IP 限速层节流（东财按源 IP 限流并临时封禁突发请求），通过 Vibe-Trading 工具直接调用，无需 token。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Eastmoney（东方财富）

## 概述

东方财富对外开放了一批免费、免鉴权的行情与披露接口（push2 / push2his / datacenter-web / reportapi / search-api）。这些接口由 Vibe-Trading 内置工具封装，统一返回 `{"ok": true/false, ...}` JSON 信封，覆盖 A 股 / 港股 / 美股的资金面、披露面、舆情面与基本面数据。本技能是上述接口的**索引页**：每个接口的端点 URL、入参、返回字段写在 `references/` 下；调用范例写在 `scripts/` 下。

> **限速红线**：东方财富按**源 IP** 限流，并会临时封禁突发请求。所有工具内部已经过共享 per-host 节流层（`backtest.loaders._http`），切勿绕过工具直接对端点发起裸 HTTP 突发请求。可用环境变量 `VIBE_TRADING_EASTMONEY_MIN_INTERVAL` 调整最小请求间隔（默认 1.0 秒）。

## 快速上手

这些接口已注册为 Vibe-Trading 工具，直接以工具名调用即可，无需安装 SDK、无需 token：

```python
from src.tools.fund_flow_tool import FundFlowTool

# 主力 / 超大单 / 大单 / 中单 / 小单 净流入（近 30 日）
print(FundFlowTool().execute(codes=["600519.SH", "00700.HK"], period="daily", days=30))
```

底层共享客户端 `backtest.loaders.eastmoney_client` 负责 `secid` 解析与限速 GET：

```python
from backtest.loaders.eastmoney_client import resolve_secid, get_json

resolve_secid("600519.SH")   # -> "1.600519"
resolve_secid("00700.HK")    # -> "116.00700"
resolve_secid("AAPL.US")     # -> "105.AAPL"（经 suggest 端点解析并进程内缓存）
```

## 参数格式说明

- **代码（symbol）**：`<code>.<exchange>` 形式，交易所后缀大写。A 股 `600519.SH` / `000001.SZ` / `830799.BJ`，港股 `00700.HK`（零填充至 5 位），美股 `AAPL.US`。
- **secid**：东财内部寻址 `<market>.<code>`。SH=1，SZ/BJ=0，HK=116，美股 NASDAQ=105 / NYSE=106 / AMEX=107（美股 market 前缀由 suggest 端点解析）。
- **日期**：datacenter `filter` 用 `YYYY-MM-DD`；kline `beg`/`end` 用 `YYYYMMDD`。
- **返回**：统一 JSON 字符串信封，成功 `{"ok": true, "market", "source": "eastmoney", "data": {...}}`，失败 `{"ok": false, "error": ...}`。单个失败 symbol 以 per-symbol error 上报，不中断批次。

> 链接约定：本文档内所有指向 `references/` 的链接均以**相对本文档**的形式书写（`references/...`），这是 GitHub 在浏览器中打开该文件时解析的形式。`read_file` 工具会把同一字符串解析到拥有它的技能目录下，因此人和 agent 读到的是同一份文件。新增文档请沿用相对形式，并保证 references 路径在各技能之间不重名：两个技能同时拥有的路径会被报为歧义，而不会被猜测。

## python 脚本示例

- [资金流向 + 板块联动研究](scripts/fund_flow_example.py)
- [龙虎榜 + 大宗交易 + 融资融券披露面研究](scripts/disclosure_example.py)
- [研报舆情 + 财报基本面研究](scripts/fundamentals_example.py)
- [代码搜索 + 全市场选股](scripts/screen_search_example.py)

## 接口列表

The rest: https://github.com/HKUDS/Vibe-Trading/blob/HEAD/agent/src/skills/eastmoney/SKILL.md