财务数据

获取最新或指定报告期的财务快照

门槛需要 专业版 及以上

数据报告期入库, 含约400个字段(EPS/ROE/BPS/三表科目...; 行业差异单票260~400)

限制单次=单票单报告期

接口说明

最新或指定报告期的财务快照,约 400 个字段:EPS、ROE、BPS 及三表科目,单次返回单票单报告期。

基本面筛选、财务因子构建用它

字段多,建议先调一次看返回的 fields 字典再按需取列

快速调用

同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。

最新一期财务
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

fin = pro.financial(code="sz000001")   # → 一行宽表(约400字段)
eps = fin["EPS"].iloc[0]   # 字段名大小写敏感

输入参数

名称类型必选描述
codestrTrue证券代码
report_datestrFalse报告期 YYYY-MM-DD, 缺省最新一期

返回字段

名称类型描述
codestr证券代码
fieldsdict稀疏字典: 英文字段名→值(如 EPS/ROE/BPS/ipo_date); 未披露字段缺失

返回数据样例

{
  "code": "sz000001",
  "fields": {
    "EPS": 1.24,
    "deductEPS": 1.24,
    "undistributedProfitPerShare": 14.8334,
    "netAssetsPerShare": 24.13,
    "capitalReservePerShare": 4.1445,
    "ROE": 4.687,
    "operatingCashFlowPerShare": 11.08,
    "moneyFunds": 354877014016.0,
    "tradingFinancialAssets": 821274017792.0,
    "investmentRealEstate": 552000000.0,
    "fixedAssets": 10464000000.0,
    "intangibleAssets": 5415000064.0,
    "goodwill": 7568000000.0,
    "deferredIncomeTaxAssets": 50064998400.0,
    "totalAssets": 6028785090560.0
  }
}

样例取自平台实时数据,财务字段共 221 个,样例仅展示前 15 个。

最佳实践:字段名大小写敏感: 先不传 fields 看全部列名再挑; fields 写错的列不会丢——挂 df.attrs["dropped_fields"] 提示。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。