API REFERENCE

Stock

efinance.stock.get_all_company_performance(date: str = None) pandas.core.frame.DataFrame[source]

获取沪深市场股票某一季度的表现情况

Parameters

date (str, optional) –

报告发布日期 部分可选示例如下(默认为 None)

  • None : 最新季报

  • '2021-06-30' : 2021 年 Q2 季度报

  • '2021-03-31' : 2021 年 Q1 季度报

Returns

获取沪深市场股票某一季度的表现情况

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 获取最新季度业绩表现
>>> ef.stock.get_all_company_performance()
        股票代码  股票简称                 公告日期          营业收入   营业收入同比增长  营业收入季度环比           净利润     净利润同比增长   净利润季度环比    每股收益      每股净资产  净资产收益率      销售毛利率  每股经营现金流量
0     688981  中芯国际  2021-08-28 00:00:00  1.609039e+10  22.253453   20.6593  5.241321e+09  278.100000  307.8042  0.6600  11.949525    5.20  26.665642  1.182556
1     688819  天能股份  2021-08-28 00:00:00  1.625468e+10   9.343279   23.9092  6.719446e+08  -14.890000  -36.8779  0.7100  11.902912    6.15  17.323263 -1.562187
2     688789  宏华数科  2021-08-28 00:00:00  4.555604e+08  56.418441    6.5505  1.076986e+08   49.360000   -7.3013  1.8900  14.926761   13.51  43.011243  1.421272
3     688681  科汇股份  2021-08-28 00:00:00  1.503343e+08  17.706987  121.9407  1.664509e+07  -13.100000  383.3331  0.2100   5.232517    4.84  47.455511 -0.232395
4     688670   金迪克  2021-08-28 00:00:00  3.209423e+07 -63.282413  -93.1788 -2.330505e+07 -242.275001 -240.1554 -0.3500   3.332254  -10.10  85.308531  1.050348
...      ...   ...                  ...           ...        ...       ...           ...         ...       ...     ...        ...     ...        ...       ...
3720  600131  国网信通  2021-07-16 00:00:00  2.880378e+09   6.787087   69.5794  2.171389e+08   29.570000  296.2051  0.1800   4.063260    4.57  19.137437 -0.798689
3721  600644  乐山电力  2021-07-15 00:00:00  1.257030e+09  18.079648    5.7300  8.379727e+07  -14.300000   25.0007  0.1556   3.112413    5.13  23.645137  0.200906
3722  002261  拓维信息  2021-07-15 00:00:00  8.901777e+08  47.505282   24.0732  6.071063e+07   68.320000   30.0596  0.0550   2.351598    2.37  37.047968 -0.131873
3723  601952  苏垦农发  2021-07-13 00:00:00  4.544138e+09  11.754570   47.8758  3.288132e+08    1.460000   83.1486  0.2400   3.888046    6.05  15.491684 -0.173772
3724  601568  北元集团  2021-07-09 00:00:00  6.031506e+09  32.543303   30.6352  1.167989e+09   61.050000   40.8165  0.3200   3.541533    9.01  27.879243  0.389860
>>> # 获取指定日期的季度业绩表现
>>> ef.stock.get_all_company_performance('2020-03-31')
        股票代码  股票简称                 公告日期          营业收入  营业收入同比增长  营业收入季度环比           净利润     净利润同比增长  净利润季度环比    每股收益      每股净资产  净资产收益率      销售毛利率  每股经营现金流量
0     605033  美邦股份  2021-08-25 00:00:00  2.178208e+08       NaN       NaN  4.319814e+07         NaN      NaN  0.4300        NaN     NaN  37.250416       NaN
1     301048  金鹰重工  2021-07-30 00:00:00  9.165528e+07       NaN       NaN -2.189989e+07         NaN      NaN     NaN        NaN   -1.91  20.227118       NaN
2     001213  中铁特货  2021-07-29 00:00:00  1.343454e+09       NaN       NaN -3.753634e+07         NaN      NaN -0.0100        NaN     NaN  -1.400708       NaN
3     605588  冠石科技  2021-07-28 00:00:00  1.960175e+08       NaN       NaN  1.906751e+07         NaN      NaN  0.3500        NaN     NaN  16.324650       NaN
4     688798  艾为电子  2021-07-27 00:00:00  2.469943e+08       NaN       NaN  2.707568e+07         NaN      NaN  0.3300        NaN    8.16  33.641934       NaN
...      ...   ...                  ...           ...       ...       ...           ...         ...      ...     ...        ...     ...        ...       ...
4440  603186  华正新材  2020-04-09 00:00:00  4.117502e+08 -6.844813  -23.2633  1.763252e+07   18.870055 -26.3345  0.1400   5.878423    2.35  18.861255  0.094249
4441  002838  道恩股份  2020-04-09 00:00:00  6.191659e+08 -8.019810  -16.5445  6.939886e+07   91.601624  76.7419  0.1700   2.840665    6.20  22.575224  0.186421
4442  600396  金山股份  2020-04-08 00:00:00  2.023133e+09  0.518504   -3.0629  1.878432e+08  114.304022  61.2733  0.1275   1.511012    8.81  21.422393  0.085698
4443  002913   奥士康  2020-04-08 00:00:00  4.898977e+08 -3.883035  -23.2268  2.524717e+07  -47.239162 -58.8136  0.1700  16.666749    1.03  22.470020  0.552624
4444  002007  华兰生物  2020-04-08 00:00:00  6.775414e+08 -2.622289  -36.1714  2.472864e+08   -4.708821 -22.6345  0.1354   4.842456    3.71  61.408522  0.068341

Notes

当输入的日期不正确时,会输出可选的日期列表。 你也可以通过函数 efinance.stock.get_all_report_dates 来获取可选日期

efinance.stock.get_all_report_dates() pandas.core.frame.DataFrame[source]

获取沪深市场的全部股票报告期信息

Returns

沪深市场的全部股票报告期信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_all_report_dates()
        报告日期       季报名称
0   2021-06-30  2021年 半年报
1   2021-03-31  2021年 一季报
2   2020-12-31   2020年 年报
3   2020-09-30  2020年 三季报
4   2020-06-30  2020年 半年报
5   2020-03-31  2020年 一季报
6   2019-12-31   2019年 年报
7   2019-09-30  2019年 三季报
8   2019-06-30  2019年 半年报
9   2019-03-31  2019年 一季报
10  2018-12-31   2018年 年报
11  2018-09-30  2018年 三季报
12  2018-06-30  2018年 半年报
13  2018-03-31  2018年 一季报
14  2017-12-31   2017年 年报
15  2017-09-30  2017年 三季报
16  2017-06-30  2017年 半年报
17  2017-03-31  2017年 一季报
18  2016-12-31   2016年 年报
19  2016-09-30  2016年 三季报
20  2016-06-30  2016年 半年报
21  2016-03-31  2016年 一季报
22  2015-12-31   2015年 年报
24  2015-06-30  2015年 半年报
25  2015-03-31  2015年 一季报
26  2014-12-31   2014年 年报
27  2014-09-30  2014年 三季报
28  2014-06-30  2014年 半年报
29  2014-03-31  2014年 一季报
30  2013-12-31   2013年 年报
31  2013-09-30  2013年 三季报
32  2013-06-30  2013年 半年报
33  2013-03-31  2013年 一季报
34  2012-12-31   2012年 年报
35  2012-09-30  2012年 三季报
36  2012-06-30  2012年 半年报
37  2012-03-31  2012年 一季报
38  2011-12-31   2011年 年报
39  2011-09-30  2011年 三季报
efinance.stock.get_base_info(stock_codes: Union[str, List[str]]) Union[pandas.core.series.Series, pandas.core.frame.DataFrame][source]
Parameters

stock_codes (Union[str, List[str]]) – 股票代码或股票代码构成的列表

Returns

  • Series : 包含单只股票基本信息(当 stock_codes 是字符串时)

  • DataFrane : 包含多只股票基本信息(当 stock_codes 是字符串列表时)

Return type

Union[Series, DataFrame]

Raises

TypeError – 当 stock_codes 类型不符合要求时

Examples

>>> import efinance as ef
>>> # 获取单只股票信息
>>> ef.stock.get_base_info('600519')
股票代码                  600519
股票名称                    贵州茅台
市盈率(动)                 39.38
市净率                    12.54
所处行业                    酿酒行业
总市值          2198082348462.0
流通市值         2198082348462.0
板块编号                  BK0477
ROE                     8.29
净利率                  54.1678
净利润       13954462085.610001
毛利率                  91.6763
dtype: object
>>> # 获取多只股票信息
>>> ef.stock.get_base_info(['600519','300715'])
    股票代码  股票名称  市盈率(动)    市净率  所处行业           总市值          流通市值    板块编号   ROE      净利率           净利润      毛利率
