股票财务数据及基础数据函数（免费）

stk_get_index_constituents - 查询指数成分股

查询指定指数在最新交易日的成分股和权重(中证系列指数，因版权不提供成分股权重，weight=0)

函数原型：

stk_get_index_constituents(index, trade_date=None)

参数：

返回值：dataframe

示例：

stk_get_index_constituents(index='SHSE.000300')

输出：

          index       symbol  weight  trade_date  market_value_total  market_value_circ
0    SHSE.000300  SHSE.600519    0.05  2023-04-18            22083.96           22083.96
1    SHSE.000300  SZSE.300750    0.03  2023-04-18             9989.35            8822.91
2    SHSE.000300  SHSE.601318    0.03  2023-04-18             8887.85            5266.84
3    SHSE.000300  SHSE.600036    0.02  2023-04-18             8998.44            7360.41
4    SHSE.000300  SZSE.000858    0.02  2023-04-18             6921.68            6921.39
5    SHSE.000300  SZSE.000333    0.01  2023-04-18             3972.72            3891.18
6    SHSE.000300  SHSE.601166    0.01  2023-04-18             3616.80            3616.80
7    SHSE.000300  SHSE.600900    0.01  2023-04-18             5030.92            4834.92
8    SHSE.000300  SHSE.601012    0.01  2023-04-18             3033.36            3031.97
9    SHSE.000300  SZSE.300059    0.01  2023-04-18             2859.02            2399.14
10   SHSE.000300  SZSE.002594    0.01  2023-04-18             7248.75            2900.26...

注意：

1. 数据日频更新，在交易日约 20 点更新当日数据。如果当日数据尚未更新，调用时不指定trade_date会返回前一交易日的成分数据，调用时指定trade_date为当日会返回空 dataframe。

2. trade_date输入非交易日，会返回空 dataframe。trade_date出入的日期格式错误，会报错。

stk_get_fundamentals_balance - 查询资产负债表数据

查询指定时间段某一股票所属上市公司的资产负债表数据

函数原型：

stk_get_fundamentals_balance(symbol, rpt_type=None, data_type=None, start_date=None, end_date=None, fields, df=False)

参数：

返回值：

示例：

