点时财务指标 · StockRoute

点时财务指标 GET /api/financial Bearer

接口:financial——按报告期返回单股财务指标,核心特性是 PIT(点时):as_of 决策日必填,仅返回 pubDate(公告日)严格早于 as_of 的记录——用本接口做回测,天然免疫'用未来财报'前视偏差。kind 支持 profit/growth/balance/cashflow/operation/dividend/forecast/express/dupont 九族。

限量:单次返回该股全部符合条件的报告期(A 股上市以来,通常 40~200 条)。kind 仅限九族:profit/growth/balance/cashflow/operation/dividend/forecast/express/dupont,传其他值报 422 并列出合法值;income/statements 族暂无专用端点,可用 /api/query 直查。

权限:min_points=0 的组免费版可调,其余需会员(基础档起);每次调用计 10 次月配额(fin 族为高价值数据集)。档位说明 →

输入参数

名称	类型	必选	描述
`code`	str	必填	股票代码,支持 600519 / 600519.SH / sh.600519
`kind`	str	必填	财报族:profit(盈利)/growth(成长)/balance(资产负债)/cashflow(现金流)/operation(营运周转)/dividend(分红)/forecast(业绩预告)/express(业绩快报)/dupont(杜邦)
`as_of`	str	必填	点时决策日 YYYY-MM-DD 或 YYYYMMDD。PIT 强制:缺省报 422;只返回 pubDate < as_of 的记录
`start`	str	选填	报告期过滤下界(如 2024-01-01)
`end`	str	选填	报告期过滤上界

输出参数

名称	类型	默认显示	描述
`code`	str	Y	标准化代码(如 sh.600519)
`pubDate`	str	Y	公告日期——PIT 锚点,回测只能用它之后的信息
`statDate`	str	Y	报告期(如 2026-06-30=中报)
`roeAvg`	float	Y	净资产收益率·平均(小数比率,0.1795 即 17.95%)
`npMargin`	float	Y	销售净利率(小数比率)
`gpMargin`	float	Y	销售毛利率(小数比率)
`netProfit`	float	Y	净利润(元)
`epsTTM`	float	Y	每股收益 TTM(元/股)
`grossProfit`	float	Y	毛利(元)
`ebit`	float	Y	息税前利润(元)
`ebitda`	float	Y	息税折旧摊销前利润(元)
`bps`	float	N	每股净资产(元/股)
`ocfps`	float	N	每股经营现金流(元/股)
`cfps`	float	N	每股现金流(元/股)
`dtEps`	float	N	稀释每股收益(元/股)
`totalShare`	float	N	总股本(股),可空
`liqaShare`	float	N	流通股本(股),可空

units 口径随每个响应返回——消费方据此判 45 是 45% 还是 0.45,不必猜。

接口示例

curl -H "Authorization: Bearer <token>" "https://api-stock.600044.xyz/api/financial?code=600519&kind=profit&as_of=2026-09-15"

import requests
# PIT 回测标准姿势:决策日 d 能看到的财报
r = requests.get("https://api-stock.600044.xyz/api/financial",
                 params={"code": "600519", "kind": "profit", "as_of": "2026-09-15"},
                 headers={"Authorization": "Bearer <token>"}).json()
print(r["pit_rule"])          # pubDate strictly < as_of
latest = r["rows"][-1]        # pubDate 最新的一条 = 决策日时点"已知"的最近财报
print(latest["statDate"], latest["roeAvg"], latest["netProfit"])

数据样例 (真实数据:贵州茅台 600519)

`code` 标准化代码(如 sh.600519)	`pubDate` 公告日期——PIT 锚点,回测只能用	`statDate` 报告期(如 2026-06-30=中	`roeAvg` 净资产收益率·平均(小数比率,0.1	`npMargin` 销售净利率(小数比率)	`gpMargin` 销售毛利率(小数比率)	`netProfit` 净利润(元)	`epsTTM` 每股收益 TTM(元/股)	`grossProfit` 毛利(元)	`ebit` 息税前利润(元)	`ebitda` 息税折旧摊销前利润(元)	`bps` 每股净资产(元/股)	`ocfps` 每股经营现金流(元/股)	`dtEps` 稀释每股收益(元/股)	`totalShare` 总股本(股),可空	`liqaShare` 流通股本(股),可空
sh.600519	2026-08-15	2026-06-30	0.179543	0.507516	0.895552	46033330566.78	35.57	81229498398.6	61192879672.31	62400270288.53	200.9898	56.5489	35.57	null	null

[
  {
    "bps": 200.9898,
    "code": "sh.600519",
    "dtEps": 35.57,
    "ebit": 61192879672.31,
    "ebitda": 62400270288.53,
    "epsTTM": 35.57,
    "gpMargin": 0.895552,
    "grossProfit": 81229498398.6,
    "liqaShare": null,
    "netProfit": 46033330566.78,
    "npMargin": 0.507516,
    "ocfps": 56.5489,
    "pubDate": "2026-08-15",
    "roeAvg": 0.179543,
    "statDate": "2026-06-30",
    "totalShare": null
  }
]

表头第二行为字段含义(悬停无截断完整版见上方「输出参数表」);首列固定,横向滚动查看更多字段。

注意事项

比率字段是小数口径(0.18=18%),金额字段单位元,每股字段元/股——以响应 units 为准。
as_of 当天公告的财报不可见(严格小于,次日起效)——这是防前视的关键,不是 bug。
决策日尚无可比财报时返回空 rows(fail-closed,绝不填 0)——请按空数组处理。
dividend/forecast/express/dupont 各族字段结构不同,字段字典以响应 units + 本页 kind 切换为准。

← 返回接口列表 · 错误码:401 无效token / 403 需会员(该数据集基础档起) / 404 无数据 / 422 缺必填 / 429 限速或月配额 / 503 授权暂不可用(fail-closed)