0  300715  凯伦股份   42.29   3.12  水泥建材  9.160864e+09  6.397043e+09  BK0424  3.97  12.1659  5.415488e+07  32.8765
1  600519  贵州茅台   39.38  12.54  酿酒行业  2.198082e+12  2.198082e+12  BK0477  8.29  54.1678  1.395446e+10  91.6763
efinance.stock.get_daily_billboard(start_date: str = None, end_date: str = None) pandas.core.frame.DataFrame[source]

获取指定日期区间的龙虎榜详情数据

Parameters
  • start_date (str, optional) –

    开始日期 部分可选示例如下

    • None 最新一个榜单公开日(默认值)

    • "2021-08-27" 2021年8月27日

  • end_date (str, optional) –

    结束日期 部分可选示例如下

    • None 最新一个榜单公开日(默认值)

    • "2021-08-31" 2021年8月31日

Returns

龙虎榜详情数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 获取最新一个公开的龙虎榜数据(后面还有获取指定日期区间的示例代码)
>>> ef.stock.get_daily_billboard()
    股票代码  股票名称        上榜日期                解读     收盘价      涨跌幅      换手率        龙虎榜净买额        龙虎榜买入额        龙虎榜卖出额        龙虎榜成交额      市场总成交额  净买额占总成交比   成交额占总成交比          流通市值                                  上榜原因
0   000608  阳光股份  2021-08-27    卖一主卖,成功率48.36%    3.73  -9.9034   3.8430 -8.709942e+06  1.422786e+07  2.293780e+07  3.716565e+07   110838793 -7.858208  33.531268  2.796761e+09                      日跌幅偏离值达到7%的前5只证券
1   000751  锌业股份  2021-08-27    主力做T,成功率18.84%    5.32  -2.9197  19.6505 -1.079219e+08  5.638899e+07  1.643109e+08  2.206999e+08  1462953973 -7.376984  15.085906  7.500502e+09                       日振幅值达到15%的前5只证券
2   000762  西藏矿业  2021-08-27  北京资金买入,成功率39.42%   63.99   1.0741  15.6463  2.938758e+07  4.675541e+08  4.381665e+08  9.057206e+08  4959962598  0.592496  18.260633  3.332571e+10                       日振幅值达到15%的前5只证券
3   000833  粤桂股份  2021-08-27  实力游资买入,成功率44.55%    8.87  10.0496   8.8263  4.993555e+07  1.292967e+08  7.936120e+07  2.086580e+08   895910429  5.573721  23.290046  3.353614e+09              连续三个交易日内,涨幅偏离值累计达到20%的证券
4   001208  华菱线缆  2021-08-27  1家机构买入,成功率40.43%   19.72   4.3386  46.1985  4.055258e+07  1.537821e+08  1.132295e+08  2.670117e+08  1203913048  3.368398  22.178651  2.634710e+09                       日换手率达到20%的前5只证券
..     ...   ...         ...               ...     ...      ...      ...           ...           ...           ...           ...         ...       ...        ...           ...                                   ...
70  688558  国盛智科  2021-08-27    买一主买,成功率38.71%   60.72   1.6064  34.0104  1.835494e+07  1.057779e+08  8.742293e+07  1.932008e+08   802569300  2.287023  24.072789  2.321743e+09              有价格涨跌幅限制的日换手率达到30%的前五只证券
71  688596  正帆科技  2021-08-27  1家机构买入,成功率57.67%   26.72   3.1660   3.9065 -1.371039e+07  8.409046e+07  9.780085e+07  1.818913e+08   745137400 -1.839982  24.410438  4.630550e+09  有价格涨跌幅限制的连续3个交易日内收盘价格涨幅偏离值累计达到30%的证券
72  688663   新风光  2021-08-27    卖一主卖,成功率37.18%   28.17 -17.6316  32.2409  1.036460e+07  5.416901e+07  4.380440e+07  9.797341e+07   274732700  3.772613  35.661358  8.492507e+08           有价格涨跌幅限制的日收盘价格跌幅达到15%的前五只证券
73  688663   新风光  2021-08-27    卖一主卖,成功率37.18%   28.17 -17.6316  32.2409  1.036460e+07  5.416901e+07  4.380440e+07  9.797341e+07   274732700  3.772613  35.661358  8.492507e+08              有价格涨跌幅限制的日换手率达到30%的前五只证券
74  688667  菱电电控  2021-08-27  1家机构卖出,成功率49.69%  123.37 -18.8996  17.7701 -2.079877e+06  4.611216e+07  4.819204e+07  9.430420e+07   268503400 -0.774618  35.122163  1.461225e+09           有价格涨跌幅限制的日收盘价格跌幅达到15%的前五只证券
>>> # 获取指定日期区间的龙虎榜数据
>>> start_date = '2021-08-20' # 开始日期
>>> end_date = '2021-08-27' # 结束日期
>>> ef.stock.get_daily_billboard(start_date = start_date,end_date = end_date)
    股票代码  股票名称        上榜日期                解读     收盘价      涨跌幅      换手率        龙虎榜净买额        龙虎榜买入额        龙虎榜卖出额        龙虎榜成交额      市场总成交额   净买额占总成交比    成交额占总成交比          流通市值                           上榜原因
0    000608  阳光股份  2021-08-27    卖一主卖,成功率48.36%    3.73  -9.9034   3.8430 -8.709942e+06  1.422786e+07  2.293780e+07  3.716565e+07   110838793  -7.858208   33.531268  2.796761e+09               日跌幅偏离值达到7%的前5只证券
1    000751  锌业股份  2021-08-27    主力做T,成功率18.84%    5.32  -2.9197  19.6505 -1.079219e+08  5.638899e+07  1.643109e+08  2.206999e+08  1462953973  -7.376984   15.085906  7.500502e+09                日振幅值达到15%的前5只证券
2    000762  西藏矿业  2021-08-27  北京资金买入,成功率39.42%   63.99   1.0741  15.6463  2.938758e+07  4.675541e+08  4.381665e+08  9.057206e+08  4959962598   0.592496   18.260633  3.332571e+10                日振幅值达到15%的前5只证券
3    000833  粤桂股份  2021-08-27  实力游资买入,成功率44.55%    8.87  10.0496   8.8263  4.993555e+07  1.292967e+08  7.936120e+07  2.086580e+08   895910429   5.573721   23.290046  3.353614e+09       连续三个交易日内,涨幅偏离值累计达到20%的证券
4    001208  华菱线缆  2021-08-27  1家机构买入,成功率40.43%   19.72   4.3386  46.1985  4.055258e+07  1.537821e+08  1.132295e+08  2.670117e+08  1203913048   3.368398   22.178651  2.634710e+09                日换手率达到20%的前5只证券
..      ...   ...         ...               ...     ...      ...      ...           ...           ...           ...           ...         ...        ...         ...           ...                            ...
414  605580  恒盛能源  2021-08-20    买一主买,成功率33.33%   13.28  10.0249   0.4086  2.413149e+06  2.713051e+06  2.999022e+05  3.012953e+06     2713051  88.945937  111.054054  6.640000e+08  有价格涨跌幅限制的日收盘价格涨幅偏离值达到7%的前三只证券
415  688029  南微医学  2021-08-20  4家机构卖出,成功率55.82%  204.61 -18.5340   8.1809 -1.412053e+08  1.883342e+08  3.295394e+08  5.178736e+08   762045800 -18.529760   67.958326  9.001510e+09    有价格涨跌幅限制的日收盘价格跌幅达到15%的前五只证券
416  688408   中信博  2021-08-20  4家机构卖出,成功率47.86%  179.98  -0.0666  15.3723 -4.336304e+07  3.750919e+08  4.184550e+08  7.935469e+08   846547400  -5.122340   93.739221  5.695886e+09      有价格涨跌幅限制的日价格振幅达到30%的前五只证券
417  688556  高测股份  2021-08-20  上海资金买入,成功率60.21%   51.97  17.0495  10.6452 -3.940045e+07  1.642095e+08  2.036099e+08  3.678194e+08   575411600  -6.847351   63.922831  5.739089e+09    有价格涨跌幅限制的日收盘价格涨幅达到15%的前五只证券
418  688636   智明达  2021-08-20  2家机构买入,成功率47.37%  161.90  15.8332  11.9578  2.922406e+07  6.598126e+07  3.675721e+07  1.027385e+08   188330100  15.517464   54.552336  1.647410e+09    有价格涨跌幅限制的日收盘价格涨幅达到15%的前五只证券
efinance.stock.get_history_bill(stock_code: str) pandas.core.frame.DataFrame[source]

获取单只股票历史单子流入流出数据

Parameters

stock_code (str) – 股票代码

Returns

沪深市场单只股票历史单子流入流出数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_history_bill('600519')
    股票名称    股票代码          日期         主力净流入       小单净流入         中单净流入         大单净流入        超大单净流入  主力净流入占比  小单流入净占比  中单流入净占比  大单流入净占比  超大单流入净占比      收盘价   涨跌幅
