Appearance
财务数据
获取报告期财务数据
get_fundamentals-获取报告期财务数据
查询指定报告期区间内,股票所属上市公司的财务数据,支持单只/多只标的、多字段批量查询,可按报表类型筛选数据。
函数原型
python
get_fundamentals(security, fields, start_quarter=None, end_quarter=None, report_type=0, data_type=2)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sz000001)或多个代码组成的列表(如[sz000001, sh600000]) |
| fields | list[str] | 是 | 需查询的财务字段列表,字段支持类型见 数据库 核心资产负债表、专业资产负债表、核心现金流量表&利润表、专业现金流量表、专业利润表字段 |
| start_quarter | str | 否 | 财报回溯查询起始报告期,格式为年+q+季度,例如2015q2代表2015年半年报、2020q1代表2020年一季报 |
| end_quarter | str | 否 | 财报回溯查询结束报告期,格式同start_quarter,例如2015q4代表2015年年报、2020q3代表2020年前三季报 |
| report_type | int | 否 | 报表类型,默认0为不限类型,按报告期查询可指定:0-不限(最近一个报告期累计值)、3-第一季度、6-中报、9-前三季报、12-年报 |
| data_type | int | 否 | 返回数据类型,1-合并原始、2-合并调整,默认2 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有财务字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- pub_date:财报发布日期,datetime.date类型
- report_period:报告期,字符串类型
完整示例
python
# 示例1:查询平安银行2020年年报的归母净利润、营业总收入、资产总计
df = get_fundamentals(
security='sz000001',
fields=['is_parent_net_profit', 'is_total_rev', 'bs_total_assets'],
start_quarter='2020q4',
end_quarter='2020q4',
report_type=12
)
log.info(df) # 输出: security pub_date report_period is_parent_net_profit is_total_rev bs_total_assets
# 0 sz000001 2021-03-10 2020q4 28928000000.0 1535420000000.0 4.91383e+12
# 示例2:查询多只股票2020年1-4季度的归母净利润
df = get_fundamentals(
security=['sz000001', 'sz000002', 'sh600000'],
fields=['is_parent_net_profit'],
start_quarter='2020q1',
end_quarter='2020q4'
)
log.info(df) # 输出多只标的4个季度的财务数据,含security、pub_date、report_period及查询字段列支持的财务字段
fields支持的字段:需查询的财务字段列表,字段支持类型见 数据库 核心资产负债表、专业资产负债表、核心现金流量表&利润表、专业现金流量表、专业利润表字段
获取点时间财务数据
get_fundamentals_pit-获取点时间财务数据
查询指定时间点,股票所属上市公司最新披露的财务数据,精准匹配指定日期的财报披露状态,支持单/多标的、多字段查询。
函数原型
python
get_fundamentals_pit(security, fields, date=None, report_type=0, data_type=2)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sh600000)或多个代码组成的列表(如[sz000001, sz000002]) |
| fields | list[str] | 是 | 需查询的财务字段列表,支持字段与get_fundamentals完全一致 |
| date | 多种类型 | 否 | 查询日期,支持datetime.date/datetime.datetime/yyyy-mm-dd/yyyy-mm-dd hh: mm: ss/时间戳,自动截取到日期维度;默认使用回测当前时间 |
| report_type | int | 否 | 报表类型,默认0为不限类型,可指定:0-不限(最近一个报告期累计值)、1-第一季度报、2-第二季度、3-第三季度、4-第四季度、6-中报、9-前三季报、12-年报 |
| data_type | int | 否 | 返回数据类型,1-合并原始、2-合并调整,默认2 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有财务字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- pub_date:财报发布日期,datetime.date类型
- report_date:报告日期,datetime.date类型
完整示例
python
# 示例1:查询2021年01月01日平安银行最新披露的归母净利润、营业总收入
df = get_fundamentals_pit(
security='sz000001',
fields=['is_parent_net_profit', 'is_total_rev'],
date='2021-01-01',
report_type=0
)
log.info(df) # 输出: security pub_date report_date is_parent_net_profit is_total_rev
# 0 sz000001 2020-10-30 2020-09-30 23625000000.0 1154610000000.0
# 示例2:查询2020年12月31日多只股票的应付债券,指定报表类型为年报
df = get_fundamentals_pit(
security=['sz000001', 'sh600000'],
fields=['bs_pay_bond'],
date='2020-12-31',
report_type=12
)
log.info(df) # 输出多只标的对应日期的财务数据,含security、pub_date、report_date及查询字段列获取点时间估值衍生指标
get_valuation_indicators-获取点时间估值衍生指标
查询指定时间点,股票所属上市公司的估值衍生指标数据,涵盖市值、市盈率、市净率等核心估值指标,支持单/多标的查询。
函数原型
python
get_valuation_indicators(security, fields=None, date=None)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码或多个代码组成的列表 |
| fields | list[str] | 否 | 需查询的估值指标字段列表,不填则返回所有支持的估值指标 |
| date | 多种类型 | 否 | 查询日期,支持datetime.date/datetime.datetime/yyyy-mm-dd/yyyy-mm-dd hh: mm: ss/时间戳,自动截取到日期维度;默认使用回测当前时间 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有估值指标字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- date:查询日期,datetime.date类型
完整示例
python
# 示例1:查询2024-04-24平安银行的总市值、市盈率ttm、市净率ttm、股息率ttm
df = get_valuation_indicators(
security='sz000001',
fields=['market_cap', 'pe_ratio_ttm', 'pb_ratio_ttm', 'dy_ttm'],
date='2024-04-24'
)
log.info(df) # 输出: security date market_cap pe_ratio_ttm pb_ratio_ttm dy_ttm
# 0 sz000001 2024-04-24 2.85629e+11 6.352148 0.628947 0.051236
# 示例2:查询2024-04-24多只股票的所有估值衍生指标
df = get_valuation_indicators(
security=['sz000001', 'sz000002'],
date='2024-04-24'
)
log.info(df) # 输出多只标的的所有估值指标,含security、date及所有估值字段列支持的估值指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| total_shares_cir | 流通股本 | 企业当前实际流通的股份总数 |
| total_shares | 总股本 | 企业发行的全部股份总数 |
| market_cap | 总市值 | 未复权收盘价 * 总股本 |
| market_cap_cir | 流通市值 | 未复权收盘价 * 流通股本 |
| turnover_ratio | 换手率 | 换手率=成交量/流通股本 |
| pe_ratio_lyr | 市盈率lyr | 总市值 / 归属母公司净利润lyr |
| pe_ratio_ttm | 市盈率ttm | 总市值 / 归属母公司净利润ttm |
| ep_ratio_lyr | 盈市率lyr | 归属母公司净利润lyr / 总市值 |
| ep_ratio_ttm | 盈市率ttm | 归属母公司净利润ttm/ 总市值 |
| pcf_ratio_total_lyr | 市现率_总现金流lyr | 总市值 /(经营活动产生的现金流量净额lyr + 投资活动产生的现金流量净额lyr + 筹资活动产生的现金流量净额lyr) |
| pcf_ratio_total_ttm | 市现率_总现金流ttm | 总市值 /(经营活动产生的现金流量净额ttm + 投资活动产生的现金流量净额ttm + 筹资活动产生的现金流量净额ttm) |
| pcf_ratio_lyr | 市现率_经营lyr | 总市值 / 经营活动产生的现金流量净额lyr |
| pcf_ratio_ttm | 市现率_经营 ttm | 总市值 / 经营活动产生的现金流量净额ttm |
| cfp_ratio_lyr | 现金收益率lyr | 现金收益率 =(经营活动产生的现金流量净额lyr + 投资活动产生的现金流量净额lyr + 筹资活动产生的现金流量净额lyr)/ 总市值 |
| cfp_ratio_ttm | 现金收益率ttm | 现金收益率 = (经营活动产生的现金流量净额ttm + 投资活动产生的现金流量净额ttm + 筹资活动产生的现金流量净额ttm)/ 总市值 |
| pb_ratio_lyr | 市净率lyr | 总市值 / 归属母公司股东权益合计lyr |
| pb_ratio_ttm | 市净率ttm | 总市值 / 归属母公司股东权益合计ttm |
| book_to_market_ratio_lyr | 账面市值比lyr | 归属母公司股东权益合计lyr / 总市值 |
| book_to_market_ratio_ttm | 账面市值比 ttm | 归属母公司股东权益合计ttm / 总市值 |
| dy_ttm | 股息率ttm | 最近4个季度(或12个月)报表公布股利之和 / 当前股票总市值 |
| dy_lfy | 股息率lfy | 上一财年报表公布股利之和/当前股票总市值 |
| ps_ratio_lyr | 市销率lyr | 总市值 / 营业总收入lyr |
| ps_ratio_ttm | 市销率ttm | 总市值 / 营业总收入ttm |
| sp_ratio_lyr | 销售收益率lyr | 营业总收入lyr / 总市值 |
| sp_ratio_ttm | 销售收益率ttm | 营业总收入ttm / 总市值 |
| ev_lyr | 企业价值lyr | 总市值 + 负债合计lyr |
| ev_ttm | 企业价值ttm | 总市值 + 负债合计ttm |
| ev_no_cash_lyr | 企业价值(不含货币资金)lyr | 总市值 + 负债合计lyr - 货币资金lyr |
| ev_no_cash_ttm | 企业价值(不含货币资金)ttm | 总市值 + 负债合计ttm - 货币资金ttm |
获取点时间经营衍生指标
get_efficiency_indicators-获取点时间经营衍生指标
查询指定时间点,股票所属上市公司的经营衍生指标数据,涵盖盈利、营运、偿债等维度的衍生分析指标,支持单/多标的查询。
函数原型
python
get_efficiency_indicators(security, fields=None, date=None)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码或多个代码组成的列表 |
| fields | list[str] | 否 | 需查询的经营衍生指标字段列表,不填则返回所有支持的经营衍生指标 |
| date | 多种类型 | 否 | 查询日期,支持日期类型或字符串格式如2025-01-01或时间戳,自动截取到日期维度;默认使用回测当前时间 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有经营衍生指标字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- date:查询日期,日期类型
完整示例
python
# 示例1:查询2024-04-24平安银行的摊薄每股收益ttm、净资产收益率ttm、总资产周转率ttm
df = get_efficiency_indicators(
security='sz000001',
fields=['diluted_earnings_per_share_ttm', 'return_on_equity_ttm', 'total_asset_turnover_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date diluted_earnings_per_share_ttm return_on_equity_ttm total_asset_turnover_ttm
# 0 sz000001 2024-04-24 1.623578 0.092541 0.031257
# 示例2:查询2024-04-24多只股票的利息保障倍数ttm、现金转换周期ttm
df = get_efficiency_indicators(
security=['sz000001', 'sh600000'],
fields=['time_interest_earned_ratio_ttm', 'cash_conversion_cycle_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:多只标的的指定经营衍生指标,含security、date及查询字段列支持的经营衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| diluted_earnings_per_share_lyr | 摊薄每股收益lyr | 归属母公司净利润lyr / 该报告期末普通股总股本 |
| diluted_earnings_per_share_ttm | 摊薄每股收益ttm | 归属母公司净利润ttm / 该报告期末普通股总股本 |
| weighted_common_stock_lyr | 普通股加权股本lyr | 归属于母公司所有者的净利润lyr / 基本每股收益lyr |
| diluted_common_stock_lyr | 稀释普通股lyr | 归属于母公司所有者的净利润lyr / 稀释每股收益lyr |
| operating_total_revenue_per_share_lyr | 每股营业总收入lyr | 营业总收入lyr / 总股本 |
| operating_total_revenue_per_share_ttm | 每股营业总收入ttm | 营业总收入ttm / 总股本 |
| operating_revenue_per_share_lyr | 每股营业收入lyr | 营业收入lyr / 总股本 |
| operating_revenue_per_share_ttm | 每股营业收入ttm | 营业收入ttm / 总股本 |
| ebit_lyr | 息税前利润lyr | 利润总额lyr + 利息支出lyr - 利息收入lyr |
| ebit_ttm | 息税前利润ttm | 利润总额ttm + 利息支出ttm - 利息收入ttm |
| ebitda_lyr | 息税折旧摊销前利润lyr | 息税前利润lyr + 固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr |
| ebitda_ttm | 息税折旧摊销前利润 ttm | 息税前利润ttm + 固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm |
| ebit_per_share_lyr | 每股息税前利润lyr | 息税前利润lyr / 总股本 |
| ebit_per_share_ttm | 每股息税前利润ttm | 息税前利润ttm / 总股本 |
| return_on_equity_lyr | 净资产收益率lyr | 归属母公司净利润lyr * 2 /(母公司股东权益合计lyr + 上期报表披露归属母公司股东权益合计lyr) |
| return_on_equity_ttm | 净资产收益率ttm | 归属母公司净利润ttm * 2 / (母公司股东权益合计ttm + 上期报表披露归属母公司的股东权益合计ttm) |
| return_on_equity_diluted_lyr | 摊薄净资产收益率lyr | 归属母公司净利润lyr / 归属母公司股东权益合计lyr |
| return_on_equity_diluted_ttm | 摊薄净资产收益率ttm | 归属母公司净利润ttm / 归属母公司股东权益合计ttm |
| return_on_asset_lyr | 总资产报酬率lyr | 息税前利润lyr / 总资产lyr |
| return_on_asset_ttm | 总资产报酬率ttm | 息税前利润ttm/总资产ttm |
| return_on_asset_net_profit_lyr | 总资产净利率lyr | 净利润lyr / 总资产lyr |
| return_on_asset_net_profit_ttm | 总资产净利率ttm | 净利润ttm / 总资产ttm |
| return_on_invested_capital_lyr | 投入资本回报率lyr | (净利润lyr + 财务费用lyr)/(资产总计lyr - 流动负债lyr + 应付票据lyr + 短期借款lyr + 一年内到期的非流动负债lyr) |
| return_on_invested_capital_ttm | 投入资本回报率ttm | (净利润ttm + 财务费用ttm)/(资产总计ttm - 流动负债ttm + 应付票据ttm + 短期借款ttm + 一年内到期的非流动负债ttm) |
| net_profit_margin_lyr | 销售净利率lyr | 净利润lyr / 营业收入lyr |
| net_profit_margin_ttm | 销售净利率ttm | 净利润ttm / 营业收入ttm |
| gross_profit_margin_lyr | 销售毛利率lyr | (营业收入lyr - 营业成本lyr)/ 营业收入lyr |
| gross_profit_margin_ttm | 销售毛利率ttm | (营业收入ttm - 营业成本ttm)/ 营业收入ttm |
| cost_to_sales_lyr | 销售成本率lyr | 营业成本lyr / 营业收入lyr |
| cost_to_sales_ttm | 销售成本率ttm | 营业成本ttm / 营业收入ttm |
| net_profit_to_revenue_lyr | 经营净利率lyr | 净利润lyr / 营业总收入lyr |
| net_profit_to_revenue_ttm | 经营净利率ttm | 净利润ttm / 营业总收入ttm |
| profit_from_operation_to_revenue_lyr | 营业利润率lyr | 营业利润lyr / 营业总收入lyr |
| profit_from_operation_to_revenue_ttm | 营业利润率ttm | 营业利润ttm / 营业总收入ttm |
| ebit_to_revenue_lyr | 税前收益率lyr | 息税前利润lyr / 营业总收入lyr |
| ebit_to_revenue_ttm | 税前收益率ttm | 息税前利润ttm / 营业总收入ttm |
| expense_to_revenue_lyr | 经营成本率lyr | 营业总成本lyr / 营业总收入lyr |
| expense_to_revenue_ttm | 经营成本率ttm | 营业总成本ttm / 营业总收入ttm |
| operating_profit_to_profit_before_tax_lyr | 经营活动净收益与利润总额之比lyr | (营业总收入lyr-营业总成本lyr) / 利润总额lyr |
| operating_profit_to_profit_before_tax_ttm | 经营活动净收益与利润总额之比ttm | (营业总收入ttm-营业总成本ttm) / 利润总额ttm |
| non_operating_profit_to_profit_before_tax_lyr | 营业外收支净额与利润总额之比lyr | 营业外收支净额lyr/利润总额lyr |
| non_operating_profit_to_profit_before_tax_ttm | 营业外收支净额与利润总额之比ttm | 营业外收支净额ttm/利润总额ttm |
| income_tax_to_profit_before_tax_lyr | 所得税与利润总额之比lyr | 所得税lyr / 利润总额lyr |
| income_tax_to_profit_before_tax_ttm | 所得税与利润总额之比ttm | 所得税ttm / 利润总额ttm |
| ebitda_to_debt_lyr | 息税折旧摊销前利润/负债总计lyr | 息税折旧摊销前利润lyr / 负债总计lyr |
| ebitda_to_debt_ttm | 息税折旧摊销前利润/负债总计ttm | 息税折旧摊销前利润ttm / 负债总计ttm |
| account_payable_turnover_rate_lyr | 应付账款周转率lyr | 营业成本lyr / 应付账款lyr |
| account_payable_turnover_rate_ttm | 应付账款周转率ttm | 营业成本ttm / 应付账款ttm |
| account_payable_turnover_days_lyr | 应付账款周转天数lyr | 360 / 应付账款周转率lyr |
| account_payable_turnover_days_ttm | 应付账款周转天数ttm | 360 / 应付账款周转率ttm |
| account_receivable_turnover_rate_lyr | 应收账款周转率lyr | 营业收入lyr / 应收账款lyr |
| account_receivable_turnover_rate_ttm | 应收账款周转率ttm | 营业收入ttm / 应收账款ttm |
| account_receivable_turnover_days_lyr | 应收账款周转天数lyr | 360 / 应收账款周转率lyr |
| account_receivable_turnover_days_ttm | 应收账款周转天数ttm | 360 / 应收账款周转率ttm |
| inventory_turnover_lyr | 存货周转率lyr | 营业成本lyr / 存货lyr |
| inventory_turnover_ttm | 存货周转率ttm | 营业成本ttm / 存货ttm |
| current_asset_turnover_lyr | 流动资产周转率lyr | 营业收入lyr /资产总计lyr |
| current_asset_turnover_ttm | 流动资产周转率ttm | 营业收入ttm / 资产总计ttm |
| fixed_asset_turnover_lyr | 固定资产周转率lyr | 营业收入lyr /固定资产总计lyr |
| fixed_asset_turnover_ttm | 固定资产周转率ttm | 营业收入ttm / 固定资产总计ttm |
| total_asset_turnover_lyr | 总资产周转率lyr | 营业收入lyr /总资产lyr |
| total_asset_turnover_ttm | 总资产周转率ttm | 营业收入ttm /总资产ttm |
| du_profit_margin_lyr | 净利率(杜邦分析)lyr | 净利润lyr / 利润总额lyr |
| du_profit_margin_ttm | 净利率(杜邦分析)ttm | 净利润ttm / 利润总额ttm |
| du_return_on_equity_lyr | 净资产收益率ROE(杜邦分析)lyr | 净利率(杜邦分析)lyr * 总资产周转率lyr * 权益乘数(杜邦分析)lyr |
| du_return_on_equity_ttm | 净资产收益率ROE(杜邦分析)ttm | 净利率(杜邦分析)ttm * 总资产周转率ttm * 权益乘数(杜邦分析)ttm |
| du_return_on_sales_lyr | 息税前利润/营业总收入lyr | 息税前利润lyr / 营业总收入lyr |
| du_return_on_sales_ttm | 息税前利润/营业总收入ttm | 息税前利润ttm / 营业总收入ttm |
| income_from_main_operations_lyr | 主营业务利润lyr | 营业收入lyr - 营业成本lyr - 营业税金及附加lyr |
| income_from_main_operations_ttm | 主营业务利润ttm | 营业收入ttm - 营业成本ttm - 营业税金及附加ttm |
| time_interest_earned_ratio_lyr | 利息保障倍数lyr | 息税前利润lyr / (利息支出(财务费用)lyr - 利息收入(财务费用)lyr) |
| time_interest_earned_ratio_ttm | 利息保障倍数ttm | 息税前利润ttm / (利息支出(财务费用)ttm - 利息收入(财务费用)ttm) |
| equity_turnover_ratio_lyr | 股东权益周转率lyr | 营业收入lyr / 归属母公司股东权益合计lyr |
| equity_turnover_ratio_ttm | 股东权益周转率ttm | 营业收入ttm / 归属母公司股东权益合计ttm |
| operating_cycle_lyr | 营业周期lyr | 应收账款周转天数lyr + 存货周转天数lyr |
| operating_cycle_ttm | 营业周期ttm | 应收账款周转天数ttm + 存货周转天数ttm |
| average_payment_period_lyr | 应付账款付款期lyr | 应付账款lyr / 营业成本lyr / 360 |
| average_payment_period_ttm | 应付账款付款期ttm | 应付账款ttm / 营业成本ttm / 360 |
| cash_conversion_cycle_lyr | 现金转换周期lyr | 营业周期lyr - 应付账款付款期lyr |
| cash_conversion_cycle_ttm | 现金转换周期ttm | 营业周期ttm - 应付账款付款期ttm |
获取点时间现金流衍生指标
get_cash_flow_indicators-获取点时间现金流衍生指标
查询指定日期,股票所属上市公司的现金流衍生指标数据。
函数原型
python
get_cash_flow_indicators(security, fields=None, date=None)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sz000001)或多个代码组成的列表(如['sz000001', 'sz000002']) |
| fields | list[str] | 否 | 需查询的现金流衍生指标字段列表,不填则返回所有支持的现金流衍生指标 |
| date | 多种类型 | 否 | 查询日期,支持日期类型或字符串格式如2025-01-01或时间戳,自动截取到日期维度;默认使用回测当前时间 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有现金流衍生指标字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- date:查询日期,日期类型
完整示例
python
# 示例1:查询2024-04-24平安银行的每股经营现金流ttm、盈余现金保障倍数ttm
df = get_cash_flow_indicators(
security='sz000001',
fields=['operating_cash_flow_per_share_ttm', 'surplus_cash_protection_multiples_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date operating_cash_flow_per_share_ttm surplus_cash_protection_multiples_ttm
# 0 sz000001 2024-04-24 2.856789 125.67
# 示例2:查询2024-04-24多只股票的企业自由现金流量ttm、每股股东自由现金流ttm
df = get_cash_flow_indicators(
security=['sz000001', 'sz000002'],
fields=['fcff_ttm', 'free_cash_flow_equity_per_share_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date fcff_ttm free_cash_flow_equity_per_share_ttm
# 0 sz000001 2024-04-24 125689000000.0 1.9876
# 1 sz000002 2024-04-24 289765000000.0 3.2541支持的现金流衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| 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 |
获取点时间财务衍生指标
get_asset_indicators-获取点时间财务衍生指标
查询指定日期,股票所属上市公司的财务衍生指标数据。
函数原型
python
get_asset_indicators(security, fields=None, date=None)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sz000001)或多个代码组成的列表(如['sz000001', 'sz000002']) |
| fields | list[str] | 否 | 需查询的财务衍生指标字段列表,不填则返回所有支持的财务衍生指标 |
| date | 多种类型 | 否 | 查询日期,支持日期类型或字符串格式如2025-01-01或时间戳,自动截取到日期维度;默认使用回测当前时间 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有财务衍生指标字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- date:查询日期,日期类型
完整示例
python
# 示例1:查询2024-04-24平安银行的资产负债率ttm、流动比率ttm
df = get_asset_indicators(
security='sz000001',
fields=['debt_to_asset_ratio_ttm', 'current_ratio_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date debt_to_asset_ratio_ttm current_ratio_ttm
# 0 sz000001 2024-04-24 0.9256 1.3589
# 示例2:查询2024-04-24多只股票的每股净资产ttm、权益乘数ttm
df = get_asset_indicators(
security=['sz000001', 'sz000002'],
fields=['book_value_per_share_ttm', 'equity_multiplier_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date book_value_per_share_ttm equity_multiplier_ttm
# 0 sz000001 2024-04-24 18.765 12.89
# 1 sz000002 2024-04-24 9.234 3.56支持的财务衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| non_interest_bearing_current_debt_lyr | 无息流动负债lyr | 应付帐款lyr + 预收帐款lyr + 应付职工薪酬lyr + 应交税费lyr + 其他应付款lyr + 预提费用lyr + 递延收益lyr + 其他流动负债lyr |
| non_interest_bearing_current_debt_ttm | 无息流动负债ttm | 应付帐款ttm + 预收帐款ttm + 应付职工薪酬ttm + 应交税费ttm + 其他应付款ttm + 预提费用ttm + 递延收益ttm + 其他流动负债ttm |
| non_interest_bearing_non_current_debt_lyr | 无息非流动负债lyr | 非流动负债合计lyr - 长期借款lyr - 应付债券lyr |
| non_interest_bearing_non_current_debt_ttm | 无息非流动负债ttm | 非流动负债合计ttm - 长期借款ttm - 应付债券ttm |
| interest_bearing_debt_lyr | 带息债务lyr | 负债合计lyr - 无息流动负债lyr - 无息非流动负债lyr |
| interest_bearing_debt_ttm | 带息债务ttm | 负债合计ttm - 无息流动负债ttm - 无息非流动负债ttm |
| capital_reserve_per_share_lyr | 每股资本公积金lyr | 资本公积金lyr / 总股本 |
| capital_reserve_per_share_ttm | 每股资本公积金ttm | 资本公积金ttm / 总股本 |
| earned_reserve_per_share_lyr | 每股盈余公积金lyr | 盈余公积金lyr / 总股本 |
| earned_reserve_per_share_ttm | 每股盈余公积金ttm | 盈余公积金ttm / 总股本 |
| undistributed_profit_per_share_lyr | 每股未分配利润lyr | 未分配利润总额lyr / 总股本 |
| undistributed_profit_per_share_ttm | 每股未分配利润ttm | 未分配利润总额ttm / 总股本 |
| retained_earnings_lyr | 留存收益 lyr | 盈余公积金lyr + 未分配利润lyr |
| retained_earnings_ttm | 留存收益ttm | 盈余公积金ttm + 未分配利润ttm |
| debt_to_asset_ratio_lyr | 资产负债率lyr | 负债合计lyr / 总资产 |
| debt_to_asset_ratio_ttm | 资产负债率ttm | 负债合计ttm / 总资产 |
| equity_multiplier_lyr | 权益乘数lyr | 总资产lyr / 股东权益合计lyr |
| equity_multiplier_ttm | 权益乘数ttm | 总资产ttm / 股东权益合计ttm |
| capital_to_equity_ratio_lyr | 长期资本固定比率lyr | (资产总计lyr-流动资产lyr)/所有者权益平均余额lyr×100% |
| capital_to_equity_ratio_ttm | 长期资本固定比率ttm | (资产总计ttm-流动资产ttm)/所有者权益平均余额ttm×100% |
| non_current_asset_to_total_asset_lyr | 非流动资产比率lyr | 非流动资产合计lyr / 总资产lyr |
| non_current_asset_to_total_asset_ttm | 非流动资产比率ttm | 非流动资产合计ttm / 总资产ttm |
| invested_capital_lyr | 全部投入资本lyr | 归属于母公司所有者权益合计lyr + 带息债务lyr |
| invested_capital_ttm | 全部投入资本ttm | 归属于母公司所有者权益合计ttm + 带息债务ttm |
| interest_bearing_debt_to_capital_lyr | 带息债务占企业全部投入成本的比重lyr | 带息债务lyr / 全部投入资本lyr |
| interest_bearing_debt_to_capital_ttm | 带息债务占企业全部投入成本的比重ttm | 带息债务ttm / 全部投入资本ttm |
| current_debt_to_total_debt_lyr | 流动负债率lyr | 流动负债合计lyr / 负债合计lyr |
| current_debt_to_total_debt_ttm | 流动负债率ttm | 流动负债合计ttm / 负债合计ttm |
| non_current_debt_to_total_debt_lyr | 非流动负债率lyr | 非流动负债合计lyr / 负债合计lyr |
| non_current_debt_to_total_debt_ttm | 非流动负债率ttm | 非流动负债合计ttm / 负债合计ttm |
| current_ratio_lyr | 流动比率lyr | 流动资产合计lyr / 流动负债合计lyr |
| current_ratio_ttm | 流动比率ttm | 流动资产合计ttm / 流动负债合计ttm |
| super_quick_ratio_lyr | 超速动比率lyr | (货币资金lyr + 交易性金融资产lyr + 应收票据lyr + 应收账款lyr + 其他应收款lyr)/ 流动负债合计lyr |
| super_quick_ratio_ttm | 超速动比率ttm | (货币资金ttm + 交易性金融资产ttm + 应收票据ttm + 应收账款ttm + 其他应收款ttm)/ 流动负债合计ttm |
| debt_to_equity_ratio_lyr | 产权比率lyr | 负债合计lyr / 股东权益合计lyr |
| debt_to_equity_ratio_ttm | 产权比率ttm | 负债合计ttm / 股东权益合计ttm |
| equity_to_debt_ratio_lyr | 权益负债比率lyr | 归属于母公司所有者权益合计lyr / 负债合计lyr |
| equity_to_debt_ratio_ttm | 权益负债比率ttm | 归属于母公司所有者权益合计ttm / 负债合计ttm |
| equity_to_interest_bearing_debt_lyr | 权益带息负债比率 lyr | 归属于母公司所有者权益合计lyr / 带息债务lyr |
| equity_to_interest_bearing_debt_ttm | 权益带息负债比率 ttm | 归属于母公司所有者权益合计ttm / 带息债务ttm |
| net_debt_lyr | 净债务lyr | 带息债务lyr - 货币资金lyr |
| net_debt_ttm | 净债务ttm | 带息债务ttm - 货币资金ttm |
| working_capital_lyr | 营运资本lyr | 流动资产合计lyr - 流动负债合计lyr |
| working_capital_ttm | 营运资本ttm | 流动资产合计ttm - 流动负债合计ttm |
| net_working_capital_lyr | 净营运资本lyr | 流动资产合计lyr - 货币资金lyr - 无息流动负债lyr |
| net_working_capital_ttm | 净营运资本ttm | 流动资产合计ttm - 货币资金ttm - 无息流动负债ttm |
| long_term_debt_to_working_capital_lyr | 长期债务与营运资金比率lyr | 非流动负债lyr/营运资本lyr |
| long_term_debt_to_working_capital_ttm | 长期债务与营运资金比率ttm | 非流动负债ttm/营运资本ttm |
| book_value_per_share_lyr | 每股净资产lyr | 归属母公司股东权益合计lyr / 总股本 |
| book_value_per_share_ttm | 每股净资产ttm | 归属母公司股东权益合计ttm / 总股本 |
| du_equity_multiplier_lyr | 权益乘数(杜邦分析)lyr | (本期总资产lyr + 上年总资产lyr)/ (本期股东权益合计lyr + 上年股东权益合计lyr) |
| du_equity_multiplier_ttm | 权益乘数(杜邦分析)ttm | (本期总资产ttm + 上期总资产ttm)/ (本期股东权益合计ttm + 上期股东权益合计ttm) |
| book_leverage_lyr | 账面杠杆lyr | 非流动负债合计lyr / 归母公司股东权益合计lyr |
| book_leverage_ttm | 账面杠杆ttm | 非流动负债合计ttm / 归母公司股东权益合计ttm |
| market_leverage_lyr | 市场杠杆lyr | 非流动负债合计lyr / (非流动负债合计lyr + 总市值) |
| market_leverage_ttm | 市场杠杆ttm | 非流动负债合计ttm / (非流动负债合计ttm + 总市值) |
| equity_ratio_lyr | 股东权益比率lyr | 归属母公司股东权益总计lyr / 资产总计lyr |
| equity_ratio_ttm | 股东权益比率ttm | 归属母公司股东权益总计ttm / 资产总计ttm |
| fixed_asset_ratio_lyr | 固定资产比率lyr | (固定资产lyr + 工程物资lyr + 在建工程合计lyr) / 资产总计lyr |
| fixed_asset_ratio_ttm | 固定资产比率ttm | (固定资产ttm + 工程物资ttm + 在建工程合计ttm) / 资产总计ttm |
| intangible_asset_ratio_lyr | 无形资产比率lyr | (无形资产lyr + 开发支出lyr + 商誉lyr) / 资产总计lyr |
| intangible_asset_ratio_ttm | 无形资产比率ttm | (无形资产ttm + 开发支出ttm + 商誉ttm) / 资产总计ttm |
| equity_fixed_asset_ratio_lyr | 股东权益与固定资产比率lyr | 归属母公司股东权益合计lyr / (固定资产合计lyr + 工程物资lyr + 在建工程合计lyr) |
| equity_fixed_asset_ratio_ttm | 股东权益与固定资产比率ttm | 归属母公司股东权益合计ttm / (固定资产合计ttm + 工程物资ttm + 在建工程合计ttm) |
| tangible_asset_per_share_lyr | 每股有形资产lyr | (资产总计lyr - 无形资产lyr - 商誉lyr)/ 总股本 |
| tangible_asset_per_share_ttm | 每股有形资产ttm | (资产总计ttm - 无形资产ttm - 商誉ttm)/ 总股本 |
| liabilities_per_share_lyr | 每股负债lyr | 负债合计lyr / 总股本 |
| liabilities_per_share_ttm | 每股负债ttm | 负债合计ttm / 总股本 |
| depreciation_per_share_lyr | 每股折旧和摊销lyr | (固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr)/ 总股本 |
| depreciation_per_share_ttm | 每股折旧和摊销ttm | (固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm)/ 总股本 |
| cash_ratio_lyr | 现金比率lyr | 货币资金lyr / 流动负债合计lyr |
| cash_ratio_ttm | 现金比率ttm | 货币资金ttm / 流动负债合计ttm |
| cash_equivalent_per_share_lyr | 每股货币资金lyr | 货币资金lyr / 总股本 |
| cash_equivalent_per_share_ttm | 每股货币资金ttm | 货币资金ttm / 总股本 |
获取点时间增长衍生指标
get_growth_indicators-获取点时间增长衍生指标
查询指定日期,股票所属上市公司的增长衍生指标数据。
函数原型
python
get_growth_indicators(security, fields=None, date=None)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sz000001)或多个代码组成的列表(如['sz000001', 'sz000002']) |
| fields | list[str] | 否 | 需查询的增长衍生指标字段列表,不填则返回所有支持的增长衍生指标 |
| date | 多种类型 | 否 | 查询日期,支持日期类型或字符串格式如2025-01-01或时间戳,自动截取到日期维度;默认使用回测当前时间 |
返回值说明
返回一个DataFrame,索引为自增序号,包含基础列及查询的所有增长衍生指标字段列;无匹配数据时返回空DataFrame。 基础固定列:
- security:标的代码,字符串类型
- date:查询日期,日期类型
完整示例
python
# 示例1:查询2024-04-24平安银行的营业总收入同比增长率ttm、净利润同比增长率ttm
df = get_growth_indicators(
security='sz000001',
fields=['inc_revenue_ttm', 'net_profit_growth_ratio_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date inc_revenue_ttm net_profit_growth_ratio_ttm
# 0 sz000001 2024-04-24 0.0876 0.1258
# 示例2:查询2024-04-24多只股票的净资产同比增长率ttm、归属母公司净利润同比增长率ttm
df = get_growth_indicators(
security=['sz000001', 'sz000002'],
fields=['net_asset_growth_ratio_ttm', 'net_profit_parent_company_growth_ratio_ttm'],
date='2024-04-24'
)
log.info(df)
# 输出:
# security date net_asset_growth_ratio_ttm net_profit_parent_company_growth_ratio_ttm
# 0 sz000001 2024-04-24 0.0923 0.1189
# 1 sz000002 2024-04-24 0.0756 0.0945支持的增长衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| inc_revenue_lyr | 营业总收入同比增长率lyr | 营业总收入lyr / 上年营业总收入lyr - 1 |
| inc_revenue_ttm | 营业总收入同比增长率ttm | 营业总收入ttm / 上年营业总收入ttm - 1 |
| inc_return_on_equity_lyr | 净资产收益率(摊薄)同比增长率lyr | 摊薄净资产收益率lyr / 去年摊薄净资产收益率lyr - 1 |
| inc_return_on_equity_ttm | 净资产收益率(摊薄)同比增长率ttm | 摊薄净资产收益率ttm / 去年摊薄净资产收益率ttm - 1 |
| inc_book_per_share_lyr | 每股净资产同比增长率lyr | 每股净资产lyr / 去年每股净资产lyr - 1 |
| inc_book_per_share_ttm | 每股净资产同比增长率ttm | 每股净资产ttm / 去年每股净资产ttm - 1 |
| operating_profit_growth_ratio_lyr | 营业利润同比增长率lyr | (营业利润lyr - 去年营业利润lyr) / 去年营业利润lyr |
| operating_profit_growth_ratio_ttm | 营业利润同比增长率ttm | (营业利润ttm - 去年营业利润ttm) / 去年营业利润ttm |
| net_profit_growth_ratio_lyr | 净利润同比增长率lyr | (净利润lyr - 去年净利润lyr) / 去年净利润lyr |
| net_profit_growth_ratio_ttm | 净利润同比增长率ttm | (净利润ttm - 去年净利润ttm) / 去年净利润ttm |
| profit_growth_ratio_lyr | 利润总额同比增长率lyr | (利润总额lyr - 去年利润总额lyr) / 去年利润总额lyr |
| profit_growth_ratio_ttm | 利润总额同比增长率ttm | (利润总额ttm - 去年利润总额ttm) / 去年利润总额ttm |
| gross_profit_growth_ratio_lyr | 毛利润同比增长率lyr | (营业收入lyr - 营业总成本lyr) / (去年营业收入lyr - 去年营业总成本lyr) - 1 |
| gross_profit_growth_ratio_ttm | 毛利润同比增长率ttm | (营业收入ttm - 营业成本ttm) / (去年营业收入ttm - 去年营业成本ttm) - 1 |
| operating_revenue_growth_ratio_lyr | 营业收入同比增长率lyr | (营业收入lyr - 去年营业收入lyr) / 去年营业收入lyr |
| operating_revenue_growth_ratio_ttm | 营业收入同比增长率ttm | (营业收入ttm - 去年营业收入ttm) / 去年营业收入ttm |
| net_asset_growth_ratio_lyr | 净资产同比增长率lyr | 归属于母公司所有者权益合计lyr / 去年归属于母公司所有者权益合计lyr - 1 |
| net_asset_growth_ratio_ttm | 净资产同比增长率ttm | 归属于母公司所有者权益合计ttm / 去年归属于母公司所有者权益合计ttm - 1 |
| total_asset_growth_ratio_lyr | 总资产同比增长率lyr | (总资产lyr - 去年总资产lyr) / 去年总资产lyr |
| total_asset_growth_ratio_ttm | 总资产同比增长率ttm | (总资产ttm - 去年总资产ttm) / 去年总资产ttm |
| net_profit_parent_company_growth_ratio_lyr | 归属母公司所有者的净利润同比增长率lyr | 归属于母公司所有者的净利润lyr / 去年归属于母公司所有者的净利润lyr - 1 |
| net_profit_parent_company_growth_ratio_ttm | 归属母公司所有者的净利润同比增长率ttm | 归属于母公司所有者的净利润ttm / 去年归属于母公司所有者的净利润ttm - 1 |
| net_operate_cash_flow_growth_ratio_lyr | 经营现金流量净额同比增长率lyr | 经营活动产生的现金流量净额lyr / 去年经营活动产生的现金流量净额lyr - 1 |
| net_operate_cash_flow_growth_ratio_ttm | 经营现金流量净额同比增长率ttm | 经营活动产生的现金流量净额ttm / 去年经营活动产生的现金流量净额ttm - 1 |
| net_investing_cash_flow_growth_ratio_lyr | 投资现金流量净额同比增长率lyr | 投资活动产生的现金流量净额lyr / 去年投资活动产生的现金流量净额lyr - 1 |
| net_investing_cash_flow_growth_ratio_ttm | 投资现金流量净额同比增长率ttm | 投资活动产生的现金流量净额ttm / 去年投资活动产生的现金流量净额ttm - 1 |
| net_financing_cash_flow_growth_ratio_lyr | 筹资现金流量净额同比增长率lyr | 筹资活动产生的现金流量净额lyr / 去年筹资活动产生的现金流量净额lyr - 1 |
| net_financing_cash_flow_growth_ratio_ttm | 筹资现金流量净额同比增长率ttm | 筹资活动产生的现金流量净额ttm / 去年筹资活动产生的现金流量净额ttm - 1 |
获取时间范围的估值衍生指标
get_valuation_indicators_seq-获取时间范围的估值衍生指标
查询指定日期范围,股票所属上市公司的估值衍生指标数据。
函数原型
python
get_valuation_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
# 示例1:查询2024-04-01至2024-04-30平安银行的市盈率ttm、市净率ttm
df = get_valuation_indicators_seq(
security='sz000001',
fields=['pe_ratio_ttm', 'pb_ratio_ttm'],
start_date='2024-04-01',
end_date='2024-04-30'
)
log.info(df)
# 输出:
# security date pe_ratio_ttm pb_ratio_ttm
# 0 sz000001 2024-04-01 7.85 0.89
# 1 sz000001 2024-04-02 7.88 0.90
# ...
# 29 sz000001 2024-04-30 7.92 0.91
# 示例2:查询2024-04-01至2024-04-05平安银行和万科A的总市值、换手率
df = get_valuation_indicators_seq(
security=['sz000001', 'sz000002'],
fields=['market_cap', 'turnover_ratio'],
start_date='2024-04-01',
end_date='2024-04-05'
)
log.info(df)
# 输出:
# security date market_cap turnover_ratio
# 0 sz000001 2024-04-01 2850000000000 0.0125
# 1 sz000001 2024-04-02 2865000000000 0.0118
# 2 sz000002 2024-04-01 1800000000000 0.0089
# 3 sz000002 2024-04-02 1812000000000 0.0092
# 4 sz000001 2024-04-03 2870000000000 0.0105
# 5 sz000002 2024-04-03 1808000000000 0.0078
# ...支持的估值指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| total_shares_cir | 流通股本 | 上市公司已发行股份中在二级市场流通的股份数量 |
| total_shares | 总股本 | 上市公司发行的全部股份数量 |
| market_cap | 总市值 | 未复权收盘价 * 总股本 |
| market_cap_cir | 流通市值 | 未复权收盘价 * 流通股本 |
| turnover_ratio | 换手率 | 换手率=成交量/流通股本 |
| pe_ratio_lyr | 市盈率lyr | 总市值 / 归属母公司净利润lyr |
| pe_ratio_ttm | 市盈率ttm | 总市值 / 归属母公司净利润ttm |
| ep_ratio_lyr | 盈市率lyr | 归属母公司净利润lyr / 总市值 |
| ep_ratio_ttm | 盈市率ttm | 归属母公司净利润ttm/ 总市值 |
| pcf_ratio_total_lyr | 市现率_总现金流lyr | 总市值 /(经营活动产生的现金流量净额lyr + 投资活动产生的现金流量净额lyr + 筹资活动产生的现金流量净额lyr) |
| pcf_ratio_total_ttm | 市现率_总现金流ttm | 总市值 /(经营活动产生的现金流量净额ttm + 投资活动产生的现金流量净额ttm + 筹资活动产生的现金流量净额ttm) |
| pcf_ratio_lyr | 市现率_经营lyr | 总市值 / 经营活动产生的现金流量净额lyr |
| pcf_ratio_ttm | 市现率_经营 ttm | 总市值 / 经营活动产生的现金流量净额ttm |
| cfp_ratio_lyr | 现金收益率lyr | 现金收益率 =(经营活动产生的现金流量净额lyr + 投资活动产生的现金流量净额lyr + 筹资活动产生的现金流量净额lyr)/ 总市值 |
| cfp_ratio_ttm | 现金收益率ttm | 现金收益率 = (经营活动产生的现金流量净额ttm + 投资活动产生的现金流量净额ttm + 筹资活动产生的现金流量净额ttm)/ 总市值 |
| pb_ratio_lyr | 市净率lyr | 总市值 / 归属母公司股东权益合计lyr |
| pb_ratio_ttm | 市净率ttm | 总市值 / 归属母公司股东权益合计ttm |
| book_to_market_ratio_lyr | 账面市值比lyr | 归属母公司股东权益合计lyr / 总市值 |
| book_to_market_ratio_ttm | 账面市值比 ttm | 归属母公司股东权益合计ttm / 总市值 |
| dy_ttm | 股息率ttm | 最近4个季度(或12个月)报表公布股利之和 / 当前股票总市值 |
| dy_lfy | 股息率lfy | 上一财年报表公布股利之和/当前股票总市值 |
| ps_ratio_lyr | 市销率lyr | 总市值 / 营业总收入lyr |
| ps_ratio_ttm | 市销率ttm | 总市值 / 营业总收入ttm |
| sp_ratio_lyr | 销售收益率lyr | 营业总收入lyr / 总市值 |
| sp_ratio_ttm | 销售收益率ttm | 营业总收入ttm / 总市值 |
| ev_lyr | 企业价值lyr | 总市值 + 负债合计lyr |
| ev_ttm | 企业价值ttm | 总市值 + 负债合计ttm |
| ev_no_cash_lyr | 企业价值(不含货币资金)lyr | 总市值 + 负债合计lyr - 货币资金lyr |
| ev_no_cash_ttm | 企业价值(不含货币资金)ttm | 总市值 + 负债合计ttm - 货币资金ttm |
获取时间范围的经营衍生指标
get_efficiency_indicators_seq-获取时间范围的经营衍生指标
查询指定日期范围,股票所属上市公司的经营衍生指标数据。
函数原型
python
get_efficiency_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
# 示例1:查询2024-04-01至2024-04-30平安银行的净资产收益率ttm、销售毛利率ttm
df = get_efficiency_indicators_seq(
security='sz000001',
fields=['return_on_equity_ttm', 'gross_profit_margin_ttm'],
start_date='2024-04-01',
end_date='2024-04-30'
)
log.info(df)
# 输出:
# security date return_on_equity_ttm gross_profit_margin_ttm
# 0 sz000001 2024-04-01 0.1025 0.3568
# 1 sz000001 2024-04-02 0.1028 0.3572
# ...
# 29 sz000001 2024-04-30 0.1032 0.3581
# 示例2:查询2024-04-01至2024-04-05平安银行和万科A的摊薄每股收益ttm、总资产周转率ttm
df = get_efficiency_indicators_seq(
security=['sz000001', 'sz000002'],
fields=['diluted_earnings_per_share_ttm', 'total_asset_turnover_ttm'],
start_date='2024-04-01',
end_date='2024-04-05'
)
log.info(df)
# 输出:
# security date diluted_earnings_per_share_ttm total_asset_turnover_ttm
# 0 sz000001 2024-04-01 1.85 0.045
# 1 sz000001 2024-04-02 1.86 0.046
# 2 sz000002 2024-04-01 1.23 0.210
# 3 sz000002 2024-04-02 1.24 0.212
# 4 sz000001 2024-04-03 1.87 0.045
# 5 sz000002 2024-04-03 1.23 0.209
# ...支持的经营衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| diluted_earnings_per_share_lyr | 摊薄每股收益lyr | 归属母公司净利润lyr / 该报告期末普通股总股本 |
| diluted_earnings_per_share_ttm | 摊薄每股收益ttm | 归属母公司净利润ttm / 该报告期末普通股总股本 |
| weighted_common_stock_lyr | 普通股加权股本lyr | 归属于母公司所有者的净利润lyr / 基本每股收益lyr |
| diluted_common_stock_lyr | 稀释普通股lyr | 归属于母公司所有者的净利润lyr / 稀释每股收益lyr |
| operating_total_revenue_per_share_lyr | 每股营业总收入lyr | 营业总收入lyr / 总股本 |
| operating_total_revenue_per_share_ttm | 每股营业总收入ttm | 营业总收入ttm / 总股本 |
| operating_revenue_per_share_lyr | 每股营业收入lyr | 营业收入lyr / 总股本 |
| operating_revenue_per_share_ttm | 每股营业收入ttm | 营业收入ttm / 总股本 |
| ebit_lyr | 息税前利润lyr | 利润总额lyr + 利息支出lyr - 利息收入lyr |
| ebit_ttm | 息税前利润ttm | 利润总额ttm + 利息支出ttm - 利息收入ttm |
| ebitda_lyr | 息税折旧摊销前利润lyr | 息税前利润lyr + 固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr |
| ebitda_ttm | 息税折旧摊销前利润 ttm | 息税前利润ttm + 固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm |
| ebit_per_share_lyr | 每股息税前利润lyr | 息税前利润lyr / 总股本 |
| ebit_per_share_ttm | 每股息税前利润ttm | 息税前利润ttm / 总股本 |
| return_on_equity_lyr | 净资产收益率lyr | 归属母公司净利润lyr * 2 /(母公司股东权益合计lyr + 上期报表披露归属母公司股东权益合计lyr) |
| return_on_equity_ttm | 净资产收益率ttm | 归属母公司净利润ttm * 2 / (母公司股东权益合计ttm + 上期报表披露归属母公司的股东权益合计ttm) |
| return_on_equity_diluted_lyr | 摊薄净资产收益率lyr | 归属母公司净利润lyr / 归属母公司股东权益合计lyr |
| return_on_equity_diluted_ttm | 摊薄净资产收益率ttm | 归属母公司净利润ttm / 归属母公司股东权益合计ttm |
| return_on_asset_lyr | 总资产报酬率lyr | 息税前利润lyr / 总资产lyr |
| return_on_asset_ttm | 总资产报酬率ttm | 息税前利润ttm/总资产ttm |
| return_on_asset_net_profit_lyr | 总资产净利率lyr | 净利润lyr / 总资产lyr |
| return_on_asset_net_profit_ttm | 总资产净利率ttm | 净利润ttm / 总资产ttm |
| return_on_invested_capital_lyr | 投入资本回报率lyr | (净利润lyr + 财务费用lyr)/(资产总计lyr - 流动负债lyr + 应付票据lyr + 短期借款lyr + 一年内到期的非流动负债lyr) |
| return_on_invested_capital_ttm | 投入资本回报率ttm | (净利润ttm + 财务费用ttm)/(资产总计ttm - 流动负债ttm + 应付票据ttm + 短期借款ttm + 一年内到期的非流动负债ttm) |
| net_profit_margin_lyr | 销售净利率lyr | 净利润lyr / 营业收入lyr |
| net_profit_margin_ttm | 销售净利率ttm | 净利润ttm / 营业收入ttm |
| gross_profit_margin_lyr | 销售毛利率lyr | (营业收入lyr - 营业成本lyr)/ 营业收入lyr |
| gross_profit_margin_ttm | 销售毛利率ttm | (营业收入ttm - 营业成本ttm)/ 营业收入ttm |
| cost_to_sales_lyr | 销售成本率lyr | 营业成本lyr / 营业收入lyr |
| cost_to_sales_ttm | 销售成本率ttm | 营业成本ttm / 营业收入ttm |
| net_profit_to_revenue_lyr | 经营净利率lyr | 净利润lyr / 营业总收入lyr |
| net_profit_to_revenue_ttm | 经营净利率ttm | 净利润ttm / 营业总收入ttm |
| profit_from_operation_to_revenue_lyr | 营业利润率lyr | 营业利润lyr / 营业总收入lyr |
| profit_from_operation_to_revenue_ttm | 营业利润率ttm | 营业利润ttm / 营业总收入ttm |
| ebit_to_revenue_lyr | 税前收益率lyr | 息税前利润lyr / 营业总收入lyr |
| ebit_to_revenue_ttm | 税前收益率ttm | 息税前利润ttm / 营业总收入ttm |
| expense_to_revenue_lyr | 经营成本率lyr | 营业总成本lyr / 营业总收入lyr |
| expense_to_revenue_ttm | 经营成本率ttm | 营业总成本ttm / 营业总收入ttm |
| operating_profit_to_profit_before_tax_lyr | 经营活动净收益与利润总额之比lyr | (营业总收入lyr-营业总成本lyr) / 利润总额lyr |
| operating_profit_to_profit_before_tax_ttm | 经营活动净收益与利润总额之比ttm | (营业总收入ttm-营业总成本ttm) / 利润总额ttm |
| non_operating_profit_to_profit_before_tax_lyr | 营业外收支净额与利润总额之比lyr | 营业外收支净额lyr/利润总额lyr |
| non_operating_profit_to_profit_before_tax_ttm | 营业外收支净额与利润总额之比ttm | 营业外收支净额ttm/利润总额ttm |
| income_tax_to_profit_before_tax_lyr | 所得税与利润总额之比lyr | 所得税lyr / 利润总额lyr |
| income_tax_to_profit_before_tax_ttm | 所得税与利润总额之比ttm | 所得税ttm / 利润总额ttm |
| ebitda_to_debt_lyr | 息税折旧摊销前利润/负债总计lyr | 息税折旧摊销前利润lyr / 负债总计lyr |
| ebitda_to_debt_ttm | 息税折旧摊销前利润/负债总计ttm | 息税折旧摊销前利润ttm / 负债总计ttm |
| account_payable_turnover_rate_lyr | 应付账款周转率lyr | 营业成本lyr / 应付账款lyr |
| account_payable_turnover_rate_ttm | 应付账款周转率ttm | 营业成本ttm / 应付账款ttm |
| account_payable_turnover_days_lyr | 应付账款周转天数lyr | 360 / 应付账款周转率lyr |
| account_payable_turnover_days_ttm | 应付账款周转天数ttm | 360 / 应付账款周转率ttm |
| account_receivable_turnover_rate_lyr | 应收账款周转率lyr | 营业收入lyr / 应收账款lyr |
| account_receivable_turnover_rate_ttm | 应收账款周转率ttm | 营业收入ttm / 应收账款ttm |
| account_receivable_turnover_days_lyr | 应收账款周转天数lyr | 360 / 应收账款周转率lyr |
| account_receivable_turnover_days_ttm | 应收账款周转天数ttm | 360 / 应收账款周转率ttm |
| inventory_turnover_lyr | 存货周转率lyr | 营业成本lyr / 存货lyr |
| inventory_turnover_ttm | 存货周转率ttm | 营业成本ttm / 存货ttm |
| current_asset_turnover_lyr | 流动资产周转率lyr | 营业收入lyr /资产总计lyr |
| current_asset_turnover_ttm | 流动资产周转率ttm | 营业收入ttm / 资产总计ttm |
| fixed_asset_turnover_lyr | 固定资产周转率lyr | 营业收入lyr /固定资产总计lyr |
| fixed_asset_turnover_ttm | 固定资产周转率ttm | 营业收入ttm / 固定资产总计ttm |
| total_asset_turnover_lyr | 总资产周转率lyr | 营业收入lyr /总资产lyr |
| total_asset_turnover_ttm | 总资产周转率ttm | 营业收入ttm /总资产ttm |
| du_profit_margin_lyr | 净利率(杜邦分析)lyr | 净利润lyr / 利润总额lyr |
| du_profit_margin_ttm | 净利率(杜邦分析)ttm | 净利润ttm / 利润总额ttm |
| du_return_on_equity_lyr | 净资产收益率ROE(杜邦分析)lyr | 净利率(杜邦分析)lyr * 总资产周转率lyr * 权益乘数(杜邦分析)lyr |
| du_return_on_equity_ttm | 净资产收益率ROE(杜邦分析)ttm | 净利率(杜邦分析)ttm * 总资产周转率ttm * 权益乘数(杜邦分析)ttm |
| du_return_on_sales_lyr | 息税前利润/营业总收入lyr | 息税前利润lyr / 营业总收入lyr |
| du_return_on_sales_ttm | 息税前利润/营业总收入ttm | 息税前利润ttm / 营业总收入ttm |
| income_from_main_operations_lyr | 主营业务利润lyr | 营业收入lyr - 营业成本lyr - 营业税金及附加lyr |
| income_from_main_operations_ttm | 主营业务利润ttm | 营业收入ttm - 营业成本ttm - 营业税金及附加ttm |
| time_interest_earned_ratio_lyr | 利息保障倍数lyr | 息税前利润lyr / (利息支出(财务费用)lyr - 利息收入(财务费用)lyr) |
| time_interest_earned_ratio_ttm | 利息保障倍数ttm | 息税前利润ttm / (利息支出(财务费用)ttm - 利息收入(财务费用)ttm) |
| equity_turnover_ratio_lyr | 股东权益周转率lyr | 营业收入lyr / 归属母公司股东权益合计lyr |
| equity_turnover_ratio_ttm | 股东权益周转率ttm | 营业收入ttm / 归属母公司股东权益合计ttm |
| operating_cycle_lyr | 营业周期lyr | 应收账款周转天数lyr + 存货周转天数lyr |
| operating_cycle_ttm | 营业周期ttm | 应收账款周转天数ttm + 存货周转天数ttm |
| average_payment_period_lyr | 应付账款付款期lyr | 应付账款lyr / 营业成本lyr / 360 |
| average_payment_period_ttm | 应付账款付款期ttm | 应付账款ttm / 营业成本ttm / 360 |
| cash_conversion_cycle_lyr | 现金转换周期lyr | 营业周期lyr - 应付账款付款期lyr |
| cash_conversion_cycle_ttm | 现金转换周期ttm | 营业周期ttm - 应付账款付款期ttm |
获取时间范围的现金流衍生指标
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
# 示例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
# ...支持的现金流衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| 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 |
获取时间范围的财务衍生指标
get_asset_indicators_seq-获取时间范围的财务衍生指标
查询指定日期范围,股票所属上市公司的财务衍生指标数据。
函数原型
python
get_asset_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
# 示例1:查询2024-01-01至2024-01-10平安银行的流动比率ttm、资产负债率ttm
df = get_asset_indicators_seq(
security='sz000001',
fields=['current_ratio_ttm', 'debt_to_asset_ratio_ttm'],
start_date='2024-01-01',
end_date='2024-01-10'
)
log.info(df)
# 输出:
# security date current_ratio_ttm debt_to_asset_ratio_ttm
# 0 sz000001 2024-01-01 1.2587 0.9189
# 1 sz000001 2024-01-02 1.2592 0.9191
# 2 sz000001 2024-01-03 1.2605 0.9188
# ...
# 9 sz000001 2024-01-10 1.2631 0.9195
# 示例2:查询2024-03-01至2024-03-05平安银行和万科A的每股净资产ttm、现金比率ttm
df = get_asset_indicators_seq(
security=['sz000001', 'sz000002'],
fields=['book_value_per_share_ttm', 'cash_ratio_ttm'],
start_date='2024-03-01',
end_date='2024-03-05'
)
log.info(df)
# 输出:
# security date book_value_per_share_ttm cash_ratio_ttm
# 0 sz000001 2024-03-01 18.756 0.1895
# 1 sz000001 2024-03-02 18.768 0.1902
# 2 sz000002 2024-03-01 9.875 0.2568
# 3 sz000002 2024-03-02 9.881 0.2571
# 4 sz000001 2024-03-03 18.772 0.1908
# ...支持的财务衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| non_interest_bearing_current_debt_lyr | 无息流动负债lyr | 应付帐款lyr + 预收帐款lyr + 应付职工薪酬lyr + 应交税费lyr + 其他应付款lyr + 预提费用lyr + 递延收益lyr + 其他流动负债lyr |
| non_interest_bearing_current_debt_ttm | 无息流动负债ttm | 应付帐款ttm + 预收帐款ttm + 应付职工薪酬ttm + 应交税费ttm + 其他应付款ttm + 预提费用ttm + 递延收益ttm + 其他流动负债ttm |
| non_interest_bearing_non_current_debt_lyr | 无息非流动负债lyr | 非流动负债合计lyr - 长期借款lyr - 应付债券lyr |
| non_interest_bearing_non_current_debt_ttm | 无息非流动负债ttm | 非流动负债合计ttm - 长期借款ttm - 应付债券ttm |
| interest_bearing_debt_lyr | 带息债务lyr | 负债合计lyr - 无息流动负债lyr - 无息非流动负债lyr |
| interest_bearing_debt_ttm | 带息债务ttm | 负债合计ttm - 无息流动负债ttm - 无息非流动负债ttm |
| capital_reserve_per_share_lyr | 每股资本公积金lyr | 资本公积金lyr / 总股本 |
| capital_reserve_per_share_ttm | 每股资本公积金ttm | 资本公积金ttm / 总股本 |
| earned_reserve_per_share_lyr | 每股盈余公积金lyr | 盈余公积金lyr / 总股本 |
| earned_reserve_per_share_ttm | 每股盈余公积金ttm | 盈余公积金ttm / 总股本 |
| undistributed_profit_per_share_lyr | 每股未分配利润lyr | 未分配利润总额lyr / 总股本 |
| undistributed_profit_per_share_ttm | 每股未分配利润ttm | 未分配利润总额ttm / 总股本 |
| retained_earnings_lyr | 留存收益lyr | 盈余公积金lyr + 未分配利润lyr |
| retained_earnings_ttm | 留存收益ttm | 盈余公积金ttm + 未分配利润ttm |
| debt_to_asset_ratio_lyr | 资产负债率lyr | 负债合计lyr / 总资产 |
| debt_to_asset_ratio_ttm | 资产负债率ttm | 负债合计ttm / 总资产 |
| equity_multiplier_lyr | 权益乘数lyr | 总资产lyr / 股东权益合计lyr |
| equity_multiplier_ttm | 权益乘数ttm | 总资产ttm / 股东权益合计ttm |
| capital_to_equity_ratio_lyr | 长期资本固定比率lyr | (资产总计lyr-流动资产lyr)/所有者权益平均余额lyr×100% |
| capital_to_equity_ratio_ttm | 长期资本固定比率ttm | (资产总计ttm-流动资产ttm)/所有者权益平均余额ttm×100% |
| non_current_asset_to_total_asset_lyr | 非流动资产比率lyr | 非流动资产合计lyr / 总资产lyr |
| non_current_asset_to_total_asset_ttm | 非流动资产比率ttm | 非流动资产合计ttm / 总资产ttm |
| invested_capital_lyr | 全部投入资本lyr | 归属于母公司所有者权益合计lyr + 带息债务lyr |
| invested_capital_ttm | 全部投入资本ttm | 归属于母公司所有者权益合计ttm + 带息债务ttm |
| interest_bearing_debt_to_capital_lyr | 带息债务占企业全部投入成本的比重lyr | 带息债务lyr / 全部投入资本lyr |
| interest_bearing_debt_to_capital_ttm | 带息债务占企业全部投入成本的比重ttm | 带息债务ttm / 全部投入资本ttm |
| current_debt_to_total_debt_lyr | 流动负债率lyr | 流动负债合计lyr / 负债合计lyr |
| current_debt_to_total_debt_ttm | 流动负债率ttm | 流动负债合计ttm / 负债合计ttm |
| non_current_debt_to_total_debt_lyr | 非流动负债率lyr | 非流动负债合计lyr / 负债合计lyr |
| non_current_debt_to_total_debt_ttm | 非流动负债率ttm | 非流动负债合计ttm / 负债合计ttm |
| current_ratio_lyr | 流动比率lyr | 流动资产合计lyr / 流动负债合计lyr |
| current_ratio_ttm | 流动比率ttm | 流动资产合计ttm / 流动负债合计ttm |
| super_quick_ratio_lyr | 超速动比率lyr | (货币资金lyr + 交易性金融资产lyr + 应收票据lyr + 应收账款lyr + 其他应收款lyr)/ 流动负债合计lyr |
| super_quick_ratio_ttm | 超速动比率ttm | (货币资金ttm + 交易性金融资产ttm + 应收票据ttm + 应收账款ttm + 其他应收款ttm)/ 流动负债合计ttm |
| debt_to_equity_ratio_lyr | 产权比率lyr | 负债合计lyr / 股东权益合计lyr |
| debt_to_equity_ratio_ttm | 产权比率ttm | 负债合计ttm / 股东权益合计ttm |
| equity_to_debt_ratio_lyr | 权益负债比率lyr | 归属于母公司所有者权益合计lyr / 负债合计lyr |
| equity_to_debt_ratio_ttm | 权益负债比率ttm | 归属于母公司所有者权益合计ttm / 负债合计ttm |
| equity_to_interest_bearing_debt_lyr | 权益带息负债比率lyr | 归属于母公司所有者权益合计lyr / 带息债务lyr |
| equity_to_interest_bearing_debt_ttm | 权益带息负债比率ttm | 归属于母公司所有者权益合计ttm / 带息债务ttm |
| net_debt_lyr | 净债务lyr | 带息债务lyr - 货币资金lyr |
| net_debt_ttm | 净债务ttm | 带息债务ttm - 货币资金ttm |
| working_capital_lyr | 营运资本lyr | 流动资产合计lyr - 流动负债合计lyr |
| working_capital_ttm | 营运资本ttm | 流动资产合计ttm - 流动负债合计ttm |
| net_working_capital_lyr | 净营运资本lyr | 流动资产合计lyr - 货币资金lyr - 无息流动负债lyr |
| net_working_capital_ttm | 净营运资本ttm | 流动资产合计ttm - 货币资金ttm - 无息流动负债ttm |
| long_term_debt_to_working_capital_lyr | 长期债务与营运资金比率lyr | 非流动负债lyr/营运资本lyr |
| long_term_debt_to_working_capital_ttm | 长期债务与营运资金比率ttm | 非流动负债ttm/营运资本ttm |
| book_value_per_share_lyr | 每股净资产lyr | 归属母公司股东权益合计lyr / 总股本 |
| book_value_per_share_ttm | 每股净资产ttm | 归属母公司股东权益合计ttm / 总股本 |
| du_equity_multiplier_lyr | 权益乘数(杜邦分析)lyr | (本期总资产lyr + 上年总资产lyr)/ (本期股东权益合计lyr + 上年股东权益合计lyr) |
| du_equity_multiplier_ttm | 权益乘数(杜邦分析)ttm | (本期总资产ttm + 上期总资产ttm)/ (本期股东权益合计ttm + 上期股东权益合计ttm) |
| book_leverage_lyr | 账面杠杆lyr | 非流动负债合计lyr / 归母公司股东权益合计lyr |
| book_leverage_ttm | 账面杠杆ttm | 非流动负债合计ttm / 归母公司股东权益合计ttm |
| market_leverage_lyr | 市场杠杆lyr | 非流动负债合计lyr / (非流动负债合计lyr + 总市值) |
| market_leverage_ttm | 市场杠杆ttm | 非流动负债合计ttm / (非流动负债合计ttm + 总市值) |
| equity_ratio_lyr | 股东权益比率lyr | 归属母公司股东权益总计lyr / 资产总计lyr |
| equity_ratio_ttm | 股东权益比率ttm | 归属母公司股东权益总计ttm / 资产总计ttm |
| fixed_asset_ratio_lyr | 固定资产比率lyr | (固定资产lyr + 工程物资lyr + 在建工程合计lyr) / 资产总计lyr |
| fixed_asset_ratio_ttm | 固定资产比率ttm | (固定资产ttm + 工程物资ttm + 在建工程合计ttm) / 资产总计ttm |
| intangible_asset_ratio_lyr | 无形资产比率lyr | (无形资产lyr + 开发支出lyr + 商誉lyr) / 资产总计lyr |
| intangible_asset_ratio_ttm | 无形资产比率ttm | (无形资产ttm + 开发支出ttm + 商誉ttm) / 资产总计ttm |
| equity_fixed_asset_ratio_lyr | 股东权益与固定资产比率lyr | 归属母公司股东权益合计lyr / (固定资产合计lyr + 工程物资lyr + 在建工程合计lyr) |
| equity_fixed_asset_ratio_ttm | 股东权益与固定资产比率ttm | 归属母公司股东权益合计ttm / (固定资产合计ttm + 工程物资ttm + 在建工程合计ttm) |
| tangible_asset_per_share_lyr | 每股有形资产lyr | (资产总计lyr - 无形资产lyr - 商誉lyr)/ 总股本 |
| tangible_asset_per_share_ttm | 每股有形资产ttm | (资产总计ttm - 无形资产ttm - 商誉ttm)/ 总股本 |
| liabilities_per_share_lyr | 每股负债lyr | 负债合计lyr / 总股本 |
| liabilities_per_share_ttm | 每股负债ttm | 负债合计ttm / 总股本 |
| depreciation_per_share_lyr | 每股折旧和摊销lyr | (固定资产折旧lyr + 无形资产摊销lyr + 长期待摊费用摊销lyr)/ 总股本 |
| depreciation_per_share_ttm | 每股折旧和摊销ttm | (固定资产折旧ttm + 无形资产摊销ttm + 长期待摊费用摊销ttm)/ 总股本 |
| cash_ratio_lyr | 现金比率lyr | 货币资金lyr / 流动负债合计lyr |
| cash_ratio_ttm | 现金比率ttm | 货币资金ttm / 流动负债合计ttm |
| cash_equivalent_per_share_lyr | 每股货币资金lyr | 货币资金lyr / 总股本 |
| cash_equivalent_per_share_ttm | 每股货币资金ttm | 货币资金ttm / 总股本 |
获取时间范围的增长衍生指标
get_growth_indicators_seq-获取时间范围的增长衍生指标
查询指定日期范围,股票所属上市公司的增长衍生指标数据。
函数原型
python
get_growth_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
# 示例1:查询2024-02-01至2024-02-10平安银行的营业总收入同比增长率ttm、净利润同比增长率ttm
df = get_growth_indicators_seq(
security='sz000001',
fields=['inc_revenue_ttm', 'net_profit_growth_ratio_ttm'],
start_date='2024-02-01',
end_date='2024-02-10'
)
log.info(df)
# 输出:
# security date inc_revenue_ttm net_profit_growth_ratio_ttm
# 0 sz000001 2024-02-01 0.1258 0.1569
# 1 sz000001 2024-02-02 0.1265 0.1572
# 2 sz000001 2024-02-03 0.1271 0.1581
# ...
# 9 sz000001 2024-02-10 0.1285 0.1593
# 示例2:查询2024-05-01至2024-05-05平安银行和万科A的净资产同比增长率ttm、经营现金流量净额同比增长率ttm
df = get_growth_indicators_seq(
security=['sz000001', 'sz000002'],
fields=['net_asset_growth_ratio_ttm', 'net_operate_cash_flow_growth_ratio_ttm'],
start_date='2024-05-01',
end_date='2024-05-05'
)
log.info(df)
# 输出:
# security date net_asset_growth_ratio_ttm net_operate_cash_flow_growth_ratio_ttm
# 0 sz000001 2024-05-01 0.0876 0.1125
# 1 sz000001 2024-05-02 0.0881 0.1132
# 2 sz000002 2024-05-01 0.0758 0.0987
# 3 sz000002 2024-05-02 0.0762 0.0991
# 4 sz000001 2024-05-03 0.0885 0.1138
# ...支持的增长衍生指标字段
| 字段名 | 中文名称 | 说明 |
|---|---|---|
| inc_revenue_lyr | 营业总收入同比增长率lyr | 营业总收入lyr / 上年营业总收入lyr - 1 |
| inc_revenue_ttm | 营业总收入同比增长率ttm | 营业总收入ttm / 上年营业总收入ttm - 1 |
| inc_return_on_equity_lyr | 净资产收益率(摊薄)同比增长率lyr | 摊薄净资产收益率lyr / 去年摊薄净资产收益率lyr - 1 |
| inc_return_on_equity_ttm | 净资产收益率(摊薄)同比增长率ttm | 摊薄净资产收益率ttm / 去年摊薄净资产收益率ttm - 1 |
| inc_book_per_share_lyr | 每股净资产同比增长率lyr | 每股净资产lyr / 去年每股净资产lyr - 1 |
| inc_book_per_share_ttm | 每股净资产同比增长率ttm | 每股净资产ttm / 去年每股净资产ttm - 1 |
| operating_profit_growth_ratio_lyr | 营业利润同比增长率lyr | (营业利润lyr - 去年营业利润lyr) / 去年营业利润lyr |
| operating_profit_growth_ratio_ttm | 营业利润同比增长率ttm | (营业利润ttm - 去年营业利润ttm) / 去年营业利润ttm |
| net_profit_growth_ratio_lyr | 净利润同比增长率lyr | (净利润lyr - 去年净利润lyr) / 去年净利润lyr |
| net_profit_growth_ratio_ttm | 净利润同比增长率ttm | (净利润ttm - 去年净利润ttm) / 去年净利润ttm |
| profit_growth_ratio_lyr | 利润总额同比增长率lyr | (利润总额lyr - 去年利润总额lyr) / 去年利润总额lyr |
| profit_growth_ratio_ttm | 利润总额同比增长率ttm | (利润总额ttm - 去年利润总额ttm) / 去年利润总额ttm |
| gross_profit_growth_ratio_lyr | 毛利润同比增长率lyr | (营业收入lyr - 营业总成本lyr) / (去年营业收入lyr - 去年营业总成本lyr) - 1 |
| gross_profit_growth_ratio_ttm | 毛利润同比增长率ttm | (营业收入ttm - 营业成本ttm) / (去年营业收入ttm - 去年营业成本ttm) - 1 |
| operating_revenue_growth_ratio_lyr | 营业收入同比增长率lyr | (营业收入lyr - 去年营业收入lyr) / 去年营业收入lyr |
| operating_revenue_growth_ratio_ttm | 营业收入同比增长率ttm | (营业收入ttm - 去年营业收入ttm) / 去年营业收入ttm |
| net_asset_growth_ratio_lyr | 净资产同比增长率lyr | 归属于母公司所有者权益合计lyr / 去年归属于母公司所有者权益合计lyr - 1 |
| net_asset_growth_ratio_ttm | 净资产同比增长率ttm | 归属于母公司所有者权益合计ttm / 去年归属于母公司所有者权益合计ttm - 1 |
| total_asset_growth_ratio_lyr | 总资产同比增长率lyr | (总资产lyr - 去年总资产lyr) / 去年总资产lyr |
| total_asset_growth_ratio_ttm | 总资产同比增长率ttm | (总资产ttm - 去年总资产ttm) / 去年总资产ttm |
| net_profit_parent_company_growth_ratio_lyr | 归属母公司所有者的净利润同比增长率lyr | 归属于母公司所有者的净利润lyr / 去年归属于母公司所有者的净利润lyr - 1 |
| net_profit_parent_company_growth_ratio_ttm | 归属母公司所有者的净利润同比增长率ttm | 归属于母公司所有者的净利润ttm / 去年归属于母公司所有者的净利润ttm - 1 |
| net_operate_cash_flow_growth_ratio_lyr | 经营现金流量净额同比增长率lyr | 经营活动产生的现金流量净额lyr / 去年经营活动产生的现金流量净额lyr - 1 |
| net_operate_cash_flow_growth_ratio_ttm | 经营现金流量净额同比增长率ttm | 经营活动产生的现金流量净额ttm / 去年经营活动产生的现金流量净额ttm - 1 |
| net_investing_cash_flow_growth_ratio_lyr | 投资现金流量净额同比增长率lyr | 投资活动产生的现金流量净额lyr / 去年投资活动产生的现金流量净额lyr - 1 |
| net_investing_cash_flow_growth_ratio_ttm | 投资现金流量净额同比增长率ttm | 投资活动产生的现金流量净额ttm / 去年投资活动产生的现金流量净额ttm - 1 |
| net_financing_cash_flow_growth_ratio_lyr | 筹资现金流量净额同比增长率lyr | 筹资活动产生的现金流量净额lyr / 去年筹资活动产生的现金流量净额lyr - 1 |
| net_financing_cash_flow_growth_ratio_ttm | 筹资现金流量净额同比增长率ttm | 筹资活动产生的现金流量净额ttm / 去年筹资活动产生的现金流量净额ttm - 1 |
获取分红送股数据
get_dividend-获取分红送股数据
获取指定股票在指定时间范围内的分红送股数据,包括现金分红、送股、转增等信息。
函数原型
python
get_dividend(security, start_date, end_date)参数详情
| 参数名 | 类型 | 必选 | 含义与取值说明 |
|---|---|---|---|
| security | str或list[str] | 是 | 标的代码,可传入单个字符串代码(如sz000001)或多个代码组成的列表(如['sz000001', 'sz000002']) |
| start_date | 多种类型 | 是 | 开始时间日期(除权除息日),支持日期类型、字符串格式(如2025-01-01)或时间戳,自动转换为YYYY-MM-DD格式 |
| end_date | 多种类型 | 是 | 结束时间日期(除权除息日),支持日期类型、字符串格式(如2025-01-01)或时间戳,自动转换为YYYY-MM-DD格式 |
返回值说明
返回一个DataFrame,包含分红送股的所有相关信息;无匹配数据时返回空DataFrame。 返回字段:
- security:股票代码,字符串类型
- implementation_bonusnote:分配方案,字符串类型,描述现金分红、送股、转增方案
- pub_date:公告日,字符串类型,格式为YYYY-MM-DD
- registration_date:股权登记日,字符串类型,格式为YYYY-MM-DD
- xr_date:除权除息日,字符串类型,格式为YYYY-MM-DD
- bonus_date:现金红利发放日,字符串类型,格式为YYYY-MM-DD
- dividend_arrival_date:送转股到账日,字符串类型,格式为YYYY-MM-DD
- increment_listing_date:新增股份上市流通日,字符串类型,红股上市日或送(转增)股份上市交易日,格式为YYYY-MM-DD
- at_bonus_ratio:税后红利,浮点类型,单位为元/10股
- bonus_ratio:税前红利,浮点类型,单位为元/10股
- dividend_ratio:送股比例,浮点类型,表示为10:X(如送股比例为10送3,则该字段值为3.0)
- transfer_ratio:转增比例,浮点类型,表示为10:X(如转增比例为10转5,则该字段值为5.0)
完整示例
python
# 示例1:查询平安银行2023年全年的分红送股数据
df = get_dividend(
security='sz000001',
start_date='2023-01-01',
end_date='2023-12-31'
)
log.info(df)
# 输出:
# security implementation_bonusnote pub_date registration_date xr_date bonus_date dividend_arrival_date increment_listing_date at_bonus_ratio bonus_ratio dividend_ratio transfer_ratio
# 0 sz000001 10派2.5元转3股 2023-06-15 2023-06-20 2023-06-21 2023-06-27 2023-06-21 2023-06-21 2.25 2.5 0.0 3.0
# 示例2:查询平安银行和万科A2020-2024年的分红送股数据
df = get_dividend(
security=['sz000001', 'sz000002'],
start_date='2020-01-01',
end_date='2024-12-31'
)
log.info(df)
# 输出:
# security implementation_bonusnote pub_date registration_date xr_date bonus_date dividend_arrival_date increment_listing_date at_bonus_ratio bonus_ratio dividend_ratio transfer_ratio
# 0 sz000001 10派2.2元转2股 2020-05-20 2020-05-25 2020-05-26 2020-06-01 2020-05-26 2020-05-26 1.98 2.2 0.0 2.0
# 1 sz000001 10派2.5元转3股 2023-06-15 2023-06-20 2023-06-21 2023-06-27 2023-06-21 2023-06-21 2.25 2.5 0.0 3.0
# 2 sz000002 10派1.8元送1股 2021-07-10 2021-07-15 2021-07-16 2021-07-22 2021-07-16 2021-07-16 1.62 1.8 1.0 0.0
# 3 sz000002 10派2.0元转1股 2022-06-18 2022-06-23 2022-06-24 2022-06-30 2022-06-24 2022-06-24 1.80 2.0 0.0 1.0