财务数据接口

财务数据

财务报表和公司行为相关接口。

方法	端点	说明
GET	/v1/finance/balance	资产负债表
GET	/v1/finance/income	利润表
GET	/v1/finance/cash-flow	现金流量表
GET	/v1/finance/forecast	业绩预告
GET	/v1/finance/shares	股本变动
GET	/v1/finance/dividend	分红送转
GET	/v1/finance/lifting	限售解禁
GET	/v1/finance/stock-repurchase	股票回购
GET	/v1/finance/institute-recommend	机构评级
GET	/v1/finance/restricted-release-summary	限售解禁汇总
GET	/v1/finance/restricted-release-detail	限售解禁明细
GET	/v1/finance/restricted-release-queue	限售解禁批次
GET	/v1/finance/restricted-release-stockholder	限售解禁股东明细

---

1. 资产负债表

方法	端点
GET	/v1/finance/balance

获取上市公司资产负债表数据。

参数	类型	必填	说明
symbol	string	✅	股票代码
date	string	-	报告期 (YYYY-MM-DD)
start_date	string	-	开始日期 (YYYY-MM-DD)
end_date	string	-	结束日期 (YYYY-MM-DD)
limit	int	-	返回条数 (默认 20)

GET/v1/finance/balance

API Key

Parameters

symbol

date

limit

Try It

---

2. 利润表

方法	端点
GET	/v1/finance/income

获取上市公司利润表数据。

参数	类型	必填	说明
symbol	string	✅	股票代码
date	string	-	报告期 (YYYY-MM-DD)
start_date	string	-	开始日期 (YYYY-MM-DD)
end_date	string	-	结束日期 (YYYY-MM-DD)
limit	int	-	返回条数 (默认 20)

GET/v1/finance/income

API Key

Parameters

symbol

date

limit

Try It

---

3. 现金流量表

方法	端点
GET	/v1/finance/cash-flow

获取上市公司现金流量表数据。

参数	类型	必填	说明
symbol	string	✅	股票代码
date	string	-	报告期 (YYYY-MM-DD)
start_date	string	-	开始日期 (YYYY-MM-DD)
end_date	string	-	结束日期 (YYYY-MM-DD)
limit	int	-	返回条数 (默认 20)

GET/v1/finance/cash-flow

API Key

Parameters

symbol

date

limit

Try It

---

4. 业绩预告

方法	端点
GET	/v1/finance/forecast

获取上市公司业绩预告数据。

参数	类型	必填	说明
symbol	string	-	股票代码 (可选)
report_period	string	-	报告期 (YYYY-MM-DD)
limit	int	-	返回条数 (默认 100)

GET/v1/finance/forecast

API Key

Parameters

limit

Try It

---

5. 股本变动

方法	端点
GET	/v1/finance/shares

获取上市公司股本变动历史。

参数	类型	必填	说明
symbol	string	✅	股票代码
start_date	string	-	开始变动日期 (YYYY-MM-DD)
end_date	string	-	结束变动日期 (YYYY-MM-DD)
limit	int	-	返回条数 (默认 20)

GET/v1/finance/shares

API Key

Parameters

symbol

start_date

end_date

limit

Try It

---

6. 分红数据

方法	端点
GET	/v1/finance/dividend

获取上市公司分红送转历史。

参数	类型	必填	说明
symbol	string	✅	股票代码
date	string	-	报告期 (YYYY-MM-DD)
start_date	string	-	开始日期 (YYYY-MM-DD)
end_date	string	-	结束日期 (YYYY-MM-DD)
start_ex_dividend_date	string	-	开始除权除息日 (YYYY-MM-DD)
end_ex_dividend_date	string	-	结束除权除息日 (YYYY-MM-DD)
limit	int	-	返回条数 (默认 20)

GET/v1/finance/dividend

API Key

Parameters

symbol

date

limit

Try It

---

7. 限售解禁

方法	端点
GET	/v1/finance/lifting

获取限售股解禁数据。

参数	类型	必填	说明
symbol	string	-	股票代码 (可选)
start_date	string	-	开始日期
end_date	string	-	结束日期
limit	int	-	返回条数 (默认 100)

GET/v1/finance/lifting

API Key

Parameters

limit

Try It

---

8. 财务衍生比率

方法	端点
GET	/v1/finance/ratios

获取财务衍生比率，合并 dws_stock_quality_daily_snapshot（ROIC/ROE/毛利率/FCF）与 dwd_finance_core_index（EPS/杠杆/周转/增长）两大快照源。适用于估值建模与基本面筛选。

参数	类型	必填	说明
symbol	string	✓	股票代码
date	string	-	截止日期 (YYYY-MM-DD)
start_date	string	-	开始日期
end_date	string	-	结束日期
limit	int	-	返回条数 (默认 20)

响应包含：roic、roe、gross_margin、net_margin、fcf_margin、accrual_ratio、roe_wtd、roa_wtd、curr_ratio、quick_ratio、asset_liab_ratio、basic_eps、net_asset_ps、total_rev_yoy_gr、net_profit_yoy_gr 等衍生指标。

GET/v1/finance/ratios

API Key

Parameters

symbol

limit

Try It

---

9. 股东结构

方法	端点
GET	/v1/finance/holder-structure

获取股东户数历史与十大流通股东明细，用于筹码集中度与机构持仓变化分析。

参数	类型	必填	说明
symbol	string	✓	股票代码
report_date	string	-	报告期 (YYYY-MM-DD)
limit	int	-	返回期数 (默认 8，每期含 top10)

每行返回 holder_count、holder_change_pct、avg_market_value，以及 top10_holders 数组（股东名称、持股量、变动比例、流通市值）。

GET/v1/finance/holder-structure

API Key

Parameters

symbol

limit

Try It

---

10. 研报数据

方法	端点
GET	/v1/finance/research-reports

获取卖方研报（标题、机构、分析师、评级、目标价、EPS 预测）与机构调研汇总，支持按股票或日期范围筛选。

参数	类型	必填	说明
symbol	string	-	股票代码 (不填返回全市场最新)
start_date	string	-	开始日期
end_date	string	-	结束日期
limit	int	-	返回条数 (默认 20)

GET/v1/finance/research-reports

API Key

Parameters

symbol

limit

Try It

---

11. 事件日历

方法	端点
GET	/v1/finance/event-calendar

聚合分红除权、停复牌、限售解禁三类事件，按日期倒序返回统一格式的事件列表。

参数	类型	必填	说明
symbol	string	✓	股票代码
start_date	string	-	开始日期
end_date	string	-	结束日期
limit	int	-	返回事件数 (默认 50)

每条事件包含 date、event_type (dividend_ex / suspend / restricted_release)、description，部分类型附带 detail 明细字段。

GET/v1/finance/event-calendar

API Key

Parameters

symbol

limit

Try It

---

12. 事件置信度

方法	端点
GET	/v1/finance/event-confidence

获取事件置信度评分，量化龙虎榜、限售解禁、回购、评级变动等市场事件对个股的冲击强度。

参数	类型	必填	说明
symbol	string	✓	股票代码
start_date	string	-	开始日期
end_date	string	-	结束日期
limit	int	-	返回条数 (默认 30)

响应字段：event_type、event_subtype、event_confidence (0-1)、impact_score、event_half_life_days、priced_in_flag、bias (bullish/bearish/neutral)、importance。

GET/v1/finance/event-confidence

API Key

Parameters

symbol

limit

Try It