数据服务
财务数据
按报告期与公告日提供资产负债表、利润表、现金流量表、财务指标、业绩预告与分红送转数据,支持历史回溯与 point-in-time 研究。
三大报表财务指标公告日口径业绩预告
财务数据是基本面量化、事件研究与风险筛查的核心输入。三张报表之间存在明确的勾稽关系,但仅有报告期数值并不足以支持回测:还必须知道数据在何时首次公开。
FTLib 同时提供报告期、公告日与数据版本。研究者可以按公告日构建 point-in-time 面板,避免在历史时点使用尚未披露的财务数据;也可以在需要时回溯追溯调整后的最新口径。
覆盖范围
财务数据按报告期与公告日组织。不同报表的字段集合不同,接口以报表类型区分;指标数据基于报表计算,并保留计算口径。
| 项目 | 说明 |
|---|---|
| 报表 | 资产负债表、利润表、现金流量表 |
| 指标 | ROE、毛利率、净利率、资产负债率、经营现金流/净利润等 |
| 事件 | 业绩预告、业绩快报、分红送转 |
| 覆盖品种 | A 股股票 |
| 时间口径 | 报告期 + 公告日 |
| 历史版本 | 保留追溯调整前后的记录 |
| 更新时点 | 公告发布后更新 |
| 接入方式 | REST |
字段说明
金额字段统一为元,比率字段为百分比数值。单季值与累计值通过字段或参数区分,避免直接混用。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 证券代码 |
report_period | string | 报告期,如 2026Q3 |
announce_date | string | 首次公告日期,YYYY-MM-DD |
statement_type | string | 报表类型 |
revenue | number | 营业收入,元 |
net_profit | number | 归母净利润,元 |
total_assets | number | 资产总计,元 |
total_liabilities | number | 负债合计,元 |
equity | number | 归母所有者权益,元 |
operating_cash_flow | number | 经营活动现金流量净额,元 |
roe | number | 净资产收益率,百分比 |
gross_margin | number | 毛利率,百分比 |
请求示例
以下请求获取某只股票 2026 年三季报的财务数据。使用 as_of 参数可只返回该日期之前已公告的版本。
按报告期查询
不传 as_of 时返回最新版本;传入 as_of 可复现历史时点可见的数据。
bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
"https://api.ftlib.com/v1/financials/reports?symbol=600519.SH&period=2026Q3&as_of=2026-10-31"
返回结构
金额为元,比率为百分数。示例数据仅用于字段说明。
json
{
"code": 0,
"message": "ok",
"request_id": "req_91a4c2d0",
"data": {
"symbol": "600519.SH",
"report_period": "2026Q3",
"announce_date": "2026-10-29",
"statement_type": "income",
"revenue": 108420000000.00,
"net_profit": 52860000000.00,
"total_assets": 312800000000.00,
"total_liabilities": 68200000000.00,
"equity": 244600000000.00,
"operating_cash_flow": 50120000000.00,
"roe": 21.60,
"gross_margin": 91.20,
"version": "2026Q3-v1"
}
}
数据口径与更新
- 公告日用于确定数据首次可见时间。回测中应按公告日而不是报告期结束日对齐,避免使用未来信息。
- 累计值与单季值不可混用。利润表与现金流量表通常披露年初至报告期末的累计值,单季值需通过相邻报告期相减得到。
- 追溯调整会导致同一报告期存在多个版本。FTLib 保留版本与公告日,研究者应明确使用首次披露值还是调整后值。
- 业绩预告与业绩快报属于估计或初步数据,与正式报表存在差异,事件研究应分别标记。
- 比率指标基于报表计算,口径可能因分母选择不同而变化。使用前应查看字段说明并保持横向比较一致。
避免前视偏差
若在 2026-10-15 时点做决策,不能使用 2026-10-29 才公告的三季报。请使用 as_of 参数或按公告日过滤,并在回测中显式记录数据可见时间。
典型用法
常见问题
财务数据按什么时间更新?
按上市公司公告披露更新。正式报表、业绩预告与业绩快报使用不同的数据表,并保留公告日期。
如何避免用到尚未公告的数据?
使用 as_of 参数限制可见时间,或在本地按公告日过滤。报告中同时保留报告期与公告日,便于审计。
单季值和累计值如何区分?
接口字段与参数会明确标识口径。若只提供累计值,可用同一报告期相邻季度的累计值相减得到单季值。
追溯调整后应该使用哪个版本?
取决于研究目的。复现历史决策应使用当时可见的首次披露值;分析当前基本面可使用调整后的最新版本。