0    贵州茅台  600519  2021-03-04 -3.670272e+06  -2282056.0  5.952143e+06  1.461528e+09 -1.465199e+09    -0.03    -0.02     0.04    10.99    -11.02  2013.71 -5.05
1    贵州茅台  600519  2021-03-05 -1.514880e+07  -1319066.0  1.646793e+07 -2.528896e+07  1.014016e+07    -0.12    -0.01     0.13    -0.19      0.08  2040.82  1.35
2    贵州茅台  600519  2021-03-08 -8.001702e+08   -877074.0  8.010473e+08  5.670671e+08 -1.367237e+09    -6.29    -0.01     6.30     4.46    -10.75  1940.71 -4.91
3    贵州茅台  600519  2021-03-09 -2.237770e+08  -6391767.0  2.301686e+08 -1.795013e+08 -4.427571e+07    -1.39    -0.04     1.43    -1.11     -0.27  1917.70 -1.19
4    贵州茅台  600519  2021-03-10 -2.044173e+08  -1551798.0  2.059690e+08 -2.378506e+08  3.343331e+07    -2.02    -0.02     2.03    -2.35      0.33  1950.72  1.72
..    ...     ...         ...           ...         ...           ...           ...           ...      ...      ...      ...      ...       ...      ...   ...
97   贵州茅台  600519  2021-07-26 -1.564233e+09  13142211.0  1.551091e+09 -1.270400e+08 -1.437193e+09    -8.74     0.07     8.67    -0.71     -8.03  1804.11 -5.05
98   贵州茅台  600519  2021-07-27 -7.803296e+08 -10424715.0  7.907544e+08  6.725104e+07 -8.475807e+08    -5.12    -0.07     5.19     0.44     -5.56  1712.89 -5.06
99   贵州茅台  600519  2021-07-28  3.997645e+08   2603511.0 -4.023677e+08  2.315648e+08  1.681997e+08     2.70     0.02    -2.72     1.57      1.14  1768.90  3.27
100  贵州茅台  600519  2021-07-29 -9.209842e+08  -2312235.0  9.232964e+08 -3.959741e+08 -5.250101e+08    -8.15    -0.02     8.17    -3.50     -4.65  1749.79 -1.08
101  贵州茅台  600519  2021-07-30 -1.524740e+09  -6020099.0  1.530761e+09  1.147248e+08 -1.639465e+09   -11.63    -0.05    11.68     0.88    -12.51  1678.99 -4.05
efinance.stock.get_latest_holder_number() pandas.core.frame.DataFrame[source]

获取沪深A股市场最新公开的股东数目变化情况

Returns

沪深A股市场最新公开的股东数目变化情况

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_latest_holder_number()
    股票代码  股票名称    股东人数     股东人数增减  较上期变化百分比            股东户数统计截止日        户均持股市值        户均持股数量           总市值          总股本                 公告日期
0    688981  中芯国际  347706  -3.459784  -12461.0  2021-06-30 00:00:00  3.446469e+05   5575.005896  1.198358e+11   1938463000  2021-08-28 00:00:00
1    688819  天能股份   36749 -11.319981   -4691.0  2021-06-30 00:00:00  1.176868e+06  26452.420474  4.324873e+10    972100000  2021-08-28 00:00:00
2    688575   亚辉龙    7347 -74.389989  -21341.0  2021-06-30 00:00:00  2.447530e+06  55124.540629  1.798200e+10    405000000  2021-08-28 00:00:00
3    688538  和辉光电  383993 -70.245095 -906527.0  2021-06-30 00:00:00  1.370180e+05  35962.732719  5.261396e+10  13809437625  2021-08-28 00:00:00
4    688425  铁建重工  311356 -64.684452 -570284.0  2021-06-30 00:00:00  1.010458e+05  16510.746541  3.146121e+10   5140720000  2021-08-28 00:00:00
..      ...   ...     ...        ...       ...                  ...           ...           ...           ...          ...                  ...
400  600618  氯碱化工   45372  -0.756814    -346.0  2014-06-30 00:00:00  1.227918e+05  16526.491581  5.571311e+09    749839976  2014-08-22 00:00:00
401  601880  辽港股份   89923  -3.589540   -3348.0  2014-03-31 00:00:00  9.051553e+04  37403.111551  8.139428e+09   3363400000  2014-04-30 00:00:00
402  600685  中船防务   52296  -4.807325   -2641.0  2014-03-11 00:00:00  1.315491e+05   8384.263691  6.879492e+09    438463454  2014-03-18 00:00:00
403  000017  深中华A   21358 -10.800200   -2586.0  2013-06-30 00:00:00  5.943993e+04  14186.140556  1.269518e+09    302987590  2013-08-24 00:00:00
404  601992  金隅集团   66736 -12.690355   -9700.0  2013-06-30 00:00:00  2.333339e+05  46666.785918  1.557177e+10   3114354625  2013-08-22 00:00:00
efinance.stock.get_latest_quote(stock_codes: List[str]) pandas.core.frame.DataFrame[source]

获取沪深市场多只股票的实时涨幅情况

Parameters

stock_codes (List[str]) – 多只股票代码列表

Returns

沪深市场、港股、美股多只股票的实时涨幅情况

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_latest_quote(['600519','300750'])
    股票代码  股票名称   涨跌幅      最新价      最高      最低      今开    涨跌额   换手率    量比   动态市盈率     成交量           成交额    昨日收盘            总市值           流通市值 市场类型
0  600519  贵州茅台  0.59  1700.04  1713.0  1679.0  1690.0  10.04  0.30  0.72   43.31   37905  6.418413e+09  1690.0  2135586507912  2135586507912   沪A
1  300750  宁德时代  0.01   502.05   529.9   480.0   480.0   0.05  1.37  1.75  149.57  277258  1.408545e+10   502.0  1169278366994  1019031580505   深A

Notes

当需要获取多只沪深 A 股 的实时涨跌情况时,最好使用 efinance.stock.get_realtime_quptes

efinance.stock.get_quote_history(stock_codes: Union[str, List[str]], beg: str = '19000101', end: str = '20500101', klt: int = 101, fqt: int = 1) Union[pandas.core.frame.DataFrame, Dict[str, pandas.core.frame.DataFrame]][source]

获取股票的 K 线数据

Parameters
  • stock_codes (Union[str,List[str]]) – 股票代码、名称 或者 股票代码、名称构成的列表

  • beg (str, optional) – 开始日期,默认为 '19000101' ,表示 1900年1月1日

  • end (str, optional) – 结束日期,默认为 '20500101' ,表示 2050年1月1日

  • klt (int, optional) –

    行情之间的时间间隔,默认为 101 ,可选示例如下

    • 1 : 分钟

    • 5 : 5 分钟

    • 15 : 15 分钟

    • 30 : 30 分钟

    • 60 : 60 分钟

    • 101 : 日

    • 102 : 周

    • 103 : 月

  • fqt (int, optional) –

    复权方式,默认为 1 ,可选示例如下

    • 0 : 不复权

    • 1 : 前复权

    • 2 : 后复权

Returns

股票的 K 线数据

  • DataFrame : 当 stock_codesstr

  • Dict[str, DataFrame] : 当 stock_codesList[str]

Return type

Union[DataFrame, Dict[str, DataFrame]]

Examples

>>> import efinance as ef
>>> # 获取单只股票日 K 行情数据
>>> ef.stock.get_quote_history('600519')
    股票名称    股票代码          日期       开盘       收盘       最高       最低     成交量           成交额    振幅   涨跌幅    涨跌额    换手率
0     贵州茅台  600519  2001-08-27   -89.74   -89.53   -89.08   -90.07  406318  1.410347e+09 -1.10  0.92   0.83  56.83
1     贵州茅台  600519  2001-08-28   -89.64   -89.27   -89.24   -89.72  129647  4.634630e+08 -0.54  0.29   0.26  18.13
2     贵州茅台  600519  2001-08-29   -89.24   -89.36   -89.24   -89.42   53252  1.946890e+08 -0.20 -0.10  -0.09   7.45
3     贵州茅台  600519  2001-08-30   -89.38   -89.22   -89.14   -89.44   48013  1.775580e+08 -0.34  0.16   0.14   6.72
4     贵州茅台  600519  2001-08-31   -89.21   -89.24   -89.12   -89.28   23231  8.623100e+07 -0.18 -0.02  -0.02   3.25
...    ...     ...         ...      ...      ...      ...      ...     ...           ...   ...   ...    ...    ...
4756  贵州茅台  600519  2021-07-23  1937.82  1900.00  1937.82  1895.09   47585  9.057762e+09  2.20 -2.06 -40.01   0.38
4757  贵州茅台  600519  2021-07-26  1879.00  1804.11  1879.00  1780.00   98619  1.789436e+10  5.21 -5.05 -95.89   0.79
4758  贵州茅台  600519  2021-07-27  1803.00  1712.89  1810.00  1703.00   86577  1.523081e+10  5.93 -5.06 -91.22   0.69
4759  贵州茅台  600519  2021-07-28  1703.00  1768.90  1788.20  1682.12   85369  1.479247e+10  6.19  3.27  56.01   0.68
4760  贵州茅台  600519  2021-07-29  1810.01  1749.79  1823.00  1734.34   63864  1.129957e+10  5.01 -1.08 -19.11   0.51
>>> # 获取多只股票历史行情
>>> stock_df = ef.stock.get_quote_history(['600519','300750'])
>>> type(stock_df)
<class 'dict'>
>>> stock_df.keys()
dict_keys(['300750', '600519'])
>>> stock_df['600519']
    股票名称    股票代码          日期       开盘       收盘       最高       最低     成交量           成交额    振幅   涨跌幅    涨跌额    换手率