stk_get_fundamentals_balance(symbol='SHSE.600000', rpt_type=12, data_type=None, start_date='2022-12-31', end_date='2022-12-31', fields='lt_eqy_inv', df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type    lt_eqy_inv
0  SHSE.600000  2022-10-29  2021-12-31        12        102 2819000000.00

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

资产负债表

stk_get_fundamentals_cashflow - 查询现金流量表数据

查询指定时间段某一股票所属上市公司的现金流量表数据

函数原型：

stk_get_fundamentals_cashflow(symbol, rpt_type=None, data_type=None, start_date=None, end_date=None, fields, df=False)

参数：

返回值：

示例：

stk_get_fundamentals_cashflow(symbol='SHSE.600000', rpt_type=None, data_type=101, start_date='2022-12-31', end_date='2022-12-31', fields='cash_pay_fee', df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type  cash_pay_fee
0  SHSE.600000  2022-10-29  2022-09-30         9        101 7261000000.00

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

现金流量表

stk_get_fundamentals_income - 查询利润表数据

查询指定时间段某一股票所属上市公司的利润表数据

函数原型：

stk_get_fundamentals_income(symbol, rpt_type=None, data_type=None, start_date=None, end_date=None, fields, df=False)

参数：

返回值：

示例：

stk_get_fundamentals_income(symbol='SHSE.600000', rpt_type=6, data_type=None, start_date='2022-12-31', end_date='2022-12-31', fields='inc_oper', df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type       inc_oper
0  SHSE.600000  2022-08-27  2022-06-30         6        102 98644000000.00

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

利润表

stk_get_fundamentals_balance_pt - 查询资产负债表截面数据（多标的）

查询指定日期截面的股票所属上市公司的资产负债表数据（point-in-time）

函数原型：

stk_get_fundamentals_balance_pt(symbols, rpt_type=None, data_type=None, date=None, fields, df=False)

参数：

返回值：

示例：

stk_get_fundamentals_balance_pt(symbols='SHSE.600000, SZSE.000001', rpt_type=None, data_type=None, date='2022-10-01', fields='fix_ast', df=True)

输出：

        symbol    pub_date    rpt_date        fix_ast  data_type  rpt_type
0  SZSE.000001  2022-10-25  2022-09-30 10975000000.00        102         9
1  SHSE.600000  2022-10-29  2022-09-30 42563000000.00        102         9

注意：

1. 为避免未来数据问题，指定查询日期date后，返回发布日期小于查询日期下的最新报告日期数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_fundamentals_cashflow_pt - 查询现金流量表截面数据（多标的）

查询指定日期截面的股票所属上市公司的现金流量表数据（point-in-time）

函数原型：

stk_get_fundamentals_cashflow_pt(symbols, rpt_type=None, data_type=None, date=None, fields, df=False)

参数：

返回值：

示例：

stk_get_fundamentals_cashflow_pt(symbols='SHSE.600000, SZSE.000001', rpt_type=None, data_type=None, date='2022-10-01', fields='cash_pay_fee', df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type  cash_pay_fee
0  SZSE.000001  2022-10-25  2022-09-30         9        102           NaN
1  SHSE.600000  2022-10-29  2022-09-30         9        102 7261000000.00

注意：

1. 为避免未来数据问题，指定查询日期date后，返回发布日期小于查询日期下的最新报告日期数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_fundamentals_income_pt - 查询利润表截面数据（多标的）

查询指定日期截面的股票所属上市公司的利润表数据（point-in-time）

函数原型：

stk_get_fundamentals_income_pt(symbols, rpt_type=None, data_type=None, date=None, fields, df=False)

参数：

返回值：

示例：

stk_get_fundamentals_income_pt(symbols='SHSE.600000, SZSE.000001', rpt_type=None, data_type=None, date='2022-10-01', fields='inc_oper', df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type        inc_oper
0  SZSE.000001  2022-10-25  2022-09-30         9        102 138265000000.00
1  SHSE.600000  2022-10-29  2022-09-30         9        102 143680000000.00

注意：

1. 为避免未来数据问题，指定查询日期date后，返回发布日期小于查询日期下的最新报告日期数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_finance_prime - 查询财务主要指标数据

查询指定时间段股票所属上市公司的财务主要指标

函数原型：

stk_get_finance_prime(symbol, fields, rpt_type=None, data_type=None, start_date=None, end_date=None, df=False)

参数：

返回值：

示例：

stk_get_finance_prime(symbol='SHSE.600000', fields='eps_basic,eps_dil',rpt_type=None, data_type=None,
start_date=None, end_date=None, df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type  eps_dil  eps_basic
0  SHSE.600000  2023-04-29  2023-03-31         1        101     0.47       0.51

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

财务主要指标

stk_get_finance_deriv - 查询财务衍生指标数据

查询指定时间段股票所属上市公司的财务衍生指标

函数原型：

stk_get_finance_deriv(symbol, fields, rpt_type=None, data_type=None, start_date=None, end_date=None, df=False)

参数：

返回值：

示例：

stk_get_finance_deriv(symbol='SHSE.600000', fields='eps_basic,eps_dil2,eps_dil,eps_basic_cut', 
rpt_type=9, data_type=None, start_date=None, end_date=None, df=True)

输出：

        symbol    pub_date    rpt_date  ...  eps_dil  eps_basic  eps_dil2
0  SHSE.600000  2022-10-29  2022-09-30  ...   1.3785       1.31       1.2

注意：

1. 当start_date == end_date时，取离 end_date 最近报告日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 若在指定历史时间段内，有多个同一类型报表（如不同年份的一季度报表），将按照报告日期顺序返回。

3. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

财务衍生指标指标

stk_get_daily_valuation - 查询估值指标每日数据

查询指定时间段股票的每日估值指标

函数原型：

stk_get_daily_valuation(symbol, fields, start_date=None, end_date=None, df=False)

**参数：**

| 参数名     | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明                                                                                                                                                                       |
| :--------- | :--- | :------- | :--- | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| symbol     | str  | 股票代码 | Y    | 无     | 必填，只能填一个股票标的，使用时参考[symbol](python_concept.md#symbol---代码标识)                                                                   |
| fields     | str  | 返回字段 | Y    | 无     | 指定需要返回的财务字段， 如有多个字段，中间用**英文逗号**分隔                                                                                                                      |
| start_date | str  | 开始时间 | N    | None   | 开始时间，时间类型为交易日期，%Y-%m-%d 格式， 默认`None`表示最新时间                                                                                                               |
| end_date   | str  | 结束时间 | N    | None   | 结束时间，时间类型为交易日期，%Y-%m-%d 格式， 默认`None`表示最新时间                                                                                                               |
| df         | bool | 返回格式 | N    | False  | 是否返回 dataframe 格式 ， 默认`False`返回 list[dict]                                                                                                                              |


**返回值：**

| **字段名** | **类型**    | **中文名称** | **说明**                                                                                                                                                                                                                                                                                     |
| ---------- | ----------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| symbol     | str         | 股票代码     |                                                                                                                                                                                                                                                                                              |
| trade_date   | str         | 交易日期     |                                             |
| fields     | list[float] | 指标字段数据 | 指定返回 `fields`字段的数值. 支持的字段名请参考 **[估值指标](#valuation)**                                                                                                                                                                                                                   |


**示例：**

```python
stk_get_daily_valuation(symbol='SHSE.600000', fields='pe_ttm,pe_lyr,pe_mrq', start_date=None, end_date=None, df=True)

输出：

        symbol  trade_date  pe_ttm  pe_lyr  pe_mrq
0  SHSE.600000  2023-06-26  4.4139   4.107  3.3188

注意：

1. 当start_date == end_date时，取离 end_date 最近交易日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 如果fields参数的指标字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

估值指标

stk_get_daily_mktvalue - 查询市值指标每日数据

查询指定时间段股票的每日市值指标

函数原型：

stk_get_daily_mktvalue(symbol, fields, start_date=None, end_date=None, df=False)

参数：

返回值：

示例：

stk_get_daily_mktvalue(symbol='SHSE.600000', fields='tot_mv,tot_mv_csrc,a_mv',
                                  start_date=None, end_date=None, df=True)

输出：

        symbol  trade_date      tot_mv  tot_mv_csrc        a_mv
0  SHSE.600000  2023-06-26  2.1016e+11   2.1016e+11  2.1016e+11

注意：

1. 当start_date == end_date时，取离 end_date 最近交易日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 如果fields参数的指标字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

市值指标

stk_get_daily_basic - 查询股本等基础指标每日数据

查询指定时间段股票的每日基础指标

函数原型：

stk_get_daily_basic(symbol, fields, start_date=None, end_date=None, df=False)

参数：

返回值：

示例：

stk_get_daily_basic(symbol='SHSE.600000', fields='tclose,turnrate,ttl_shr,circ_shr',
                                  start_date=None, end_date=None, df=True)

输出：

        symbol  trade_date  turnrate    circ_shr     ttl_shr  tclose
0  SHSE.600000  2023-06-26    0.1159  2.9352e+10  2.9352e+10    7.16

注意：

1. 当start_date == end_date时，取离 end_date 最近交易日期的一条数据，

当start_dat< end_date时，取指定时间段的数据，

当 start_date > end_date时，返回报错。

2. 如果fields参数的财务字段填写不正确，或填写空字段，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

基础指标

stk_get_finance_prime_pt - 查询财务主要指标截面数据（多标的）

查询指定日期截面上，股票所属上市公司的财务主要指标数据（point-in-time）

函数原型：

stk_get_finance_prime_pt(symbols, fields, rpt_type=None, data_type=None, date=None, df=False)

参数：

返回值：

示例：

stk_get_finance_prime_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='eps_basic,eps_dil', rpt_type=None, data_type=None, date='2023-06-19', df=True)

输出：

        symbol    pub_date    rpt_date  rpt_type  data_type  eps_dil  eps_basic
0  SZSE.000001  2023-04-25  2023-03-31         1        101   0.6500     0.6500
1  SZSE.300002  2023-04-27  2023-03-31         1        101   0.0914     0.0914

注意：

1. 为避免未来数据问题，指定查询日期date后，返回发布日期小于查询日期下的最新报告日期数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_finance_deriv_pt - 查询财务衍生指标截面数据（多标的）

查询指定日期截面上，股票所属上市公司的财务衍生指标数据（point-in-time）

函数原型：

stk_get_finance_deriv_pt(symbols, fields, rpt_type=None, data_type=None, date=None, df=False)

参数：

返回值：

示例：

stk_get_finance_deriv_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='eps_basic,eps_dil2',
                                   rpt_type=None, data_type=None, date='2023-06-19', df=True)

输出：

        symbol    pub_date    rpt_date  ...  data_type  eps_basic  eps_dil2
0  SZSE.000001  2023-04-25  2023-03-31  ...        102     0.6500    0.6500
1  SZSE.300002  2023-04-27  2023-03-31  ...        102     0.0914    0.0914

注意：

1. 为避免未来数据问题，指定查询日期date后，返回发布日期小于查询日期下的最新报告日期数据。

2. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_valuation_pt - 查询估值指标单日截面数据（多标的）

查询指定日期截面上，股票的单日估值指标（point-in-time）

函数原型：

stk_get_daily_valuation_pt(symbols, fields, trade_date=None, df=False)

参数：

返回值：

示例：

stk_get_daily_valuation_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='pe_ttm,pe_lyr,pe_mrq',
                               trade_date=None, df=True)

输出：

        symbol  trade_date   pe_ttm   pe_mrq   pe_lyr
0  SZSE.000001  2023-06-26   4.5900   3.7145   4.7666
1  SZSE.300002  2023-06-26  39.3144  36.2480  47.6621

注意：

1. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_mktvalue_pt - 查询市值指标单日截面数据（多标的）

查询指定日期截面上，股票的单日截面数据（point-in-time）

函数原型：

stk_get_daily_mktvalue_pt(symbols, fields, trade_date=None, df=False)

参数：

返回值：

示例：

stk_get_daily_mktvalue_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='tot_mv,tot_mv_csrc,a_mv',
                               trade_date=None, df=True)

输出：

        symbol  trade_date        a_mv      tot_mv  tot_mv_csrc
0  SZSE.000001  2023-06-26  2.1696e+11  2.1696e+11   2.1696e+11
1  SZSE.300002  2023-06-26  2.5828e+10  2.5828e+10   2.5828e+10

注意：

1. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段

stk_get_daily_basic_pt - 查询股本等基础指标单日截面数据（多标的）

查询指定日期截面上，股票的单日市值指标（point-in-time）

函数原型：

stk_get_daily_basic_pt(symbols, fields, trade_date=None, df=False)

参数：

返回值：

示例：

stk_get_daily_basic_pt(symbols=['SZSE.000001', 'SZSE.300002'], fields='tclose,turnrate,ttl_shr',
                                  trade_date=None, df=True)

输出：

        symbol  trade_date  turnrate  tclose     ttl_shr
0  SZSE.000001  2023-06-27    0.2379   11.28  1.9406e+10
1  SZSE.300002  2023-06-27    7.3596   13.44  1.9611e+09

注意：

1. 如果fields参数的财务字段填写不正确，或填写空字段""，会报错提示“填写的 fields 不正确”。fields不能超过20个字段