Appearance
获取时间范围的现金流衍生指标
get_cash_flow_indicators_seq-获取时间范围的现金流衍生指标
查询指定日期范围,股票所属上市公司的现金流衍生指标数据。
函数原型
python
get_cash_flow_indicators_seq(security=None, fields=None, start_date=None, end_date=None)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sz000001)或多个代码组成的列表(如['sz000001', 'sz000002']) |
| fields | list[str] | 是 | 需要查询的现金流衍生指标字段列表 |
| start_date | 多种类型 | 否 | 查询开始日期,支持日期类型或字符串格式如2025-01-01或时间戳,自动截取到日期维度;默认回测当前时间 |
| end_date | 多种类型 | 否 | 查询结束日期,支持日期类型或字符串格式如2025-01-01或时间戳,自动截取到日期维度;默认回测当前时间 |
返回值
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- date:查询日期,日期类型
完整示例
python
from zltquant import *
def initialize(context):
pass
def handle_data(context, data):
# 示例1:查询2024-04-01至2024-04-30平安银行的每股经营现金流ttm、经营现金流/负债合计ttm
df = get_cash_flow_indicators_seq(
security='sz000001',
fields=['operating_cash_flow_per_share_ttm', 'ocf_to_debt_ttm'],
start_date='2024-04-01',
end_date='2024-04-30'
)
log.info(df)
# 输出:
# security date operating_cash_flow_per_share_ttm ocf_to_debt_ttm
# 0 sz000001 2024-04-01 2.8567 0.1689
# 1 sz000001 2024-04-02 2.8612 0.1692
# ...
# 29 sz000001 2024-04-30 2.8785 0.1705
# 示例2:查询2024-04-01至2024-04-05平安银行和万科A的每股现金流ttm、盈余现金保障倍数ttm
df = get_cash_flow_indicators_seq(
security=['sz000001', 'sz000002'],
fields=['cash_flow_per_share_ttm', 'surplus_cash_protection_multiples_ttm'],
start_date='2024-04-01',
end_date='2024-04-05'
)
log.info(df)
# 输出:
# security date cash_flow_per_share_ttm surplus_cash_protection_multiples_ttm
# 0 sz000001 2024-04-01 3.2546 1.2589
# 1 sz000001 2024-04-02 3.2618 1.2615
# 2 sz000002 2024-04-01 2.1578 1.3245
# 3 sz000002 2024-04-02 2.1634 1.3289
# 4 sz000001 2024-04-03 3.2705 1.2638
# 5 sz000002 2024-04-03 2.1592 1.3312
# ...
if __name__ == '__main__':
run_main()支持的现金流衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| cash_flow_per_share_lyr | 每股现金流lyr | (经营活动产生的现金流量净额lyr + 投资活动产生的现金流量净额lyr + 筹资活动产生的现金流量净额lyr)/ 总股本 |
| cash_flow_per_share_ttm | 每股现金流ttm | (经营活动产生的现金流量净额ttm + 投资活动产生的现金流量净额ttm + 筹资活动产生的现金流量净额ttm)/ 总股本 |
| operating_cash_flow_per_share_lyr | 每股经营现金流lyr | 经营活动产生的现金流量净额lyr / 总股本 |
| operating_cash_flow_per_share_ttm | 每股经营现金流ttm | 经营活动产生的现金流量净额ttm / 总股本 |
| fcff_lyr | 企业自由现金流量lyr | 归属于母公司所有者的净利润lyr + 资产减值准备lyr + 固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr + 利息费用lyr *(1 - 所得税lyr / 利润总额lyr)-(本期固定资产合计lyr-上期固定资产合计lyr + 固定资产折旧lyr)-营运资本变动额lyr 其中: 利息费用=利息支出(财务费用)-利息收入(财务费用),如果企业未披露利息收入(财务费用)和利息支出(财务费用),则“利息费用=财务费用”;营运资本变动额=期末[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债)]-期初[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债) |
| fcff_ttm | 企业自由现金流量ttm | 归属于母公司所有者的净利润ttm + 资产减值准备ttm + 固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm + 利息费用ttm *(1 - 所得税ttm / 利润总额ttm)-(本期固定资产合计ttm-上期固定资产合计ttm + 固定资产折旧ttm)-营运资本变动额ttm 其中: 利息费用=利息支出(财务费用)-利息收入(财务费用),如果企业未披露利息收入(财务费用)和利息支出(财务费用),则“利息费用=财务费用”;营运资本变动额=期末[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债)]-期初[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债) |
| fcfe_lyr | 股权自由现金流量lyr | 归属于母公司所有者的净利润lyr + 资产减值准备lyr + 固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr -(本期固定资产合计lyr - 上期固定资产合计lyr + 固定资产折旧lyr)- 营运资本变动额lyr + 净债务增加lyr 其中: 营运资本变动额=期末[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债)]-期初[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债)];净债务增加=期末(短期借款+长期借款+应付债券)-期初(短期借款+长期借款+应付债券) |
| fcfe_ttm | 股权自由现金流量ttm | 归属于母公司所有者的净利润ttm + 资产减值准备ttm + 固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm -(本期固定资产合计ttm - 上期固定资产合计ttm + 固定资产折旧ttm)- 营运资本变动额ttm + 净债务增加ttm 其中: 营运资本变动额=期末[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债)]-期初[(流动资产合计-货币资金)-(流动负债合计-应付票据-一年内到期的非流动负债)];净债务增加=期末(短期借款+长期借款+应付债券)-期初(短期借款+长期借款+应付债券) |
| free_cash_flow_company_per_share_lyr | 每股企业自由现金流lyr | 企业自由现金流量lyr / 总股本 |
| free_cash_flow_company_per_share_ttm | 每股企业自由现金流ttm | 企业自由现金流量ttm / 总股本 |
| free_cash_flow_equity_per_share_lyr | 每股股东自由现金流lyr | 股东自由现金流量lyr / 总股本 |
| free_cash_flow_equity_per_share_ttm | 每股股东自由现金流ttm | 股东自由现金流量ttm / 总股本 |
| ocf_to_debt_lyr | 经营活动产生的现金流量净额/负债合计lyr | 经营活动产生的现金流量净额lyr / 负债合计lyr |
| ocf_to_debt_ttm | 经营活动产生的现金流量净额/负债合计ttm | 经营活动产生的现金流量净额ttm / 负债合计ttm |
| surplus_cash_protection_multiples_lyr | 盈余现金保障倍数lyr | 经营活动产生的现金流量净额lyr/净利润lyr*100% |
| surplus_cash_protection_multiples_ttm | 盈余现金保障倍数ttm | 经营活动产生的现金流量净额ttm/净利润ttm *100% |
| ocf_to_interest_bearing_debt_lyr | 经营活动产生的现金流量净额/带息债务lyr | 经营活动产生的现金流量净额lyr / 带息债务lyr |
| ocf_to_interest_bearing_debt_ttm | 经营活动产生的现金流量净额/带息债务ttm | 经营活动产生的现金流量净额ttm / 带息债务ttm |
| ocf_to_current_ratio_lyr | 经营活动产生的现金流量净额/流动负债lyr | 经营活动产生的现金流量净额lyr/流动负债lyr |
| ocf_to_current_ratio_ttm | 经营活动产生的现金流量净额/流动负债ttm | 经营活动产生的现金流量净额ttm / 流动负债ttm |
| ocf_to_net_debt_lyr | 经营活动产生的现金流量净额/净债务lyr | 经营活动产生的现金流量净额lyr / 净债务lyr |
| ocf_to_net_debt_ttm | 经营活动产生的现金流量净额/净债务ttm | 经营活动产生的现金流量净额ttm / 净债务ttm |
| depreciation_and_amortization_lyr | 当期计提折旧与摊销lyr | 固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr |
| depreciation_and_amortization_ttm | 当期计提折旧与摊销ttm | 固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm |
| cash_flow_ratio_lyr | 现金流量比率lyr | 息税折旧摊销前利润lyr / 利息支出lyr |
| cash_flow_ratio_ttm | 现金流量比率ttm | 息税折旧摊销前利润ttm / 利息支出 ttm |