0     贵州茅台  600519  2001-08-27   -89.74   -89.53   -89.08   -90.07  406318  1.410347e+09 -1.10  0.92   0.83  56.83
1     贵州茅台  600519  2001-08-28   -89.64   -89.27   -89.24   -89.72  129647  4.634630e+08 -0.54  0.29   0.26  18.13
2     贵州茅台  600519  2001-08-29   -89.24   -89.36   -89.24   -89.42   53252  1.946890e+08 -0.20 -0.10  -0.09   7.45
3     贵州茅台  600519  2001-08-30   -89.38   -89.22   -89.14   -89.44   48013  1.775580e+08 -0.34  0.16   0.14   6.72
4     贵州茅台  600519  2001-08-31   -89.21   -89.24   -89.12   -89.28   23231  8.623100e+07 -0.18 -0.02  -0.02   3.25
...    ...     ...         ...      ...      ...      ...      ...     ...           ...   ...   ...    ...    ...
4756  贵州茅台  600519  2021-07-23  1937.82  1900.00  1937.82  1895.09   47585  9.057762e+09  2.20 -2.06 -40.01   0.38
4757  贵州茅台  600519  2021-07-26  1879.00  1804.11  1879.00  1780.00   98619  1.789436e+10  5.21 -5.05 -95.89   0.79
4758  贵州茅台  600519  2021-07-27  1803.00  1712.89  1810.00  1703.00   86577  1.523081e+10  5.93 -5.06 -91.22   0.69
4759  贵州茅台  600519  2021-07-28  1703.00  1768.90  1788.20  1682.12   85369  1.479247e+10  6.19  3.27  56.01   0.68
4760  贵州茅台  600519  2021-07-29  1810.01  1749.79  1823.00  1734.34   63864  1.129957e+10  5.01 -1.08 -19.11   0.51
efinance.stock.get_realtime_quotes() pandas.core.frame.DataFrame[source]

获取沪深市场最新行情总体情况

Returns

沪深全市场A股上市公司的最新行情信息(涨跌幅、换手率等信息)

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_realtime_quotes()
        股票代码   股票名称     涨跌幅     最新价      最高      最低      今开     涨跌额    换手率    量比    动态市盈率     成交量           成交额   昨日收盘           总市值         流通市值      行情ID 市场类型
0     688787    N海天  277.59  139.48  172.39  139.25  171.66  102.54  85.62     -    78.93   74519  1110318832.0  36.94    5969744000   1213908667  1.688787   沪A
1     301045    N天禄  149.34   39.42   48.95    39.2   48.95   23.61  66.66     -    37.81  163061   683878656.0  15.81    4066344240    964237089  0.301045   深A
2     300532   今天国际   20.04   12.16   12.16   10.69   10.69    2.03   8.85  3.02   -22.72  144795   171535181.0  10.13    3322510580   1989333440  0.300532   深A
3     300600   国瑞科技   20.02   13.19   13.19   11.11   11.41     2.2  18.61  2.82   218.75  423779   541164432.0  10.99    3915421427   3003665117  0.300600   深A
4     300985   致远新能   20.01   47.08   47.08    36.8    39.4    7.85  66.65  2.17    58.37  210697   897370992.0  39.23    6277336472   1488300116  0.300985   深A
...      ...    ...     ...     ...     ...     ...     ...     ...    ...   ...      ...     ...           ...    ...           ...          ...       ...  ...
4598  603186   华正新材   -10.0   43.27   44.09   43.27   43.99   -4.81   1.98  0.48    25.24   27697   120486294.0  48.08    6146300650   6063519472  1.603186   沪A
4599  688185  康希诺-U  -10.11   476.4  534.94  460.13   530.0   -53.6   6.02  2.74 -2088.07   40239  1960540832.0  530.0  117885131884  31831479215  1.688185   沪A
4600  688148   芳源股份  -10.57    31.3   34.39    31.3    33.9    -3.7  26.07  0.56   220.01  188415   620632512.0   35.0   15923562000   2261706043  1.688148   沪A
4601  300034   钢研高纳  -10.96   43.12   46.81   42.88    46.5   -5.31   7.45  1.77    59.49  323226  1441101824.0  48.43   20959281094  18706911861  0.300034   深A
4602  300712   永福股份  -13.71    96.9  110.94    95.4   109.0   -15.4   6.96  1.26   511.21  126705  1265152928.0  112.3   17645877600  17645877600  0.300712   深A
efinance.stock.get_today_bill(stock_code: str) pandas.core.frame.DataFrame[source]

获取单只股票最新交易日的日内分钟级单子流入流出数据

Parameters

stock_code (str) – 股票代码

Returns

单只股票最新交易日的日内分钟级单子流入流出数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_today_bill('600519')
    股票代码                时间        主力净流入      小单净流入        中单净流入        大单净流入       超大单净流入
0    600519  2021-07-29 09:31   -3261705.0  -389320.0    3651025.0  -12529658.0    9267953.0
1    600519  2021-07-29 09:32    6437999.0  -606994.0   -5831006.0  -42615994.0   49053993.0
2    600519  2021-07-29 09:33   13179707.0  -606994.0  -12572715.0  -85059118.0   98238825.0
3    600519  2021-07-29 09:34   15385244.0  -970615.0  -14414632.0  -86865209.0  102250453.0
4    600519  2021-07-29 09:35    7853716.0  -970615.0   -6883104.0  -75692436.0   83546152.0
..      ...               ...          ...        ...          ...          ...          ...
235  600519  2021-07-29 14:56 -918956019.0 -1299630.0  920255661.0 -397127393.0 -521828626.0
236  600519  2021-07-29 14:57 -920977761.0 -2319213.0  923296987.0 -397014702.0 -523963059.0
237  600519  2021-07-29 14:58 -920984196.0 -2312233.0  923296442.0 -395974137.0 -525010059.0
238  600519  2021-07-29 14:59 -920984196.0 -2312233.0  923296442.0 -395974137.0 -525010059.0
239  600519  2021-07-29 15:00 -920984196.0 -2312233.0  923296442.0 -395974137.0 -525010059.0
efinance.stock.get_top10_stock_holder_info(stock_code: str, top: int = 4) pandas.core.frame.DataFrame[source]

获取沪深市场指定股票前十大股东信息

Parameters
  • stock_code (str) – 股票代码

  • top (int, optional) – 最新 top 个前 10 大流通股东公开信息, 默认为 4

Returns

个股持仓占比前 10 的股东的一些信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.stock.get_top10_stock_holder_info('600519',top = 1)
    股票代码        更新日期      股东代码                                股东名称     持股数    持股比例       增减     变动率
0  600519  2021-03-31  80010298                  中国贵州茅台酒厂(集团)有限责任公司  6.783亿  54.00%       不变      --
1  600519  2021-03-31  80637337                          香港中央结算有限公司   9594万   7.64%  -841.1万  -8.06%
2  600519  2021-03-31  80732941                     贵州省国有资本运营有限责任公司   5700万   4.54%  -182.7万  -3.11%
3  600519  2021-03-31  80010302                      贵州茅台酒厂集团技术开发公司   2781万   2.21%       不变      --
4  600519  2021-03-31  80475097                      中央汇金资产管理有限责任公司   1079万   0.86%       不变      --
5  600519  2021-03-31  80188285                        中国证券金融股份有限公司  803.9万   0.64%      -91   0.00%
6  600519  2021-03-31  78043999      深圳市金汇荣盛财富管理有限公司-金汇荣盛三号私募证券投资基金  502.1万   0.40%       不变      --
7  600519  2021-03-31  70400207  中国人寿保险股份有限公司-传统-普通保险产品-005L-CT001沪  434.1万   0.35%   44.72万  11.48%
8  600519  2021-03-31    005827         中国银行股份有限公司-易方达蓝筹精选混合型证券投资基金    432万   0.34%       新进      --
9  600519  2021-03-31  78083830      珠海市瑞丰汇邦资产管理有限公司-瑞丰汇邦三号私募证券投资基金  416.1万   0.33%       不变      --

