FTLib

数据服务

财务数据

按报告期与公告日提供资产负债表、利润表、现金流量表、财务指标、业绩预告与分红送转数据,支持历史回溯与 point-in-time 研究。

三大报表财务指标公告日口径业绩预告

财务数据是基本面量化、事件研究与风险筛查的核心输入。三张报表之间存在明确的勾稽关系,但仅有报告期数值并不足以支持回测:还必须知道数据在何时首次公开。

FTLib 同时提供报告期、公告日与数据版本。研究者可以按公告日构建 point-in-time 面板,避免在历史时点使用尚未披露的财务数据;也可以在需要时回溯追溯调整后的最新口径。

覆盖范围

财务数据按报告期与公告日组织。不同报表的字段集合不同,接口以报表类型区分;指标数据基于报表计算,并保留计算口径。

项目说明
报表资产负债表、利润表、现金流量表
指标ROE、毛利率、净利率、资产负债率、经营现金流/净利润等
事件业绩预告、业绩快报、分红送转
覆盖品种A 股股票
时间口径报告期 + 公告日
历史版本保留追溯调整前后的记录
更新时点公告发布后更新
接入方式REST

字段说明

金额字段统一为元,比率字段为百分比数值。单季值与累计值通过字段或参数区分,避免直接混用。

字段类型说明
symbolstring证券代码
report_periodstring报告期,如 2026Q3
announce_datestring首次公告日期,YYYY-MM-DD
statement_typestring报表类型
revenuenumber营业收入,元
net_profitnumber归母净利润,元
total_assetsnumber资产总计,元
total_liabilitiesnumber负债合计,元
equitynumber归母所有者权益,元
operating_cash_flownumber经营活动现金流量净额,元
roenumber净资产收益率,百分比
gross_marginnumber毛利率,百分比

请求示例

以下请求获取某只股票 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 参数限制可见时间,或在本地按公告日过滤。报告中同时保留报告期与公告日,便于审计。
单季值和累计值如何区分?
接口字段与参数会明确标识口径。若只提供累计值,可用同一报告期相邻季度的累计值相减得到单季值。
追溯调整后应该使用哪个版本?
取决于研究目的。复现历史决策应使用当时可见的首次披露值;分析当前基本面可使用调整后的最新版本。

把财务数据对齐到公告日

查看报表字段、point-in-time 查询方式与指标口径,或提交接入咨询确认历史覆盖范围。