akshare 1.17.38__tar.gz → 1.17.39__tar.gz

{akshare-1.17.38 → akshare-1.17.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare
-Version: 1.17.38
+Version: 1.17.39
 Summary: AKShare is an elegant and simple financial data interface library for Python, built for human beings!
 Home-page: https://github.com/akfamily/akshare
 Author: AKFamily
@@ -53,6 +53,13 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
+**资源分享**：对于想了解更多财经数据与量化投研的小伙伴，推荐一个专注于财经数据和量化研究的知识社区。
+该社区提供相关文档和视频学习资源，汇集了各类财经数据源和量化投研工具的使用经验。
+有兴趣深入学习的朋友可点此[了解更多](https://t.zsxq.com/ZCxUG)，也推荐大家关注微信公众号【数据科学实战】。
+
+**工具推荐**：期魔方是一款本地化期货量化分析工具，适合数据分析爱好者使用。无需复杂部署，支持数据分析和机器学习功能，研究功能免费开放。
+如需了解更多信息可访问[期魔方](https://qmfquant.com/)。
+
 ![AKShare Logo](https://github.com/akfamily/akshare/blob/main/assets/images/akshare_logo.jpg)
 
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/akshare.svg)](https://pypi.org/project/akshare/)

{akshare-1.17.38 → akshare-1.17.39}/README.md

@@ -1,3 +1,10 @@
+**资源分享**：对于想了解更多财经数据与量化投研的小伙伴，推荐一个专注于财经数据和量化研究的知识社区。
+该社区提供相关文档和视频学习资源，汇集了各类财经数据源和量化投研工具的使用经验。
+有兴趣深入学习的朋友可点此[了解更多](https://t.zsxq.com/ZCxUG)，也推荐大家关注微信公众号【数据科学实战】。
+
+**工具推荐**：期魔方是一款本地化期货量化分析工具，适合数据分析爱好者使用。无需复杂部署，支持数据分析和机器学习功能，研究功能免费开放。
+如需了解更多信息可访问[期魔方](https://qmfquant.com/)。
+
 ![AKShare Logo](https://github.com/akfamily/akshare/blob/main/assets/images/akshare_logo.jpg)
 
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/akshare.svg)](https://pypi.org/project/akshare/)

{akshare-1.17.38 → akshare-1.17.39}/akshare/__init__.py

@@ -3145,9 +3145,10 @@ amac_manager_cancelled_info # 中国证券投资基金业协会-信息公示-诚
 1.17.36 fix: fix futures_hist_em interface
 1.17.37 fix: fix stock_zh_index_daily_em interface
 1.17.38 fix: fix futures_inventory_99 interface
+1.17.39 fix: fix bond_zh_cov_value_analysis interface
 """
 
-__version__ = "1.17.38"
+__version__ = "1.17.39"
 __author__ = "AKFamily"
 
 import sys

{akshare-1.17.38 → akshare-1.17.39}/akshare/bond/bond_zh_cov.py

@@ -628,6 +628,8 @@ def bond_zh_cov_value_analysis(symbol: str = "113527") -> pd.DataFrame:
     """
     https://data.eastmoney.com/kzz/detail/113527.html
     东方财富网-数据中心-新股数据-可转债数据-价值分析-溢价率分析
+    :param symbol: 可转债代码
+    :type symbol: str
     :return: 可转债价值分析
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/bond/bond_zh_sina.py

@@ -46,6 +46,10 @@ def bond_zh_hs_spot(start_page: str = "1", end_page: str = "10") -> pd.DataFrame
     """
     新浪财经-债券-沪深债券-实时行情数据, 大量抓取容易封IP
     https://vip.stock.finance.sina.com.cn/mkt/#hs_z
+    :param start_page: 分页起始页
+    :type start_page: str
+    :param end_page: 分页结束页
+    :type end_page: str
     :return: 所有沪深债券在当前时刻的实时行情数据
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/crypto/crypto_bitcoin_cme.py

@@ -14,6 +14,8 @@ def crypto_bitcoin_cme(date: str = "20230830") -> pd.DataFrame:
     """
     芝加哥商业交易所-比特币成交量报告
     https://datacenter.jin10.com/reportType/dc_cme_btc_report
+    :param date: Specific date, e.g., "20230830"
+    :type date: str
     :return: 比特币成交量报告
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/economic/macro_usa.py

@@ -925,7 +925,7 @@ def macro_usa_eia_crude_rate() -> pd.DataFrame:
     美国 EIA 原油库存报告, 数据区间从 19950801-至今
     https://datacenter.jin10.com/reportType/dc_eia_crude_oil
     :return: 美国 EIA 原油库存报告
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {
@@ -944,7 +944,7 @@ def macro_usa_initial_jobless() -> pd.DataFrame:
     美国初请失业金人数报告, 数据区间从 19700101-至今
     https://datacenter.jin10.com/reportType/dc_initial_jobless
     :return: 美国 EIA 原油库存报告
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {
@@ -963,7 +963,7 @@ def macro_usa_crude_inner() -> pd.DataFrame:
     美国原油产量报告, 数据区间从 19830107-至今
     https://datacenter.jin10.com/reportType/dc_eia_crude_oil_produce
     :return: 美国原油产量报告
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {"_": t}
@@ -999,7 +999,7 @@ def macro_usa_cftc_nc_holding() -> pd.DataFrame:
     美国商品期货交易委员会CFTC外汇类非商业持仓报告, 数据区间从 19830107-至今
     https://datacenter.jin10.com/reportType/dc_cftc_nc_report
     :return: 美国商品期货交易委员会CFTC外汇类非商业持仓报告
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {"_": str(int(round(t * 1000)))}
@@ -1028,7 +1028,7 @@ def macro_usa_cftc_c_holding() -> pd.DataFrame:
     美国商品期货交易委员会CFTC商品类非商业持仓报告, 数据区间从 19830107-至今
     https://datacenter.jin10.com/reportType/dc_cftc_c_report
     :return: 美国商品期货交易委员会CFTC外汇类非商业持仓报告
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {"_": str(int(round(t * 1000)))}
@@ -1057,7 +1057,7 @@ def macro_usa_cftc_merchant_currency_holding() -> pd.DataFrame:
     美国商品期货交易委员会CFTC外汇类商业持仓报告, 数据区间从 19860115-至今
     https://datacenter.jin10.com/reportType/dc_cftc_merchant_currency
     :return: 美国商品期货交易委员会CFTC外汇类商业持仓报告
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {"_": str(int(round(t * 1000)))}
@@ -1115,7 +1115,7 @@ def macro_usa_cme_merchant_goods_holding():
     CME-贵金属, 数据区间从 20180405-至今
     https://datacenter.jin10.com/org
     :return: CME-贵金属
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     t = time.time()
     params = {"_": str(int(round(t * 1000)))}

{akshare-1.17.38 → akshare-1.17.39}/akshare/fund/fund_aum_em.py

@@ -65,6 +65,8 @@ def fund_aum_hist_em(year: str = "2023") -> pd.DataFrame:
     """
     东方财富-基金-基金公司历年管理规模排行列表
     https://fund.eastmoney.com/Company/lsgm.html
+    :param year: query year
+    :type year: str
     :return: 基金公司历年管理规模排行列表
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/fund/fund_em.py

@@ -122,8 +122,8 @@ def fund_info_index_em(
     :type symbol: str
     :param indicator: choice of {"全部", "被动指数型", "增强指数型"}
     :type indicator: str
-    :return: pandas.DataFrame
-    :rtype: 基金信息-指数型
+    :return: 基金信息-指数型
+    :rtype: pandas.DataFrame
     """
     symbol_map = {
         "全部": "",

{akshare-1.17.38 → akshare-1.17.39}/akshare/fund/fund_etf_ths.py

@@ -16,6 +16,8 @@ def fund_etf_spot_ths(date: str = "") -> pd.DataFrame:
     """
     同花顺理财-基金数据-每日净值-ETF-实时行情
     https://fund.10jqka.com.cn/datacenter/jz/kfs/etf/
+    :param date: 查询日期
+    :type date: str
     :return: ETF 实时行情
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/futures/cot.py

@@ -69,7 +69,8 @@ def get_rank_sum_daily(
     :type end_day: str
     :param vars_list: 合约品种如 ['RB'、'AL'] 等列表为空时为所有商品
     :type vars_list: list
-    :return: pd.DataFrame
+    :return:  会员持仓排名数据
+    :rtype: pandas.DataFrame
     symbol                           标的合约                     string
     var                              商品品种                     string
     vol_top5                         成交量前5会员成交量总和         int
@@ -116,7 +117,8 @@ def get_rank_sum(date: str = "20210525", vars_list: list = cons.contract_symbols
     :type date: date
     :param vars_list: 合约品种如 ['RB', 'AL'] 等列表为空时为所有商品
     :type vars_list: list
-    :return: pd.DataFrame
+    :return: 持仓排名数据
+    :rtype: pandas.DataFrame
     symbol                           标的合约                     string
     var                              商品品种                     string
     vol_top5                         成交量前5会员成交量总和         int
@@ -408,7 +410,9 @@ def get_czce_rank_table(date: str = "20210428") -> dict:
     郑州商品交易所前 20 会员持仓排名数据明细
     注：该交易所既公布了品种排名, 也公布了标的排名
     :param date: 日期 format：YYYY-MM-DD 或 YYYYMMDD 或 datetime.date对象 为空时为当天
-    :return: pd.DataFrame
+    :return: 持仓排名数据明细
+    :rtype: pandas.DataFrame
+    返回值格式
     rank                        排名                        int
     vol_party_name              成交量排序的当前名次会员        string(中文)
     vol                         该会员成交量                  int
@@ -559,7 +563,10 @@ def get_dce_rank_table(date: str = "20230706", vars_list=cons.contract_symbols)
     注: 该交易所只公布标的合约排名
     :param date: 日期 format：YYYY-MM-DD 或 YYYYMMDD 或 datetime.date 对象, 为空时为当天
     :param vars_list: 合约品种如 RB、AL 等列表为空时为所有商品, 数据从 20060104 开始，每交易日 16:30 左右更新数据
-    :return: pandas.DataFrame
+    :return: 持仓排名
+    :rtype: pandas.DataFrame
+
+    返回值格式
     rank                        排名                        int
     vol_party_name              成交量排序的当前名次会员      string(中文)
     vol                         该会员成交量                 int
@@ -707,7 +714,9 @@ def get_cffex_rank_table(date: str = "20190805", vars_list=cons.contract_symbols
     注：该交易所既公布品种排名，也公布标的排名
     :param date: 日期 format：YYYY-MM-DD 或 YYYYMMDD 或 datetime.date对象 为空时为当天
     :param vars_list: 合约品种如RB、AL等列表 为空时为所有商品, 数据从20100416开始，每交易日16:30左右更新数据
-    :return: pd.DataFrame
+    :return: 持仓排名
+    :rtype: pandas.DataFrame
+    :rfield:
     rank                        排名                        int
     vol_party_name              成交量排序的当前名次会员        string(中文)
     vol                         该会员成交量                  int
@@ -721,6 +730,7 @@ def get_cffex_rank_table(date: str = "20190805", vars_list=cons.contract_symbols
     symbol                      标的合约                     string
     var                         品种                        string
     date                        日期                        string YYYYMMDD
+
     """
     vars_list = [i for i in vars_list if i in cons.market_exchange_symbols["cffex"]]
     date = cons.convert_date(date) if date is not None else datetime.date.today()

{akshare-1.17.38 → akshare-1.17.39}/akshare/futures/futures_basis.py

@@ -39,7 +39,8 @@ def futures_spot_price_daily(
     :param start_day: str 开始日期 format：YYYY-MM-DD 或 YYYYMMDD 或 datetime.date对象; 默认为当天
     :param end_day: str 结束数据 format：YYYY-MM-DD 或 YYYYMMDD 或 datetime.date对象; 默认为当天
     :param vars_list: list 合约品种如 [RB, AL]; 默认参数为所有商品
-    :return: pandas.DataFrame
+    :return: 基差
+    :rtype: pandas.DataFrame
     展期收益率数据:
     var               商品品种                      string
     sp                现货价格                      float

{akshare-1.17.38 → akshare-1.17.39}/akshare/futures_derivative/futures_contract_info_cffex.py

@@ -16,6 +16,8 @@ def futures_contract_info_cffex(date: str = "20240228") -> pd.DataFrame:
     """
     中国金融期货交易所-数据-交易参数
     http://www.gfex.com.cn/gfex/hyxx/ywcs.shtml
+    :param date: 查询日期
+    :type date: str
     :return: 交易参数汇总查询
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/futures_derivative/futures_contract_info_czce.py

@@ -16,6 +16,8 @@ def futures_contract_info_czce(date: str = "20240228") -> pd.DataFrame:
     """
     郑州商品交易所-交易数据-参考数据
     http://www.czce.com.cn/cn/jysj/cksj/H770322index_1.htm
+    :param date: 查询日期
+    :type date: str
     :return: 交易参数汇总查询
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/fx/fx_quote.py

@@ -50,7 +50,7 @@ def fx_swap_quote() -> pd.DataFrame:
     中国外汇交易中心暨全国银行间同业拆借中心-市场数据-市场行情-债券市场行情-人民币外汇远掉报价
     https://www.chinamoney.com.cn/chinese/index.html
     :return: 人民币外汇远掉报价
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     payload = {"t": str(int(round(time.time() * 1000)))}
     res = requests.post(FX_SWAP_URL, data=payload, headers=SHORT_HEADERS)
@@ -83,7 +83,7 @@ def fx_pair_quote() -> pd.DataFrame:
     中国外汇交易中心暨全国银行间同业拆借中心-市场数据-市场行情-债券市场行情-外币对即期报价
     http://www.chinamoney.com.cn/chinese/mkdatapfx/
     :return: 外币对即期报价
-    :return: pandas.DataFrame
+    :rtype: pandas.DataFrame
     """
     payload = {"t": str(int(round(time.time() * 1000)))}
     res = requests.post(FX_PAIR_URL, data=payload, headers=SHORT_HEADERS)

{akshare-1.17.38 → akshare-1.17.39}/akshare/option/option_finance_sina.py

@@ -81,7 +81,7 @@ def option_cffex_sz50_spot_sina(symbol: str = "ho2303") -> pd.DataFrame:
     :param symbol: 合约代码; 用 ak.option_cffex_sz300_list_sina() 函数查看
     :type symbol: str
     :return: 中金所-上证 50 指数-指定合约-看涨看跌实时行情
-    :rtype: pd.DataFrame
+    :rtype: pandas.DataFrame
     """
     url = "https://stock.finance.sina.com.cn/futures/api/openapi.php/OptionService.getOptionData"
     params = {
@@ -154,7 +154,7 @@ def option_cffex_hs300_spot_sina(symbol: str = "io2204") -> pd.DataFrame:
     :param symbol: 合约代码; 用 option_cffex_hs300_list_sina 函数查看
     :type symbol: str
     :return: 中金所-沪深300指数-指定合约-看涨看跌实时行情
-    :rtype: pd.DataFrame
+    :rtype: pandas.DataFrame
     """
     url = "https://stock.finance.sina.com.cn/futures/api/openapi.php/OptionService.getOptionData"
     params = {
@@ -227,7 +227,7 @@ def option_cffex_zz1000_spot_sina(symbol: str = "mo2208") -> pd.DataFrame:
     :param symbol: 合约代码; 用 option_cffex_zz1000_list_sina 函数查看
     :type symbol: str
     :return: 中金所-中证 1000 指数-指定合约-看涨看跌实时行情
-    :rtype: pd.DataFrame
+    :rtype: pandas.DataFrame
     """
     url = "https://stock.finance.sina.com.cn/futures/api/openapi.php/OptionService.getOptionData"
     params = {
@@ -299,7 +299,7 @@ def option_cffex_sz50_daily_sina(symbol: str = "ho2303P2350") -> pd.DataFrame:
     :param symbol: 具体合约代码(包括看涨和看跌标识), 可以通过 ak.option_cffex_sz50_spot_sina 中的 call-标识 获取
     :type symbol: str
     :return: 日频率数据
-    :rtype: pd.DataFrame
+    :rtype: pandas.DataFrame
     """
     year = datetime.datetime.now().year
     month = datetime.datetime.now().month
@@ -340,7 +340,7 @@ def option_cffex_hs300_daily_sina(symbol: str = "io2202P4350") -> pd.DataFrame:
     :param symbol: 具体合约代码(包括看涨和看跌标识), 可以通过 ak.option_cffex_hs300_spot_sina 中的 call-标识 获取
     :type symbol: str
     :return: 日频率数据
-    :rtype: pd.DataFrame
+    :rtype: pandas.DataFrame
     """
     year = datetime.datetime.now().year
     month = datetime.datetime.now().month
@@ -383,7 +383,7 @@ def option_cffex_zz1000_daily_sina(
     :param symbol: 具体合约代码(包括看涨和看跌标识), 可以通过 ak.option_cffex_zz1000_spot_sina 中的 call-标识 获取
     :type symbol: str
     :return: 日频率数据
-    :rtype: pd.DataFrame
+    :rtype: pandas.DataFrame
     """
     year = datetime.datetime.now().year
     month = datetime.datetime.now().month

{akshare-1.17.38 → akshare-1.17.39}/akshare/qhkc_web/qhkc_fund.py

@@ -28,7 +28,8 @@ def get_qhkc_fund_bs(
     可获取数据的时间段为:"2016-10-10:2019-09-30"
     :param url: 网址
     :param date: 中文名称
-    :return: pd.DataFrame
+    :return: 净持仓分布
+    :rtype: pandas.DataFrame
     symbol_df
        name       value        ratio      date
        IC  1552535406     0.195622  20190924
@@ -125,7 +126,8 @@ def get_qhkc_fund_position(
     可获取数据的时间段为:"2016-10-10:2019-09-30"
     :param url: 网址
     :param date: 中文名称
-    :return: pd.DataFrame
+    :return: 总持仓分布
+    :rtype: pandas.DataFrame
     symbol_df
        name       value        ratio      date
        IC  1552535406     0.195622  20190924
@@ -322,7 +324,8 @@ def get_qhkc_fund_money_change(
     可获取数据的时间段为:"2016-10-10:2019-09-30"
     :param url: 网址
     :param date: 中文名称
-    :return: pd.DataFrame
+    :return: 成交额分布
+    :rtype: pandas.DataFrame
         name        value        ratio        date
        沪镍    2.292e+10     0.145963  2019-09-25
        沪银  1.22788e+10    0.0781956  2019-09-25

{akshare-1.17.38 → akshare-1.17.39}/akshare/qhkc_web/qhkc_index.py

@@ -23,8 +23,11 @@ def get_qhkc_index(name: AnyStr = "奇货商品", url: AnyStr = QHKC_INDEX_URL):
     奇货可查-指数-指数详情
     获得奇货可查的指数数据: '奇货黑链', '奇货商品', '奇货谷物', '奇货贵金属', '奇货饲料', '奇货软商品', '奇货化工', '奇货有色', '奇货股指', '奇货铁合金', '奇货油脂'
     :param url: 网址
-    :param name 中文名称
-    :return: pd.DataFrame
+    :type url: str
+    :param name: 中文名称
+    :type name: str
+    :return: 指数详情
+    :rtype: pandas.DataFrame
         date    price   volume  ...      margin     profit long_short_ratio
         2013-01-04     1000   260820  ...  1130485758    1816940            52.78
         2013-01-07  998.244   245112  ...  1132228518    2514410            52.15
@@ -75,9 +78,12 @@ def get_qhkc_index_trend(name: AnyStr = "奇货商品", url: AnyStr = QHKC_INDEX
     """
     奇货可查-指数-大资金动向
     获得奇货可查的指数数据: '奇货黑链', '奇货商品', '奇货谷物', '奇货贵金属', '奇货饲料', '奇货软商品', '奇货化工', '奇货有色', '奇货股指', '奇货铁合金', '奇货油脂'
+    :param name: None
+    :type name: str
     :param url: 网址
-    :param name None
-    :return: pd.DataFrame
+    :type url: str
+    :return: 大资金动向
+    :rtype: pandas.DataFrame
         broker    grade    money     open_order     variety
         中金期货     B -3.68209e+07  3.68209e+07      沪金
         浙商期货     D    -25845534     25845534      沪银
@@ -150,10 +156,15 @@ def get_qhkc_index_profit_loss(
     奇货可查-指数-盈亏详情
     获得奇货可查的指数数据: '奇货黑链', '奇货商品', '奇货谷物', '奇货贵金属', '奇货饲料', '奇货软商品', '奇货化工', '奇货有色', '奇货股指', '奇货铁合金', '奇货油脂'
     :param url: 网址
-    :param name None
+    :type url: str
+    :param name: None
+    :type name: str
     :param start_date: ""
+    :type start_date: str
     :param end_date: "20190716" 指定 end_date 就可以了
-    :return: pd.DataFrame
+    :type end_date: str
+    :return: 盈亏详情
+    :rtype: pandas.DataFrame
         indexes       value  trans_date
         招金期货-沪金  -307489200  2019-09-30
         平安期货-沪银  -195016650  2019-09-30

{akshare-1.17.38 → akshare-1.17.39}/akshare/qhkc_web/qhkc_tool.py

@@ -19,7 +19,8 @@ def qhkc_tool_foreign(url: AnyStr = QHKC_TOOL_FOREIGN_URL):
     奇货可查-工具-外盘比价
     实时更新数据, 暂不能查询历史数据
     :param url: str 网址
-    :return: pd.DataFrame
+    :return: 外盘比价
+    :rtype: pandas.DataFrame
     name    base_time base_price latest_price   rate
      伦敦铜  10/08 01:00       5704       5746.5  0.745
      伦敦锌  10/08 01:00    2291.25      2305.75  0.633

{akshare-1.17.38 → akshare-1.17.39}/akshare/stock/stock_board_concept_em.py

@@ -178,6 +178,8 @@ def stock_board_concept_spot_em(symbol: str = "可燃冰") -> pd.DataFrame:
     """
     东方财富网-行情中心-沪深京板块-概念板块-实时行情
     https://quote.eastmoney.com/bk/90.BK0818.html
+    :param symbol: 概念板块代码
+    :type symbol: str
     :return: 概念板块-实时行情
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/stock/stock_us_famous.py

@@ -14,7 +14,7 @@ def stock_us_famous_spot_em(symbol: str = "科技类") -> pd.DataFrame:
     """
     东方财富网-行情中心-美股市场-知名美股
     https://quote.eastmoney.com/center/gridlist.html#us_wellknown
-    :symbol: choice of {'科技类', '金融类', '医药食品类', '媒体类', '汽车能源类', '制造零售类'}
+    :param symbol: choice of {'科技类', '金融类', '医药食品类', '媒体类', '汽车能源类', '制造零售类'}
     :type: str
     :return: 知名美股实时行情
     :rtype: pandas.DataFrame

{akshare-1.17.38 → akshare-1.17.39}/akshare/stock_feature/stock_research_report_em.py

@@ -17,6 +17,8 @@ def stock_research_report_em(symbol: str = "000001") -> pd.DataFrame:
     """
     东方财富网-数据中心-研究报告-个股研报
     https://data.eastmoney.com/report/stock.jshtml
+    :param symbol: 个股代码
+    :type symbol: str
     :return: 个股研报
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare/stock_feature/stock_zdhtmx_em.py

@@ -17,6 +17,10 @@ def stock_zdhtmx_em(
     """
     东方财富网-数据中心-重大合同-重大合同明细
     https://data.eastmoney.com/zdht/mx.html
+    :param start_date: 开始日期, eg 20200819
+    :type start_date: str
+    :param end_date: 结束日期, eg 20230819
+    :type end_date: str
     :return: 股东大会
     :rtype: pandas.DataFrame
     """

{akshare-1.17.38 → akshare-1.17.39}/akshare.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare
-Version: 1.17.38
+Version: 1.17.39
 Summary: AKShare is an elegant and simple financial data interface library for Python, built for human beings!
 Home-page: https://github.com/akfamily/akshare
 Author: AKFamily
@@ -53,6 +53,13 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
+**资源分享**：对于想了解更多财经数据与量化投研的小伙伴，推荐一个专注于财经数据和量化研究的知识社区。
+该社区提供相关文档和视频学习资源，汇集了各类财经数据源和量化投研工具的使用经验。
+有兴趣深入学习的朋友可点此[了解更多](https://t.zsxq.com/ZCxUG)，也推荐大家关注微信公众号【数据科学实战】。
+
+**工具推荐**：期魔方是一款本地化期货量化分析工具，适合数据分析爱好者使用。无需复杂部署，支持数据分析和机器学习功能，研究功能免费开放。
+如需了解更多信息可访问[期魔方](https://qmfquant.com/)。
+
 ![AKShare Logo](https://github.com/akfamily/akshare/blob/main/assets/images/akshare_logo.jpg)
 
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/akshare.svg)](https://pypi.org/project/akshare/)