Fund

efinance.fund.get_base_info(fund_codes: Union[str, List[str]]) Union[pandas.core.series.Series, pandas.core.frame.DataFrame][source]

获取基金的一些基本信息

Parameters

fund_codes (Union[str, List[str]]) – 6 位基金代码 或多个 6 位 基金代码构成的列表

Returns

基金的一些基本信息

  • Series : 包含单只基金基本信息(当 fund_codes 是字符串时)

  • DataFrane : 包含多只股票基本信息(当 fund_codes 是字符串列表时)

Return type

Union[Series, DataFrame]

Raises

TypeError – 当 fund_codes 类型不符合要求时

Examples

>>> import efinance as ef
>>> ef.fund.get_base_info('161725')
基金代码                                 161725
基金简称                         招商中证白酒指数(LOF)A
成立日期                             2015-05-27
涨跌幅                                   -6.03
最新净值                                 1.1959
基金公司                                   招商基金
净值更新日期                           2021-07-30
简介        产品特色:布局白酒领域的指数基金,历史业绩优秀,外资偏爱白酒板块。
dtype: object
>>> # 获取多只基金基本信息
>>> ef.fund.get_base_info(['161725','005827'])
    基金代码            基金简称        成立日期   涨跌幅    最新净值   基金公司      净值更新日期                                    简介00:00,  6.38it/s]
0  005827       易方达蓝筹精选混合  2018-09-05 -2.98  2.4967  易方达基金  2021-07-30  明星消费基金经理另一力作,A+H股同步布局,价值投资典范,适合长期持有。
1  161725  招商中证白酒指数(LOF)A  2015-05-27 -6.03  1.1959   招商基金  2021-07-30     产品特色:布局白酒领域的指数基金,历史业绩优秀,外资偏爱白酒板块。
efinance.fund.get_fund_codes(ft: str = None) pandas.core.frame.DataFrame[source]

获取天天基金网公开的全部公墓基金名单

Parameters

ft (str, optional) –

基金类型可选示例如下

  • 'zq' : 债券类型基金

  • 'gp' : 股票类型基金

  • ‘ct’ : 场内基金

  • None : 全部

Returns

天天基金网基金名单数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 全部类型的基金
>>> ef.fund.get_fund_codes()
>>> # 股票型基金
>>> ef.fund.get_fund_codes(ft = 'gp')
    基金代码                  基金简称
0     003834              华夏能源革新股票
1     005669            前海开源公用事业股票
2     004040             金鹰医疗健康产业A
3     517793                 1.20%
4     004041             金鹰医疗健康产业C
...      ...                   ...
1981  012503      国泰中证环保产业50ETF联接A
1982  012517  国泰中证细分机械设备产业主题ETF联接C
1983  012600             中银内核驱动股票C
1984  011043             国泰价值先锋股票C
1985  012516  国泰中证细分机械设备产业主题ETF联接A
efinance.fund.get_industry_distribution(fund_code: str, dates: Union[str, List[str]] = None) pandas.core.frame.DataFrame[source]

获取指定基金行业分布信息

Parameters
  • fund_code (str) – 6 位基金代码

  • dates (Union[str, List[str]], optional) –

    日期 可选示例如下

    • None : 最新公开日期

    • '2020-01-01' : 一个公开持仓日期

    • ['2020-12-31' ,'2019-12-31'] : 多个公开持仓日期

Returns

指定基金行业持仓信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 获取持仓公开日期
>>> public_dates = ef.fund.get_public_dates('161725')
>>> # 取前一个公开持仓日期
>>> dates = public_dates[:1]
>>> ef.fund.get_industry_distribution('161725',dates)
0   161725               制造业  93.07  2021-06-30  6492580.019556
1   161725               金融业   0.01  2021-06-30      485.060688
2   161725          农、林、牧、渔业      0  2021-06-30        0.585078
3   161725  电力、热力、燃气及水生产和供应业      0  2021-06-30        1.302039
4   161725               建筑业      0  2021-06-30        2.537137
5   161725            批发和零售业      0  2021-06-30        5.888394
6   161725   信息传输、软件和信息技术服务业      0  2021-06-30      157.037536
7   161725     水利、环境和公共设施管理业      0  2021-06-30        4.443833
8   161725                教育      0  2021-06-30        1.626203
9   161725        科学研究和技术服务业      0  2021-06-30        48.30805
10  161725               采矿业     --  2021-06-30              --
11  161725       交通运输、仓储和邮政业     --  2021-06-30              --
12  161725          租赁和商务服务业     --  2021-06-30              --
13  161725            住宿和餐饮业     --  2021-06-30              --
14  161725              房地产业     --  2021-06-30              --
15  161725     居民服务、修理和其他服务业     --  2021-06-30              --
16  161725           卫生和社会工作     --  2021-06-30              --
17  161725         文化、体育和娱乐业     --  2021-06-30              --
18  161725                综合     --  2021-06-30              --
19  161725                合计  93.08  2021-06-30  6493286.808514
efinance.fund.get_inverst_position(fund_code: str, dates: Union[str, List[str]] = None) pandas.core.frame.DataFrame[source]

获取基金持仓占比数据

Parameters
  • fund_code (str) – 基金代码

  • dates (Union[str, List[str]], optional) –

    日期或者日期构成的列表 可选示例如下

    • None : 最新公开日期

    • '2020-01-01' : 一个公开持仓日期

    • ['2020-12-31' ,'2019-12-31'] : 多个公开持仓日期

Returns

基金持仓占比数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 获取最新公开的持仓数据
>>> ef.fund.get_inverst_position('161725')
    基金代码    股票代码  股票简称   持仓占比  较上期变化
0  161725  000858   五粮液  14.88   1.45
1  161725  600519  贵州茅台  14.16  -0.86
2  161725  600809  山西汾酒  14.03  -0.83
3  161725  000568  泸州老窖  13.02  -2.96
4  161725  002304  洋河股份  12.72   1.31
5  161725  000799   酒鬼酒   5.77   1.34
6  161725  603369   今世缘   3.46  -0.48
7  161725  000596  古井贡酒   2.81  -0.29
8  161725  600779   水井坊   2.52   2.52
9  161725  603589   口子窖   2.48  -0.38
>>> # 获取近 2 个公开持仓日数据
>>> public_dates = ef.fund.get_public_dates('161725')
>>> ef.fund.get_inverst_position('161725',public_dates[:2])
    基金代码    股票代码  股票简称   持仓占比  较上期变化
0  161725  000858   五粮液  14.88   1.45
2  161725  600809  山西汾酒  14.03  -0.83
3  161725  000568  泸州老窖  13.02  -2.96
4  161725  002304  洋河股份  12.72   1.31
5  161725  000799   酒鬼酒   5.77   1.34
6  161725  603369   今世缘   3.46  -0.48
7  161725  000596  古井贡酒   2.81  -0.29
8  161725  600779   水井坊   2.52   2.52
9  161725  603589   口子窖   2.48  -0.38
0  161725  000568  泸州老窖  15.98   1.27
1  161725  600519  贵州茅台  15.02   2.35
2  161725  600809  山西汾酒  14.86  -0.37
3  161725  000858   五粮液  13.43   0.54
4  161725  002304  洋河股份  11.41  -2.21
5  161725  000799   酒鬼酒   4.43  -0.15
6  161725  603369   今世缘   3.94  -0.09
7  161725  000860  顺鑫农业   3.12  -0.70
8  161725  000596  古井贡酒   3.10  -0.15
9  161725  603589   口子窖   2.86   0.21
efinance.fund.get_pdf_reports(fund_code: str, max_count: int = 12, save_dir: str = 'pdf') None[source]

根据基金代码获取其全部 pdf 报告

Parameters
  • fund_code (str) – 6 位基金代码

  • max_count (int, optional) – 要获取的最大个数个 pdf (从最新的的开始数), 默认为 12

  • save_dir (str, optional) – pdf 保存的文件夹路径, 默认为 'pdf'

Examples

>>> import efinance as ef
>>> # 获取基金代码为 161725 的基金最新的两个 pdf 报道文件
>>> ef.fund.get_pdf_reports('161725',max_count = 2)
161725 的 pdf 文件已存储到文件夹 pdf/161725 中
efinance.fund.get_period_change(fund_code: str) pandas.core.frame.DataFrame[source]

获取基金阶段涨跌幅度

Parameters

fund_code (str) – 6 位基金代码

Returns

指定基金的阶段涨跌数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.fund.get_period_change('161725')
    基金代码     收益率   同类平均  同类排行  同类总数   时间段
