ptrade `get_fundamentals` - 获取财务数据

最新推荐文章于 2025-12-20 15:00:17 发布

原创

最新推荐文章于 2025-12-20 15:00:17 发布 · 668 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#数据库 #python #ptrade

`get_fundamentals` - 获取财务数据

get_fundamentals(
    security,
    table,
    fields=None,
    date=None,
    start_year=None,
    end_year=None,
    report_types=None,
    merge_type=None,
    is_dataframe=False
)

使用场景

该函数可在 研究、回测、交易模块 使用。

接口说明

获取 财务三大报表数据、日频估值数据、各项财务能力指标数据。

注意事项

网络限制：HTTP 在线获取，可能因网络拥堵导致应答失败，返回空数据时请重试，策略中需增加保护机制。
流量限制：
- 每秒调用 ≤ 100 次；
- 单次最大 500 条；
- 每条定义：1 只股票 × 1 张表 × 1 个字段，最大 5 万条。
非 PIT 数据：
- growth_ability、profit_ability、eps、operating_ability、debt_paying_ability 五张表 非 PIT 数据；
- 按日期请求时，若该期财报未发布，返回 None。
科创板存托凭证（如九号公司 689009.SS）无财务报表披露信息。

参数

参数	类型	说明
`security`	`str` / `list[str]`	股票代码
`table`	`str`	表名，见下表
`fields`	`list[str]`	指定返回字段
`date`	`str` / `datetime.date`	查询日期，与 `start_year`/`end_year` 互斥
`start_year`/`end_year`	`str`	查询年份区间，与 `date` 互斥
`report_types`	`str`	财报类型：`'1'` 一季报，`'2'` 半年报，`'3'` 三季报，`'4'` 年报
`merge_type`	`int`	数据版本：`None` 首次发布；`1` 最新发布
`is_dataframe`	`bool`	`True` 返回 `DataFrame`，`False` 返回 `Panel`（仅 Python 3.5 按年份查询）

表名与内容

表名	内容
`valuation`	估值数据
`balance_statement`	资产负债表
`income_statement`	利润表
`cashflow_statement`	现金流量表
`growth_ability`	成长能力指标
`profit_ability`	盈利能力指标
`eps`	每股指标