0  161725   -6.28   0.07  1408  1409   近一周
1  161725   10.85   5.82   178  1382   近一月
2  161725   25.32   7.10    20  1332   近三月
3  161725   22.93  10.39    79  1223   近六月
4  161725  103.76  33.58     7  1118   近一年
5  161725  166.59  55.42     9   796   近两年
6  161725  187.50  48.17     2   611   近三年
7  161725  519.44  61.62     1   389   近五年
8  161725    6.46   5.03   423  1243  今年以来
9  161725  477.00                     成立以来
efinance.fund.get_public_dates(fund_code: str) List[str][source]

获取历史上更新持仓情况的日期列表

Parameters

fund_code (str) – 6 位基金代码

Returns

指定基金公开持仓的日期列表

Return type

List[str]

Examples

>>> import efinance as ef
>>> public_dates = ef.fund.get_public_dates('161725')
>>> # 展示前 5 个
>>> public_dates[:5]
['2021-03-31', '2021-01-08', '2020-12-31', '2020-09-30', '2020-06-30']
efinance.fund.get_quote_history(fund_code: str, pz: int = 40000) pandas.core.frame.DataFrame[source]

根据基金代码和要获取的页码抓取基金净值信息

Parameters
  • fund_code (str) – 6 位基金代码

  • pz (int, optional) – 页码, 默认为 40000 以获取全部历史数据

Returns

包含基金历史净值等数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.fund.get_quote_history('161725')
    日期    单位净值    累计净值     涨跌幅
0    2021-06-11  1.5188  3.1499   -3.09
1    2021-06-10  1.5673  3.1984    1.69
2    2021-06-09  1.5412  3.1723    0.11
3    2021-06-08  1.5395  3.1706    -6.5
4    2021-06-07  1.6466  3.2777    1.61
...         ...     ...     ...     ...
1469 2015-06-08  1.0380  1.0380  2.5692
1470 2015-06-05  1.0120  1.0120  1.5045
1471 2015-06-04  0.9970  0.9970      --
1472 2015-05-29  0.9950  0.9950      --
1473 2015-05-27  1.0000  1.0000      --
efinance.fund.get_realtime_increase_rate(fund_codes: Union[List[str], str]) pandas.core.frame.DataFrame[source]

获取基金实时估算涨跌幅度

Parameters

fund_codes (Union[List[str], str]) – 6 位基金代码或者 6 位基金代码构成的字符串列表

Returns

单只或者多只基金实时估算涨跌情况

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 单只基金
>>> ef.fund.get_realtime_increase_rate('161725')
    基金代码            基金名称    最新净值    最新净值公开日期              估算时间  估算涨跌幅
0  161725  招商中证白酒指数(LOF)A  2.8856  2021-09-07  2021-09-07 15:00   0.64
>>> # 多只基金
>>> ef.fund.get_realtime_increase_rate(['161725','005827'])
    基金代码            基金名称    最新净值    最新净值公开日期              估算时间  估算涨跌幅
0  161725  招商中证白酒指数(LOF)A  2.8856  2021-09-07  2021-09-07 15:00   0.64
1  005827       易方达蓝筹精选混合  2.5704  2021-09-07  2021-09-07 15:00   0.67
efinance.fund.get_types_persentage(fund_code: str, dates: Optional[Union[List[str], str]] = None) pandas.core.frame.DataFrame[source]

获取指定基金不同类型占比信息

Parameters
  • fund_code (str) – 6 位基金代码

  • dates (Union[List[str], str, None]) –

    可选值类型示例如下(后面有获取 dates 的例子)

    • None : 最新公开日期

    • '2020-01-01' : 一个公开持仓日期

    • ['2020-12-31' ,'2019-12-31'] : 多个公开持仓日期

Returns

指定基金的在不同日期的不同类型持仓占比信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> # 获取持仓公开日期
>>> public_dates = ef.fund.get_public_dates('005827')
>>> # 取前两个公开持仓日期
>>> dates = public_dates[:2]
>>> ef.fund.get_types_persentage('005827',dates)
    基金代码   股票比重 债券比重  现金比重         总规模(亿元) 其他比重
0  005827   94.4   --  6.06  880.1570625231    0
0  005827  94.09   --  7.63   677.007455712    0

Bond

efinance.bond.get_all_base_info() pandas.core.frame.DataFrame[source]

获取全部可转债基本信息列表

Returns

可转债一些基本信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.bond.get_all_base_info()
    债券代码   债券名称    正股代码  正股名称 债券评级                 申购日期    发行规模(亿)  网上发行中签率(%)                 上市日期                 到期日期   期限(年)                                               利率说明
0   123120   隆华转债  300263  隆华科技  AA-  2021-07-30 00:00:00   7.989283         NaN                 None  2027-07-30 00:00:00       6  第一年为0.40%、第二年为0.70%、第三年为1.00%、第四年为1.60%、第五年为2....
1   110081   闻泰转债  600745  闻泰科技  AA+  2021-07-28 00:00:00  86.000000    0.044030                 None  2027-07-28 00:00:00       6  第一年0.10%、第二年0.20%、第三年0.30%、第四年1.50%、第五年1.80%、第...
2   118001   金博转债  688598  金博股份   A+  2021-07-23 00:00:00   5.999010    0.001771                 None  2027-07-23 00:00:00       6  第一年0.50%、第二年0.70%、第三年1.20%、第四年1.80%、第五年2.40%、第...
3   123119   康泰转2  300601  康泰生物   AA  2021-07-15 00:00:00  20.000000    0.014182                 None  2027-07-15 00:00:00       6  第一年为0.30%、第二年为0.50%、第三年为1.00%、第 四年为1.50%、第五年为1....
4   113627   太平转债  603877   太平鸟   AA  2021-07-15 00:00:00   8.000000    0.000542                 None  2027-07-15 00:00:00       6  第一年0.30%、第二年0.50%、第三年1.00%、第四年1.50%、第五年1.80%、第...
..     ...    ...     ...   ...  ...                  ...        ...         ...                  ...                  ...     ...                                                ...
80  110227   赤化转债  600227   圣济堂  AAA  2007-10-10 00:00:00   4.500000    0.158854  2007-10-23 00:00:00  2009-05-25 00:00:00  1.6192  票面利率和付息日期:本次发行的可转债票面利率第一 年为1.5%、第二年为1.8%、第三年为2....
81  126006  07深高债  600548   深高速  AAA  2007-10-09 00:00:00  15.000000    0.290304  2007-10-30 00:00:00  2013-10-09 00:00:00       6                                               None
82  110971   恒源转债  600971  恒源煤电  AAA  2007-09-24 00:00:00   4.000000    5.311774  2007-10-12 00:00:00  2009-12-21 00:00:00  2.2484  票面利率为:第一年年利率1.5%,第二年年利率1.8%,第三年年利率2.1%,第四年年利率2...
83  110567   山鹰转债  600567  山鹰国际   AA  2007-09-05 00:00:00   4.700000    0.496391  2007-09-17 00:00:00  2010-02-01 00:00:00  2.4055  票面利率和付息日期:本次发行的可转债票面利率第一年为1.4%,第二年为1.7%,第三年为2....
84  110026   中海转债  600026  中远海能  AAA  2007-07-02 00:00:00  20.000000    1.333453  2007-07-12 00:00:00  2008-03-27 00:00:00   0.737  票面利率:第一年为1.84%,第二年为2.05%,第三年为2.26%,第四年为2.47%,第...
efinance.bond.get_base_info(bond_codes: Union[str, List[str]]) Union[pandas.core.frame.DataFrame, pandas.core.series.Series][source]

获取单只或多只可转债基本信息

Parameters

bond_codes (Union[str, List[str]]) – 可转债代码、名称 或者 可转债代码、名称构成的列表

Returns

单只或多只可转债基本信息

  • DataFrame : 当 bond_codes 是字符串列表时

  • Series : 当 bond_codes 是字符串时

Return type

Union[DataFrame, Series]

Examples

>>> import efinance as ef
>>> # 单只债券
>>> ef.bond.get_base_info('123111')
债券代码                                                    123111
债券名称                                                      东财转3
正股代码                                                    300059
正股名称                                                      东方财富
债券评级                                                       AA+
申购日期                                       2021-04-07 00:00:00
发行规模(亿)                                                    158
网上发行中签率(%)                                             0.05877
上市日期                                       2021-04-23 00:00:00
到期日期                                       2027-04-07 00:00:00
期限(年)                                                        6
利率说明          第一年0.2%、第二年0.3%、第三年0.4%、第四年0.8%、第五年1.8%、第六年2.0%。
dtype: object
>>> 多只债券
>>> bond_codes = ['123111','113050']
>>> ef.bond.get_base_info(bond_codes)
    债券代码  债券名称    正股代码  正股名称  ...                 上市日期                 到期日期  期限(年)                                               利率说明
0  113050  南银转债  601009  南京银行  ...  2021-07-01 00:00:00  2027-06-15 00:00:00      6  第一年0.20%、第二年0.40%、第三年0.70%、第四年1.20%
、第五年1.70%、第...
1  123111  东财转3  300059  东方财富  ...  2021-04-23 00:00:00  2027-04-07 00:00:00      6   第一年0.2%、第二年0.3%、第三年0.4%、第四年0.8%、第
五年1.8%、第六年2.0%。
efinance.bond.get_history_bill(bond_code: str) pandas.core.frame.DataFrame[source]

获取单支债券的历史单子流入流出数据

Parameters

bond_code (str) – 债券代码

Returns

沪深市场单只债券历史单子流入流出数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.bond.get_history_bill('123111')
efinance.bond.get_quote_history(bond_codes: Union[str, List[str]], beg: str = '19000101', end: str = '20500101', klt: int = 101, fqt: int = 1) Union[pandas.core.frame.DataFrame, Dict[str, pandas.core.frame.DataFrame]][source]

获取债券的 K 线数据

Parameters
  • bond_codes (Union[str,List[str]]) – 债券代码、名称 或者 代码、名称构成的列表

  • beg (str, optional) – 开始日期,默认为 '19000101' ,表示 1900年1月1日

  • end (str, optional) – 结束日期,默认为 '20500101' ,表示 2050年1月1日

  • klt (int, optional) –

    行情之间的时间间隔,默认为 101 ,可选示例如下

    • 1 : 分钟

    • 5 : 5 分钟

    • 15 : 15 分钟

    • 30 : 30 分钟

    • 60 : 60 分钟

    • 101 : 日

    • 102 : 周

    • 103 : 月

  • fqt (int, optional) –

    复权方式,默认为 1 ,可选示例如下

    • 0 : 不复权

    • 1 : 前复权

    • 2 : 后复权

Returns

债券的 K 线数据

  • DataFrame : 当 codesstr

  • Dict[str, DataFrame] : 当 bond_codesList[str]

Return type

Union[DataFrame, Dict[str, DataFrame]]

Examples

>>> import efinance as ef
>>> # 获取单只债券日 K 行情
>>> ef.bond.get_quote_history('123111')
    债券名称    债券代码          日期       开盘       收盘       最高       最低      成交量           成交额    振幅    涨跌幅     涨跌额    换手率
0   东财转3  123111  2021-04-23  130.000  130.000  130.000  130.000  1836427  2.387355e+09  0.00  30.00  30.000  11.62
1   东财转3  123111  2021-04-26  130.353  130.010  133.880  125.110  8610944  1.126033e+10  6.75   0.01   0.010  54.50
2   东财转3  123111  2021-04-27  129.000  129.600  130.846  128.400  1820766  2.357472e+09  1.88  -0.32  -0.410  11.52
3   东财转3  123111  2021-04-28  129.100  130.770  131.663  128.903  1467727  1.921641e+09  2.13   0.90   1.170   9.29
4   东财转3  123111  2021-04-29  130.690  131.208  133.150  130.560  1156934  1.525974e+09  1.98   0.33   0.438   7.32
..   ...     ...         ...      ...      ...      ...      ...      ...           ...   ...    ...     ...    ...
72  东财转3  123111  2021-08-09  159.600  159.300  162.990  158.690   596124  9.585751e+08  2.69  -0.34  -0.550   3.77
73  东财转3  123111  2021-08-10  159.190  160.950  161.450  157.000   517237  8.234596e+08  2.79   1.04   1.650   3.27
74  东财转3  123111  2021-08-11  161.110  159.850  162.300  159.400   298906  4.800711e+08  1.80  -0.68  -1.100   1.89
75  东财转3  123111  2021-08-12  159.110  158.290  160.368  158.010   270641  4.298100e+08  1.48  -0.98  -1.560   1.71
76  东财转3  123111  2021-08-13  158.000  158.358  160.290  157.850   250059  3.975513e+08  1.54   0.04   0.068   1.58
efinance.bond.get_realtime_quotes() pandas.core.frame.DataFrame[source]

获取沪深市场全部可转债实时行情信息

Returns

沪深市场全部可转债实时行情信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.bond.get_realtime_quotes()
    债券代码  债券名称    涨跌幅      最新价       最高       最低      今开     涨跌额      换手率     量比 动态市盈率      成交量           成交额    昨日收盘         总市值        流通市值      行情ID 市场类型
0    123051  今天转债  24.03   158.66    165.0    134.0   134.0   30.74   496.74  67.16     -  1388341  2185911136.0  127.92   443443594   443443594  0.123051   深A
1    123042  银河转债  16.04  219.309    224.0   193.11   194.5  30.309  1833.99   1.34     -  3042265  6402014720.0   189.0   363794813   363794813  0.123042   深A
2    113034  滨化转债  13.49   247.71   255.62    214.5   214.5   29.45   334.56   2.96     -  1585993  3798255024.0  218.26  1174284861  1174284861  1.113034   沪A
3    128064  司尔转债  11.29   148.01   150.34  133.007  133.73   15.01   277.06   7.04     -   887301  1305800336.0   133.0   474009426   474009426  0.128064   深A
4    113027  华钰转债   8.38   129.86    130.2    122.3   123.0   10.04    83.84   4.15     -   272641   346817120.0  119.82   422273164   422273164  1.113027   沪A
..      ...   ...    ...      ...      ...      ...     ...     ...      ...    ...   ...      ...           ...     ...         ...         ...       ...  ...
390  113621  彤程转债  -4.45   188.57   198.22    188.0  196.01   -8.79    29.91   0.47     -   168709   326018848.0  197.36  1063693010  1063693010  1.113621   沪A
391  128017  金禾转债  -4.86  182.676  204.989   182.61  195.16  -9.324    35.58    2.0     -   196375   375750768.0   192.0  1008366222  1008366222  0.128017   深A
392  113548  石英转债  -5.16   250.22   267.57   246.56   262.3  -13.61   143.32   0.72     -   175893   452796304.0  263.83   307086749   307086749  1.113548   沪A
393  128093  百川转债  -5.71  429.042   449.97  426.078   443.1 -25.958   426.86   0.36     -   693261  3032643232.0   455.0   696810974   696810974  0.128093   深A
394  123066  赛意转债   -6.0   193.08  203.999   193.08   203.0  -12.32   323.13   0.22     -   133317   261546032.0   205.4    79660753    79660753  0.123066   深A
efinance.bond.get_today_bill(bond_code: str) pandas.core.frame.DataFrame[source]

获取单只债券最新交易日的日内分钟级单子流入流出数据

Parameters

bond_code (str) – 债券代码

Returns

单只债券最新交易日的日内分钟级单子流入流出数据

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.bond.get_today_bill('123111')
    债券名称    债券代码                时间      主力净流入     小单净流入      中单净流入       大单净流入     超大单净流入
0    东财转3  123111  2021-08-13 09:31  -278046.0  319657.0   -41611.0   -278046.0        0.0
1    东财转3  123111  2021-08-13 09:32  -988506.0  571643.0   416863.0   -988506.0        0.0
2    东财转3  123111  2021-08-13 09:33  -990089.0  501980.0   488109.0   -990089.0        0.0
3    东财转3  123111  2021-08-13 09:34 -1718728.0    9051.0  1709678.0  -1718728.0        0.0
4    东财转3  123111  2021-08-13 09:35 -1653717.0 -133654.0  1787373.0  -1653717.0        0.0
..    ...     ...               ...        ...       ...        ...         ...        ...
235  东财转3  123111  2021-08-13 14:56  5942063.0 -747717.0 -5194332.0  11700567.0 -5758504.0
236  东财转3  123111  2021-08-13 14:57  5916755.0 -483170.0 -5433570.0  11963346.0 -6046591.0
237  东财转3  123111  2021-08-13 14:58  5503692.0 -187241.0 -5316435.0  11757642.0 -6253950.0
238  东财转3  123111  2021-08-13 14:59  5503692.0 -187241.0 -5316435.0  11757642.0 -6253950.0
239  东财转3  123111  2021-08-13 15:00  5503692.0 -187241.0 -5316435.0  11757642.0 -6253950.0

Futures

efinance.futures.get_futures_base_info() pandas.core.frame.DataFrame[source]

获取四个交易所全部期货基本信息

Returns

四个交易所全部期货一些基本信息

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.futures.get_futures_base_info()
    期货代码      期货名称        行情ID       市场类型
0       ZCM     动力煤主力     115.ZCM        郑商所
1     ZC201    动力煤201   115.ZC201        郑商所
2        jm      焦炭主力      114.jm        大商所
3     j2201    焦炭2201   114.j2201        大商所
4       jmm      焦煤主力     114.jmm        大商所
..      ...       ...         ...        ...
846  jm2109    焦煤2109  114.jm2109        大商所
847  071108    IH2108    8.071108        中金所
848  070131   IH次主力合约    8.070131        中金所
849  070120    IH当月连续     8.07012        中金所
850  lu2109  低硫燃油2109  142.lu2109  上海能源期货交易所

Notes

这里的 行情ID 主要作用是为使用函数 efinance.futures.get_quote_history 获取期货行情信息提供参数

efinance.futures.get_quote_history(quote_ids: Union[str, List[str]], beg: str = '19000101', end: str = '20500101', klt: int = 101, fqt: int = 1) pandas.core.frame.DataFrame[source]

获取期货历史行情信息

Parameters
  • quote_ids (Union[str, List[str]]) – 一个期货 行情ID,或者多个期货 行情ID 构成的列表

  • beg (str, optional) – 开始日期,默认为 '19000101' ,表示 1900年1月1日

  • end (str, optional) – 结束日期,默认为 '20500101' ,表示 2050年1月1日

  • klt (int, optional) –

    行情之间的时间间隔,默认为 101 ,可选示例如下

    • 1 : 分钟

    • 5 : 5 分钟

    • 15 : 15 分钟

    • 30 : 30 分钟

    • 60 : 60 分钟

    • 101 : 日

    • 102 : 周

    • 103 : 月

  • fqt (int, optional) –

    复权方式,默认为 1 ,可选示例如下

    • 0 : 不复权

    • 1 : 前复权

    • 2 : 后复权

Returns

期货的 K 线数据

  • DataFrame : 当 secidsstr

  • Dict[str, DataFrame] : 当 quote_idsList[str]

Return type

Union[DataFrame, Dict[str, DataFrame]]

Examples

>>> import efinance as ef
>>> # 获取全部期货行情ID列表
>>> quote_ids = ef.futures.get_realtime_quotes()['行情ID']
>>> # 指定单个期货的行情ID(以上面获得到的行情ID列表为例)
>>> quote_id = quote_ids[0]
>>> # 查看第一个行情ID
>>> quote_ids[0]
'115.ZCM'
>>> # 获取第行情ID为第一个的期货日 K 线数据
>>> ef.futures.get_quote_history(quote_id)
    期货代码   期货名称          日期     开盘     收盘     最高     最低    成交量           成交额    振幅   涨跌幅   涨跌额  换手率
0     ZCM  动力煤主力  2015-05-18  440.0  437.6  440.2  437.6     64  2.806300e+06  0.00  0.00   0.0  0.0
1     ZCM  动力煤主力  2015-05-19  436.0  437.0  437.6  436.0      6  2.621000e+05  0.36 -0.32  -1.4  0.0
2     ZCM  动力煤主力  2015-05-20  436.8  435.8  437.0  434.8      8  3.487500e+05  0.50 -0.23  -1.0  0.0
3     ZCM  动力煤主力  2015-05-21  438.0  443.2  446.8  437.8     37  1.631850e+06  2.06  1.65   7.2  0.0
4     ZCM  动力煤主力  2015-05-22  439.2  441.4  443.8  439.2     34  1.502500e+06  1.04  0.09   0.4  0.0
...   ...    ...         ...    ...    ...    ...    ...    ...           ...   ...   ...   ...  ...
1524  ZCM  动力煤主力  2021-08-17  755.0  770.8  776.0  750.6  82373  6.288355e+09  3.25 -1.26  -9.8  0.0
1525  ZCM  动力煤主力  2021-08-18  770.8  776.8  785.8  766.0  77392  6.016454e+09  2.59  1.76  13.4  0.0
1526  ZCM  动力煤主力  2021-08-19  776.8  777.6  798.0  764.6  97229  7.597474e+09  4.30  0.03   0.2  0.0
1527  ZCM  动力煤主力  2021-08-20  778.0  793.0  795.0  775.2  70549  5.553617e+09  2.53  1.48  11.6  0.0
1528  ZCM  动力煤主力  2021-08-23  796.8  836.6  843.8  796.8  82954  6.850341e+09  5.97  6.28  49.4  0.0
>>> # 指定多个期货的 行情ID
>>> quote_ids = ['115.ZCM','115.ZC109']
>>> futures_df = ef.futures.get_quote_history(quote_ids)
>>> type(futures_df)
<class 'dict'>
>>> futures_df.keys()
dict_keys(['115.ZC109', '115.ZCM'])
>>> futures_df['115.ZCM']
    期货名称 期货代码          日期     开盘     收盘     最高     最低    成交量           成交额    振幅   涨跌幅   涨跌额  换手率
0     动力煤主力  ZCM  2015-05-18  440.0  437.6  440.2  437.6     64  2.806300e+06  0.00  0.00   0.0  0.0
1     动力煤主力  ZCM  2015-05-19  436.0  437.0  437.6  436.0      6  2.621000e+05  0.36 -0.32  -1.4  0.0
2     动力煤主力  ZCM  2015-05-20  436.8  435.8  437.0  434.8      8  3.487500e+05  0.50 -0.23  -1.0  0.0
3     动力煤主力  ZCM  2015-05-21  438.0  443.2  446.8  437.8     37  1.631850e+06  2.06  1.65   7.2  0.0
4     动力煤主力  ZCM  2015-05-22  439.2  441.4  443.8  439.2     34  1.502500e+06  1.04  0.09   0.4  0.0
...     ...  ...         ...    ...    ...    ...    ...    ...           ...   ...   ...   ...  ...
1524  动力煤主力  ZCM  2021-08-17  755.0  770.8  776.0  750.6  82373  6.288355e+09  3.25 -1.26  -9.8  0.0
1525  动力煤主力  ZCM  2021-08-18  770.8  776.8  785.8  766.0  77392  6.016454e+09  2.59  1.76  13.4  0.0
1526  动力煤主力  ZCM  2021-08-19  776.8  777.6  798.0  764.6  97229  7.597474e+09  4.30  0.03   0.2  0.0
1527  动力煤主力  ZCM  2021-08-20  778.0  793.0  795.0  775.2  70549  5.553617e+09  2.53  1.48  11.6  0.0
1528  动力煤主力  ZCM  2021-08-23  796.8  836.6  843.8  796.8  82954  6.850341e+09  5.97  6.28  49.4  0.0
efinance.futures.get_realtime_quotes() pandas.core.frame.DataFrame[source]

获取期货最新行情总体情况

Returns

期货市场的最新行情信息(涨跌幅、换手率等信息)

Return type

DataFrame

Examples

>>> import efinance as ef
>>> ef.futures.get_realtime_quotes()
    期货代码      期货名称   涨跌幅     最新价      最高      最低      今开    涨跌额 换手率    量比 动态市盈率     成交量            成交额    昨日收盘     总市值 流通市值        行情ID       市场类型
0       ZCM     动力煤主力  6.28   836.6   843.8   796.8   796.8   49.4   -  2.82     -   82954   6850341376.0   793.0       -    -     115.ZCM        郑商所
1     ZC201    动力煤201  6.28   836.6   843.8   796.8   796.8   49.4   -  2.82     -   82954   6850341376.0   793.0       -    -   115.ZC201        郑商所
2        jm      焦炭主力  5.39  2980.0  2982.0  2833.0  2834.0  152.5   -   1.4     -  166433  48567923456.0  2830.5       -    -      114.jm        大商所
3     j2201    焦炭2201  5.39  2980.0  2982.0  2833.0  2834.0  152.5   -   1.4     -  166433  48567923456.0  2830.5       -    -   114.j2201        大商所
4       jmm      焦煤主力   5.0  2354.0  2360.0  2221.0  2221.0  112.0   -  1.42     -  238671  32924591872.0  2238.0       -    -     114.jmm        大商所
..      ...       ...   ...     ...     ...     ...     ...    ...  ..   ...   ...     ...            ...     ...     ...  ...         ...        ...
846  jm2109    焦煤2109 -2.28  2748.0  2882.5  2688.0  2845.0  -64.0   -  1.85     -   34029   5656982528.0  2866.0       -    -  114.jm2109        大商所
847  071108    IH2108 -2.52  3060.0  3130.0  3043.0  3111.2  -79.0   -  0.39     -   14384  13315567616.0  3139.2  918000    -    8.071108        中金所
848  070131   IH次主力合约 -2.52  3060.0  3130.0  3043.0  3111.2  -79.0   -  0.57     -   14384  13315567616.0  3139.2  918000    -    8.070131        中金所
849  070120    IH当月连续 -2.52  3060.0  3130.0  3043.0  3111.2  -79.0   -  0.39     -   14384  13315567616.0  3139.2  918000    -    8.070120        中金所
850  lu2109  低硫燃油2109 -3.79  3123.0  3127.0  3121.0  3121.0 -123.0   -     -     -      22       687420.0  3143.0       -    -  142.lu2109  上海能源期货交易所

Notes

如果不记得行情ID,则可以调用函数 efinance.futures.get_realtime_quotes 获取 接着便可以使用函数 efinance.futures.get_quote_history 来获取期货 K 线数据